AGENTS.md@apps/ui · git:20260917.2ff2bf1 · 2026-09-17 · sha256 b58e8f7fed3c9ad0
AGENTS.md@apps/ui git:20260917.2ff2bf1A
Immutable. This exact content never changes and is served at /api/v1/blob/b58e8f7fed3c9ad0.
## UI Next.js app. Iterate without the full stack: `./node_modules/.bin/next dev --port 9120`. ### Design system (Slate) `src/app/design-system.css` is the runtime source of truth; [`DESIGN.md`](./DESIGN.md) is its agent-readable companion in the [DESIGN.md format](https://github.com/google-labs-code/design.md). Change tokens in both together, then run `pnpm run design:lint`. Design intent and brand rationale live in [`knowledge/ui/brand.md`](../../knowledge/ui/brand.md). Light and dark both ship. Style with semantic tokens (`bg-background`, `text-muted-foreground`, `border-border`), not raw palette colors — a `text-gray-500` looks fine in light mode and disappears in dark. `.dark` on `<html>` is the only switch; `src/lib/theme.ts` owns the cookie and the pre-paint script. <!-- BEGIN:nextjs-agent-rules --> # This is NOT the Next.js you know This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices. This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean. <!-- END:nextjs-agent-rules -->