DESIGN.md@apps/webA

DESIGN.md@apps/web from kamiazya/whiteboard is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add kamiazya/whiteboard/apps/web/DESIGN.md@git:20261017.4e8a1cc

Pins git:20261017.4e8a1cc in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
kamiazya/whiteboard
Path
apps/web/DESIGN.md
Versions recorded
10
Latest version
git:20261017.4e8a1cc, committed Oct 17, 2026
First version recorded
Sep 7, 2026
Size
81,226 bytes
Repository stars
10
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# apps/web design system

Direction: **quiet tool** (Linear/Figma lineage). The canvas content is the
only hero; chrome recedes.
Brand surfaces around the app (mark, splash, favicon, icons, social cards)
are governed by [BRAND.md](./BRAND.md).
Hierarchy comes from surfaces and whitespace, not boxes. Accent color carries
**state meaning only** — never decoration.

## Tokens

All tokens live in `src/index.css` as CSS custom properties (oklch), mapped
into Tailwind v4 via `@theme inline`. Light values on `:root`, dark on
`.dark`. Do not hardcode palette values in components; if a component needs a
color the tokens cannot express, that is a token-system change, not an inline
value.

| Token | Role |
| --- | --- |
| `--background` / `--foreground` | page surface and its text |
| `--card`, `--popover` (+`-foreground`) | raised surfaces (cards, menus, popovers) |
| `--primary` (+`-foreground`) | the one emphasized action per view |
| `--secondary`, `--muted`, `--accent` (+`-foreground`) | quiet fills, de-emphasized text, hover fills |
| `--destructive` | irreversible actions and error text ONLY |
| `--border`, `--input`, `--ring` | hairlines, input outlines, focus rings |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kamiazya/whiteboard/apps/web/DESIGN.md@sha256:4779fa90c20bd353

The line at the top of this page pins the label git:20261017.4e8a1cc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ygacdtfkkocgbiqf.svg)](https://markdownregistry.com/a/art_ygacdtfkkocgbiqf)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Sep 7, 2026 and Oct 17, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261017.4e8a1cc latest2026-10-17 4e8a1cc 81,226 BA view · diff
git:20261014.fe0be062026-10-14 fe0be06 81,190 BA view · diff
git:20261006.53380bb2026-10-06 53380bb 81,202 BA view · diff
git:20261003.a71f44f2026-10-03 a71f44f 81,083 BA view · diff
git:20261002.3e133322026-10-02 3e13332 82,802 BA view · diff
git:20260912.2aa8eb72026-09-12 2aa8eb7 82,801 BA view · diff
git:20260912.e4586662026-09-12 e458666 82,447 BA view · diff
git:20260912.f6bc2142026-09-12 f6bc214 81,191 BA view · diff
git:20260911.dec0d692026-09-11 dec0d69 76,915 BA view · diff
git:20260907.7e145662026-09-07 7e14566 70,936 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (81226 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kamiazya/whiteboard · 10 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ygacdtfkkocgbiqf
GET https://markdownregistry.com/api/v1/resolve?ref=kamiazya/whiteboard/apps/web/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/4779fa90c20bd3539e8609b1eb7ece77a051491566d19cb930d112f1f8cf1ab5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from kamiazya/whiteboard

audit-triage SKILL.md skill
kamiazya/whiteboard · .claude/skills/audit-triage/SKILL.md · How to run the periodic standing-codebase-health audit in the whiteboard repo — fan out auditors across health…
git:20261016.bbfc32d · audit A · 10 stars
ci-triage SKILL.md skill
kamiazya/whiteboard · .claude/skills/ci-triage/SKILL.md · Monitor and triage the POST-PUSH automated-review surface for the whiteboard repo — GitHub Actions CI, CodeRabbit…
git:20261004.5179c73 · audit A · 10 stars
dependabot-review SKILL.md skill
kamiazya/whiteboard · .claude/skills/dependabot-review/SKILL.md · Triage, review, and merge Dependabot dependency-bump PRs + clear Dependabot security alerts for the whiteboard repo…
git:20261005.2713cc5 · audit A · 10 stars
diagnosis-evidence SKILL.md skill
kamiazya/whiteboard · .claude/skills/diagnosis-evidence/SKILL.md · Make a diagnosis prove it measured what it claims — before reporting a cause, a "not a regression", a mutation check…
git:20261015.4ac2e19 · audit A · 10 stars
docs-sync SKILL.md skill
kamiazya/whiteboard · .claude/skills/docs-sync/SKILL.md · When and how to update the whiteboard project's docs alongside a code change — the trigger→target map, Diátaxis…
git:20260831.7d13b8f · audit A · 10 stars
loro-crdt-usage SKILL.md skill
kamiazya/whiteboard · .claude/skills/loro-crdt-usage/SKILL.md · How this repo uses loro-crdt correctly — mergeable child containers vs the deprecated getOrCreateContainer, what a…
git:20261016.bbfc32d · audit A · 10 stars
mcp-tool-surface SKILL.md skill
kamiazya/whiteboard · .claude/skills/mcp-tool-surface/SKILL.md · How to change the whiteboard MCP tool table — rename, re-describe, reshape, add, consolidate or retire a tool — with…
git:20261002.5a9037f · audit A · 10 stars
measured-change SKILL.md skill
kamiazya/whiteboard · .claude/skills/measured-change/SKILL.md · Build the measuring instrument before changing anything whose effect you cannot see by reading the diff — quality…
git:20260910.514441f · audit A · 10 stars
ponytail SKILL.md skill
kamiazya/whiteboard · .claude/skills/ponytail/SKILL.md · The simplicity ladder — delete > reuse what the repo already has > stdlib > native platform > already-installed…
git:20261002.0803037 · audit A · 10 stars
react-best-practices SKILL.md skill
kamiazya/whiteboard · .claude/skills/react-best-practices/SKILL.md · React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing…
v1.0.0 · audit A · 10 stars
review-gate SKILL.md skill
kamiazya/whiteboard · .claude/skills/review-gate/SKILL.md · How to run the whiteboard repo's per-diff change-review gate — args, return contract, and the externalized-criteria…
git:20261013.aa963a1 · audit A · 10 stars
stacking-pull-requests SKILL.md skill
kamiazya/whiteboard · .claude/skills/stacking-pull-requests/SKILL.md · Operates a stack of dependent pull requests in the whiteboard repo with the gh-stack extension — creating a stack…
git:20261016.bbfc32d · audit A · 10 stars

Every file in kamiazya/whiteboard

Other files named DESIGN.md@apps/web

DESIGN.md@apps/web DESIGN.md file
reactive-resume/reactive-resume · apps/web/DESIGN.md · A warm, quiet interface around bright paper. Moss green marks primary actions, selection, and progress. Light and dark…
v6.0.0 · audit A · 44,652 stars
DESIGN.md@apps/web DESIGN.md file
reactive-resume/app · apps/web/DESIGN.md · A warm, quiet interface around bright paper. Moss green marks primary actions, selection, and progress. Light and dark…
v6.0.0 · audit A · 44,650 stars
DESIGN.md@apps/web DESIGN.md file
amruthpillai/reactive-resume · apps/web/DESIGN.md · A warm, quiet interface around bright paper. Moss green marks primary actions, selection, and progress. Light and dark…
v6.0.0 · audit A · 44,554 stars
DESIGN.md@apps/web DESIGN.md file
fancydirty/mediary-scout · apps/web/DESIGN.md
git:20260612.10ce840 · audit A · 1,533 stars
DESIGN.md@apps/web DESIGN.md file
hraness/atet · apps/web/DESIGN.md
git:20260929.346af64 · audit A · 7 stars
DESIGN.md@apps/web DESIGN.md file
hraness/slopcamera · apps/web/DESIGN.md
git:20260929.346af64 · audit A · 7 stars
DESIGN.md@apps/web DESIGN.md file
figueroaignacio/ignaciofigueroa.dev · apps/web/DESIGN.md
git:20260912.6189d1b · audit A · 6 stars

Browse by kind, by grade A, or by owner.