tectra — Angular UI component library

Open-source Angular UI kit for consoles and admin apps.
Design tokens, themes, 80+ components, charts, editors and ready page blocks — built on signals, rendered on the server.

npm version npm downloads CI Unit test coverage MIT license Angular 22
OpenSSF Best Practices OpenSSF Baseline OpenSSF Scorecard

Documentation  ·  Getting started  ·  Theming  ·  Roadmap  ·  Contributing

--- ## Why tectra - **Everything in one kit** — 80+ components (forms, data, overlays, navigation, feedback, date and time), 22 page blocks, 23 SVG charts, a rich text editor, a code editor with diff, 334 icons, brand logos and country flags. - **Modern Angular only** — standalone, signal inputs and models, OnPush, zoneless; works with reactive, template-driven and signal forms. - **Server rendering out of the box** — every component prerenders and hydrates without a layout jump. - **Your design, from tokens** — light and dark mode, 3 styles, 17 primary colours and 13 surfaces; change any component with `dt`, add classes with `pt`, or turn styles off with `unstyled`. - **Accessible** — WAI-ARIA patterns, full keyboard support, axe checks of every docs page in light and dark. - **Few dependencies** — charts, QR codes, icons and utilities are written in the kit; only the editors bring an engine core. - **Tree-shakable** — one entry point per component, chart and utility, so an app ships only what it imports. ## Quick start In an Angular CLI app one command does the whole setup: ```bash ng add tectra-ng ``` It installs the kit and its Angular peers, adds `provideTectra` with the style, primary colour and surface you pick and `provideTxIcons(TX_ICONS)` to `app.config.ts`, and the fonts to `index.html`. Pass `--style`, `--primary` and `--surface` to skip the questions; running it again changes nothing. Or set it up by hand: ```bash npm install tectra-ng ``` pnpm lets an app import only the packages its `package.json` lists, so name them all (`ng add` does this with every package manager): ```bash pnpm add tectra-ng @tectra-ng/tokens @tectra-ng/themes @tectra-ng/core @tectra-ng/icons @tectra-ng/brand-icons @tectra-ng/flags @tectra-ng/qr @tectra-ng/ui @tectra-ng/charts @tectra-ng/utils @tectra-ng/blocks ``` Provide a theme in `app.config.ts`: ```ts import { provideTectra } from '@tectra-ng/core/config'; import { TX_ICONS, provideTxIcons } from '@tectra-ng/icons'; import { createTectraPreset } from '@tectra-ng/themes'; export const appConfig: ApplicationConfig = { providers: [provideTectra({ preset: createTectraPreset({ primary: 'blue' }) }), provideTxIcons(TX_ICONS)], }; ``` Import a component where you use it: ```ts import { TxSelect } from '@tectra-ng/ui/select'; @Component({ imports: [TxSelect, ReactiveFormsModule], template: ``, }) export class CityField { readonly cities = ['Kyiv', 'Lviv', 'Odesa', 'Kharkiv']; readonly city = new FormControl(null); } ``` Fonts, dark mode, locales and the theme builder: [tectra-ng.com/getting-started](https://tectra-ng.com/getting-started). Upgrading from 0.2: [UPGRADING.md](UPGRADING.md). Try before installing: the bolt button on every example of [tectra-ng.com](https://tectra-ng.com) opens it in StackBlitz as a live, editable Angular CLI project with the theme you picked on the site. ## Packages `tectra-ng` installs the whole kit at one version (the parts marked “Included”). Each part is also published on its own: | Package | What it is | Included | |---|---|:---:| | [`@tectra-ng/ui`](packages/ui) | components, one entry point each: `@tectra-ng/ui/` | ✓ | | [`@tectra-ng/blocks`](packages/blocks) | ready page blocks: layouts, page header, filters panel, kanban, command palette … | ✓ | | [`@tectra-ng/charts`](packages/charts) | SVG charts without a chart library: line, column, pie, gauge, sankey, gantt, heatmap … with SVG / PNG / CSV export | ✓ | | [`@tectra-ng/utils`](packages/utils) | pipes, directives, validators, filter state, HTTP helpers, polling, clock | ✓ | | [`@tectra-ng/qr`](packages/qr) | QR codes in plain TypeScript, no dependencies, works in any framework and in Node | ✓ | | [`@tectra-ng/core`](packages/core) | behaviour without looks: config, overlay, a11y, forms, i18n, styles, ripple | ✓ | | [`@tectra-ng/themes`](packages/themes) | semantic light / dark tokens, component tokens, presets | ✓ | | [`@tectra-ng/tokens`](packages/tokens) | palettes, radius, typography, shadows, motion — plain data | ✓ | | [`@tectra-ng/icons`](packages/icons) | 334 outline icons and `` | ✓ | | [`@tectra-ng/brand-icons`](packages/brand-icons) | brand logos from Simple Icons (CC0) | ✓ | | [`@tectra-ng/flags`](packages/flags) | country flags, rectangle and circle, loaded one by one | ✓ | | [`@tectra-ng/editor`](packages/editor) | rich text editor on the ProseMirror core and a renderer for saved text | — | | [`@tectra-ng/code-editor`](packages/code-editor) | code editor on the CodeMirror core: search, inline and side by side diff, static highlighter | — | The two editors are installed next to `tectra-ng` on their own, so apps without an editor do not carry its engine: ```bash npm install @tectra-ng/editor @tectra-ng/code-editor ``` ## Development ```bash npm install npx nx serve docs # the docs site on http://localhost:4300 npx nx serve sandbox # bare playground on http://localhost:4301 npm run build:packages # npm packages into dist/packages/* npm run lint # ESLint + package boundaries npm run test # unit tests (Vitest) npm run e2e # Playwright checks of the docs site ``` Packages depend on each other in one direction; a package never imports anything to its right, and packages never import apps: ``` tokens → themes → core → ui → editor, code-editor, charts, utils → blocks ← qr ``` Every docs example is rendered live on its page, shown as source and checked by the Playwright suite — in light and dark, with axe. | Folder | What lives there | |---|---| | `packages/*` | the npm packages above | | `apps/docs` | the documentation site, deployed to [tectra-ng.com](https://tectra-ng.com) | | `apps/sandbox` | local playground | | `e2e/visual` | Playwright checks and axe | | `tools` | docs registry, site files, icons, flags, brand images, release | What comes next and in which order: [ROADMAP.md](ROADMAP.md). ## Contributing Issues and pull requests are welcome — read [CONTRIBUTING.md](CONTRIBUTING.md) and the [code of conduct](CODE_OF_CONDUCT.md) first. Security issues go through the private process in [SECURITY.md](SECURITY.md), which also explains how to verify a release. How the project is run: [GOVERNANCE.md](GOVERNANCE.md); how it is built: [ARCHITECTURE.md](ARCHITECTURE.md); its threat model: [THREAT_MODEL.md](THREAT_MODEL.md). ## License [MIT](LICENSE). Brand logos come from Simple Icons (CC0), flags from flag-icons (MIT), the export font is Onest (OFL).