ADR-0003 accepted: palette is LIGHT; Phase 1a planned - #502
Merged
Merged
Conversation
Paul resolved the one open decision on a lightning demo of the peer set. Every services company reviewed ships light - thoughtbot, Test Double (a Rails consultancy selling to technical buyers), Basecamp (dark is a user preference, not the brand) - and the decisive signal is Linear, the poster child for dark product aesthetics, shipping a LIGHT marketing site. Dark marketing belongs to products bought by developers evaluating a tool; light belongs to services bought on trust. The literature supplies the mechanism: light reads as more open and trustworthy, and holds a comprehension edge at small font sizes - our exact case, since our humans are on phones (28% of GSC clicks from 6% of impressions). The dark case lost on a distinction worth keeping: vibe-code-rescue is our best page and it is obsidian, but its quality is STRUCTURAL not chromatic, and every structural element already shipped in the light blog. Dark stays deliberately in three places - cover art, one proof band per page, and vibe-code-rescue as a dark-variant campaign page. 20.02 plans Phase 1a with the surface measured, not estimated: 161 var(--color-primary) + 52 literals, 8 #0066d6 rule sites, 55 scoped !important workarounds across four files, 262 macOS / 137 Linux baselines. Sequenced so the token promotion ships zero-delta first, making the deletion a value change rather than a rename. The phase's success signal is that all 55 !importants can go - if they can't, the replacement is wrong. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contributor
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only. Closes the last open decision in the 2608 design system and writes
the phase it unblocks.
Palette: LIGHT (Paul, 2026-08-20)
Resolved on a lightning demo of the peer set rather than taste:
The split is audience-shaped, not taste-shaped. Dark marketing belongs to
products bought by developers evaluating a tool; light belongs to services
bought on trust. The literature supplies the mechanism: light reads as more
open and trustworthy, dark "weakens a trusting emotional connection", and light
holds a comprehension edge at small font sizes — our exact case, since our
humans are on phones (28% of GSC clicks from 6% of impressions).
The dark case lost on a distinction worth keeping.
/services/vibe-code-rescue/is the best page on the site and it is obsidian —but its quality is structural, not chromatic (proof chips in fold one, one
repeated CTA, artifact cards, ~4,300px), and every one of those already shipped
in the light blog.
Dark stays deliberately in three places: blog cover art, one dark proof band
per page, and vibe-code-rescue as a dark-variant campaign page — same tokens
and components, not a second design system.
Phase 1a planned (20.02)
Surface measured, not estimated: 161
var(--color-primary)+ 52literals, 8
#0066d6rule sites, 55 scoped!importantworkaroundsacross four files, 262 macOS / 137 Linux baselines.
Sequenced so 1a.1 promotes tokens zero-delta (no baseline churn), making the
deletion a value change rather than a rename. Gates are A/B/C per ADR-0004 — no
A/B test, plus a hard WCAG AA contrast gate.
The phase's success signal: all 55
!importants can go. If they can't, thereplacement link colours are wrong.
bin/hugo-buildgreen; OKF conformant under--strict.🤖 Generated with Claude Code