Skip to content

refactor(design): one token language, and a gate that fails on slop - #72

Merged
github-actions[bot] merged 1 commit into
mainfrom
ux/design-discipline
Aug 13, 2026
Merged

refactor(design): one token language, and a gate that fails on slop#72
github-actions[bot] merged 1 commit into
mainfrom
ux/design-discipline

Conversation

@catomean

Copy link
Copy Markdown
Collaborator

Why

Solon was the sloppiest sibling. OrangeCat and FleetCrown speak text-fg-* / bg-surface-* / border-default. Solon spoke 183 raw slate/gray utilities, 12–24px radii, page gradients, and had no design gate. That is three design systems, not one discipline.

What

  • globals.css is the only place raw color exists: primitives → semantic tokens with the same names as the other two products.
  • Tailwind maps those vars. Components never name a palette.
  • Radii flatten to 8px. Body is a solid surface. Navy hero is one CSS class, not a component gradient.
  • npm run design:check is in verify. The next text-slate-600 is a red build.

Contract (all three products)

  1. Tokens in globals.css only.
  2. Components use semantic utilities.
  3. 8px radius or below.
  4. Hierarchy is type + border, not shadow or gradient.
  5. One accent. No gray-500.

OrangeCat/FleetCrown already mostly live this. Solon now does too, and cannot silently drift.

Test

node scripts/design-system-check.js → ok.

Solon was speaking Tailwind slate/gray while OrangeCat and FleetCrown
speak semantic surfaces. Components now use the same names
(text-fg-*, bg-surface-*, border-default). Radii flatten to 8px.
Brand navy is a solid surface, not a gradient. design:check is in
verify so the next slate class is a red build, not a vibe.
@github-actions
github-actions Bot merged commit 488e06b into main Aug 13, 2026
2 checks passed
@github-actions
github-actions Bot deleted the ux/design-discipline branch August 13, 2026 10:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant