Files and tools
Comb lives in the KiBee repository. These are the files to read before you change console UI, and the checks to run before you finish.
Files
| Path | What it holds |
|---|---|
apps/web/app/globals.css | Every token on :root, and the kb- component classes under the banner Admin components. |
apps/web/components/ui | The React components. They take no className or style; the variant is the whole look. |
docs/comb/LEARNINGS.md | The decision log: what Atlassian, Polaris, Primer, Material, Apple and Carbon decided, and what Comb does as a result. |
docs/comb/llms.txt | A plain-text summary of tokens, components and rules for coding agents. |
docs/DESIGN_SYSTEM.md | The longer reference, including the type role table. |
DESIGN.md | The look and feel: the Approach Chart world, colour meanings and motion grammar. |
Checks
Comb lint counts raw values per area of the console. Warnings by default; the strict run fails on error-level rules.
npm run lint:comb
npm run lint:comb -- --strict- Error-level now: text under 12px, weight 800, and font-weight: inherit after a role shorthand.
- Warnings: raw hex, raw px spacing, off-token font sizes, raw buttons, links without href and clickable divs.
- Do not add to a warning count in an area you touch; reduce it when you can.