Adoption Status — Whetstone Design System¶
Scope of this commit (the design system itself, only)¶
| Content | Status |
|---|---|
packages/design-tokens/ (tokens.css / tokens.json / README) |
✅ Added. The single source of truth for color, typography, spacing, shadows, motion, and density |
docs/design/ (the Whetstone overview / components / patterns / brand pages) |
✅ Added. The constitution + spec + brand assets |
The .ds-* utilities that consume the density tokens |
✅ Implemented in tokens.css. data-density actually changes rendered dimensions (proven in density-demo.html) |
.claude/rules/design-system.md (the agent entry point) |
✅ Referenced from CLAUDE.md; auto-read before any UI work |
Verifying density behavior: density-demo.html (the same markup renders differently under comfortable / compact).
Not done yet (follow-up — separate PR)¶
| Gap | Details | Priority |
|---|---|---|
| Adoption by apps | Konro adopts shared colors, typography and shadows. Full component/density migration remains separate. The next kensan frontend should use Whetstone from day one. | Medium |
| Monorepo / toolchain | For now, tokens are shared via a relative import (@import "…/packages/design-tokens/tokens.css"). Whether to move to a pnpm or npm workspace setup and reference it as the @kensan-lab/design-tokens package is a separate decision (pnpm isn't adopted yet) |
Medium |
| Packaging shared components | @kensan-lab/ui doesn't exist yet. The implementation source of truth is each app's own components/ui/ (shadcn). Consider packaging once more apps exist |
Low |
Verification notes¶
- Rendered
density-demo.htmlwith the Whetstone tokens and confirmed via screenshot that togglingdata-densitybetween comfortable / compact actually changes rendered dimensions. - Token values (palette, typography, density) were finalized during the design phase. This commit implements and wires them up.
Konro (2026-10-17)¶
Konro imports packages/design-tokens/tokens.css directly for all colors, typography and shadows. OS theme changes toggle the shared .dark selector; form controls set explicit foreground/placeholder colors. Docker preserves the relative token import. Kitchen touch targets and layout retain their existing geometry; full component/density adoption remains separate work.