# m7kni design system

> One design system for every m7kni / rknightion / BroTEK product. Petrol accent, petrol-tinted
> neutrals, compact operator density, precise 3px radius, Hanken Grotesk + JetBrains Mono, Phosphor
> icons. Light default, first-class dark. Source: https://github.com/m7kni/design-system

## Start here

- [FOUNDATIONS.md](FOUNDATIONS.md): the frozen decisions — read before any UI work
- [DESIGN.md](DESIGN.md): machine summary; frontmatter is generated from the tokens
- [SKILL.md](SKILL.md): how agents apply the system

## Voice and patterns

- [docs/voice.md](docs/voice.md): voice rules and the canonical glossary
- [docs/adoption.md](docs/adoption.md): consuming the system in a new app; where new designs get made
- [docs/patterns/app-shell.md](docs/patterns/app-shell.md): the shell every console uses
- [docs/patterns/list-page.md](docs/patterns/list-page.md): the workhorse list screen
- [docs/patterns/detail-page.md](docs/patterns/detail-page.md): one item from a list
- [docs/patterns/confirm-destructive.md](docs/patterns/confirm-destructive.md): irreversible actions
- [docs/patterns/states.md](docs/patterns/states.md): empty, loading, error, toasts

## Tokens and components

- [tokens.css](tokens.css): every semantic variable, both themes
- [theme.css](theme.css): Tailwind v4 bridge and utility names
- [r/registry.json](r/registry.json): installable components (npx shadcn add)