Skip to content

About

Angular 22 UI kit (standalone, signals, SCSS) with a demo app

Resources

Contributing

Security policy

Accessibility

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Kometa UI

npm license

89 dense, warm components for Angular 22, built on signals, with no third-party UI dependency. You import only the components you use, restyle everything from one set of CSS custom properties in light and dark, and ship docs your AI coding agent can read.

Live demo and docs · Try it on StackBlitz · Compose Multiplatform, live (compose/)

Shop dashboard screen built from Kometa UI components

A few highlights

k-film + k-slots: a week strip with a glass thumb that slides behind the chosen day, and bookable times as glass chips.

A day strip above a grid of time slots
<k-film [days]="days" [(value)]="day" ariaLabel="Day" />
<k-slots [slots]="slots()" [(value)]="time" ariaLabel="Time" />

k-reveal: before and after in one frame, scrubbed along a row of ticks by drag or arrow keys.

A before and after photo with a tick slider underneath
<k-reveal [before]="before" [after]="after"
          aspectRatio="4/3" ariaLabel="Before and after" />

k-hue: a colour picked from a row of hue ticks, each drawn in its own hue; saturation and lightness stay fixed so every pick fits one family.

A row of coloured ticks with the chosen hue standing tall
<k-hue [(value)]="brand" ariaLabel="Shop colour" />

k-tally: a figure that counts up to its new value, with ticks that fill toward max. A screen reader hears only the final value.

Two counting figures, one with a row of filling ticks
<k-tally [value]="visits()" [max]="240" unit="visits of 240" />

k-countdown: time running out as ticks that drain one by one; (done) fires at zero.

An SMS code field with a draining countdown under it
<k-countdown [duration]="20" label="to send it again"
             (done)="canResend.set(true)" />

k-swipe: pull a row right and ticks fill until it is done; pull left and a ring grows and turns red. Both actions are also buttons reached with Tab.

<k-swipe rightLabel="Done" leftLabel="Cancel visit"
         (swipedRight)="done(v)" (swipedLeft)="cancel(v)">
  …
</k-swipe>

Also worth a look: [kAnimate] motion presets, button[k-halo], k-tick, k-digits, and the four full Screens.

The docs site has no sidebar: press M for the constellation map of every page, or Ctrl+K to search.

The constellation map of the docs site

Use it

ng add kometa-ui

ng add (from 0.3.0) installs the package, puts the layer order and base styles at the top of your global stylesheet and adds provideKometaUi(). To set it up by hand:

npm install kometa-ui
// app.config.ts
import { provideKometaUi } from 'kometa-ui/provide-kometa-ui';

export const appConfig = { providers: [provideKometaUi()] };
// styles.scss: the layer order must come first
@use 'kometa-ui/styles/layers';
@use 'kometa-ui/styles/base';
<button k-button (click)="save()">Save</button>

Components use the k- prefix (<k-drawer>, button[k-button], button[k-halo]) and read their colours from tokens such as --amber, --bg and --text, so overriding a token on any element restyles everything inside it. Import each component from its own entry point (import { KometaButton } from 'kometa-ui/button') so lazy routes keep their components.

kometa-ui Angular
0.1 – 0.3 22.2+

Keyboard and screen-reader support for every component, and the known gaps, are in ACCESSIBILITY.md. Release history: CHANGELOG.md.

Using it with AI agents

The package ships a guide written for coding agents, ai/usage.md, and a generated reference of every component's selector, inputs, outputs and defaults, ai/components.md. Point your agent at them by adding a line to your project's AGENTS.md (or CLAUDE.md):

UI components come from kometa-ui: read node_modules/kometa-ui/ai/usage.md before writing UI code,
and node_modules/kometa-ui/ai/components.md for a component's inputs and outputs.

Claude Code can pull the guide straight in with @node_modules/kometa-ui/ai/usage.md. Tools that read the web can use llms.txt and llms-full.txt.

Develop

npm install
npm start          # demo at http://localhost:4200
npm test           # library specs (vitest)
npm run build      # library into dist/kometa-ui

The repo holds two projects: projects/kometa-ui (the library) and projects/demo (the docs site, which imports the library from source). Every push to main deploys the demo to GitHub Pages.

Contributions are welcome: see CONTRIBUTING.md.

License

MIT. The bundled Manrope and Syne fonts are under the SIL Open Font License 1.1.

About

Angular 22 UI kit (standalone, signals, SCSS) with a demo app

Resources

Contributing

Security policy

Accessibility

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages