Skip to content

docs: spec and plan the 0.4.0 macOS identity - #30

Merged
fajarhide merged 2 commits into
mainfrom
spec/macos-identity-0.4.0
Aug 6, 2026
Merged

fajarhide merged 2 commits into
mainfrom
spec/macos-identity-0.4.0

Conversation

@fajarhide

@fajarhide fajarhide commented Aug 1, 2026 •

Copy link
Copy Markdown
Contributor

Two documents, no code.

The spec replaces the inherited three product look with one chosen identity: a
single neutral ladder, one system blue, Inter on its optical size axis, and
continuous corners as the signature. Themes drop to light and dark, paper goes
back to Omni's own stylesheet, six typefaces become three.

primary is ink rather than blue, so the filled pill is the only solid button
and blue is left for rings, links and the first chart series. The terminal
survives as ten tokens with a real ANSI palette, on a ground that stays dark in
both themes because the same palette on white tops out at 2.87:1. Two
archetypes sit on the core, marketing and catalog, each with its own tokens and
forbidden from redefining a core one.

Every ratio is computed with lib/contrast.js. Apple's systemBlue fails AA on
white at 4.02:1 and systemRed measures 4.99:1 on the terminal ground, so
neither value is used. The values in the plan were also measured against the
gates that already exist, so the suite should go green as written.

The plan covers the core in thirteen tasks, each ending in a commit. Archetypes,
components, prose and Figma are listed as later phases and get their own plans.

Sets up #23, #24 and #25. specs/ and plans/ are new tracked directories
because docs/superpowers is gitignored and the last two specs were never
committed.

Replaces the inherited three product look with one chosen identity: a single
neutral ladder, one system blue, Inter on its optical size axis, and continuous
corners as the signature. Themes drop to light and dark, paper goes back to
Omni's own stylesheet, and six typefaces become three.

The terminal survives as ten tokens with a real ANSI palette instead of one
amber phosphor, on a ground that stays dark in both themes because the same
palette on white tops out at 2.87:1.

Two archetypes sit on the core, marketing and catalog, each allowed its own
tokens and forbidden from redefining a core one.

Every ratio in the spec is computed with lib/contrast.js. Two of Apple's own
values did not survive it: systemBlue fails AA on white at 4.02:1, and
systemRed measures 4.99:1 on the terminal ground.

specs/ is used rather than docs/superpowers/, which is gitignored, so the
reasoning behind 0.4.0 lives in the repo rather than only in a session.
@vercel

vercel Bot commented Aug 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
design Ready Ready Preview Aug 1, 2026 5:47pm

Thirteen tasks covering the tokens, the terminal, the three faces, the radius
ladder, the docs site and the release, each one ending in a commit. Later
phases are listed but not planned; they get their own plan when the phase
before them lands.

Values in the plan were measured against the gates that already exist, so the
suite should go green on the values as written. Three repo facts that cost time
are stated up front: dist/ is committed, piped test output is unreliable here,
and a failing contrast assertion means the value is wrong rather than the gate.

plans/ sits beside specs/ for the same reason, docs/superpowers is gitignored.
@fajarhide fajarhide changed the title docs: spec the 0.4.0 macOS identity docs: spec and plan the 0.4.0 macOS identity Aug 1, 2026
@fajarhide
fajarhide merged commit 46a696c into main Aug 6, 2026
3 checks passed
@fajarhide
fajarhide deleted the spec/macos-identity-0.4.0 branch August 6, 2026 02:00

This branch was successfully deployed

1 active deployment
Preview — 321ee519 Deployed Aug 1, 2026 by vercel[bot]
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