Skip to content

docs: lighten the tile behind the mark, and put the card on surface - #194

Merged
isaacslee merged 1 commit into
mainfrom
docs/lighter-mark-tile
Aug 6, 2026
Merged

isaacslee merged 1 commit into
mainfrom
docs/lighter-mark-tile

Conversation

@isaacslee

Copy link
Copy Markdown
Member

The tile behind the mark read as a grey slab against a white page. It moves from
--light-surface-2 #f2f2f0 to #f7f7f6.

Lightening it alone would have broken the social card: the card was
--light-paper #fbfbfa, and a #f7f7f6 tile separates from that by 1.035 —
close enough to stop being a tile at all.

So the card moves too, to --light-surface #ffffff. That is the more correct
token regardless: a card is not a page, and every card in the skin is
--light-surface.

tile card separation
before #f2f2f0 #fbfbfa 1.083
tile alone #f7f7f6 #fbfbfa 1.035
this #f7f7f6 #ffffff 1.072

On the value

#f7f7f6 is the only number in this decision that is not a token, and ADR-0005
now says so and says what was tried on either side. --light-paper dissolved
into the page; --light-surface-2 was a slab. There is no token between them.

Validation

node scripts/check.mjs — 26 checks, passed, including the palette check
against the generator's new --light-surface declaration.

Read back out of the generated files: the mark's margin is one value, #f7f7f6;
the card is #ffffff. Margins are unchanged at 183/183 horizontally and 134/134
vertically.

- the tile moves from `--light-surface-2` to `#f7f7f6`, which read as a
  grey slab against a white page at the darker value
- the social card moves from `--light-paper` to `--light-surface`: a card
  is not a page, and the skin's own cards are surface
- that correction is also what makes room for the lighter tile — against
  paper it separates by 1.035, against surface by 1.072, where the
  arrangement it replaces managed 1.083
- record in ADR-0005 that the tile is the one value here that is not a
  token, and what was tried on either side of it
Copilot AI lite review requested due to automatic review settings August 6, 2026 04:54

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@isaacslee
isaacslee merged commit e920e08 into main Aug 6, 2026
1 check passed
@isaacslee
isaacslee deleted the docs/lighter-mark-tile branch August 6, 2026 04:55
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.

2 participants