Instructions

What the repo builds, the pipeline diagram, prerequisites, quickstart and how to run the three apps.

README.md

Ten short lessons from tokens to deploy, each linking the real files.

docs/learn/README.md

Clone → rename and recolour in fixtures/site.config.json and mapping.json → bun run regen → green check.

docs/new-brand.md

Golden rules, pipeline order, how to read common requests and the definition of done.

AGENTS.md

Layers, data flow and why the adapter layer exists.

docs/architecture.md

Short command-by-command manual, setup to deploy.

.manual/README.md

Commit rules and how to propose a change.

CONTRIBUTING.md

Where colors, radius and type come from; package tokens vs app brand tokens.

docs/learn/01-tokens.md

Corners, spacing rhythm, media and control sizes, with the Figma measurements.

docs/design-settings.md

Commands: mapping.json → theme.css, brand.css and the brand-os bundle.

.manual/03-tokens-brand-os.md

Token colors only in packages; brand colors only at app level.

.cursor/rules/tokens.mdc

Outer 40px brand radius, one fixed md token inside, 8px preview frame.

.cursor/rules/radius.mdc

How the dark theme is defined and switched.

.cursor/rules/dark-mode.mdc

codegen 2.0 bricks, recipe overrides and the generated templ, Svelte and React components.

docs/learn/03-primitives.md

Why apps and blocks never write raw HTML tags, and the lint that checks it.

docs/learn/04-retag.md

The block DSL and how one def becomes three runtimes.

docs/learn/05-blocks.md

Semantic ui-* classes and @apply.

docs/learn/07-adapter.md

The three apps and DOM parity between them.

docs/learn/08-runtimes.md

Adding Vue, Solid or a server template language, following how React was added.

docs/add-a-runtime.md

Block as the only landmark unit, retagged by meaning; no raw tags.

.cursor/rules/blocks-retag.mdc

fig2design: the dump schema (frames, images, variables) and which scripts read it.

docs/figma-parser.md

Extract another .fig with fig2design, map its palette, frames and texts, then measure drift.

docs/replicate-with-new-figma.md

Figma dump → contract records → view models; why copy never lives in components.

docs/learn/06-contract-fixtures.md

Commands to run the fig2design parser on a .fig kept outside the repo.

.manual/01-extract-figma.md

The agent workflow from .fig to deployed apps.

.cursor/skills/figma-to-site/SKILL.md

The ten blocks rebuilt from the Figma frame, as block DSL.

packages/blocks/defs/figma.ts

Reads the parsed frame by node id and image hash and writes the contract records.

tools/content.ts

What bun run check runs and how to read a failure.

docs/learn/09-checks.md

Every check, what it verifies and how to fix it.

docs/checks.md

Layout and control rhythm, and how ui8px enforces both.

docs/learn/02-grid-8-4.md

Allowed spacing steps per scope and how new utilities are reviewed.

.cursor/rules/grid-8-4.mdc

Known gaps and their fixes, linked to the backlog.

docs/troubleshooting.md

How tool problems and deliberate deviations are logged.

.project/backlog/README.md

The three Vercel projects in short.

docs/learn/10-deploy.md

Three Vercel projects from one repo: root directories, install and build commands.

docs/deploy-vercel.md

Terse deploy manual.

.manual/08-deploy-vercel.md

Small verified commits, normal push, no force or amend.

.cursor/rules/git-workflow.mdc