feat(docs): repoint the accent from the org pink to amber - #47
Merged
Conversation
#EE9CC4 is --bt-pink-soft, the org accent. design.md reserves it for org chrome
("the org accent never paints package content"), so entity was borrowing the
wordmark's colour for its own.
Amber says what entity does: amber encases and preserves — a thing suspended
intact, permanently. That is sealed construction and immutable data. #C8871F
measures 6.32 on the dark card and 5.61 as darkened text on white (AA).
The record mark's validation stamp carries it (stroke only — the beet's own
#CE3D80 body fill is untouched), as do the four feature icons, which hardcode
the hex rather than deriving it.
btravers
force-pushed
the
feat/amber-accent
branch
from
August 8, 2026 18:29
65521a0 to
a3ffc09
Compare
There was a problem hiding this comment.
Pull request overview
This PR updates the documentation site’s visual identity for the entity package by changing its accent color from the org pink to an amber tone, and propagating that change to the docs theme and related SVG assets.
Changes:
- Repoints the docs accent token (
--accent) to#c8871f(amber) in the VitePress theme CSS. - Updates the “validation stamp” stroke color in both light/dark logo SVGs to match the new accent.
- Updates the four home-page feature icons to use the new accent color.
Reviewed changes
Copilot reviewed 1 out of 7 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/.vitepress/theme/custom.css | Switches --accent to amber and updates the explanatory comment. |
| docs/public/logo-light.svg | Changes the validation-stamp stroke to amber. |
| docs/public/logo-dark.svg | Changes the validation-stamp stroke to amber. |
| docs/public/icons/seal.svg | Recolors icon stroke to amber. |
| docs/public/icons/schemas.svg | Recolors icon stroke to amber. |
| docs/public/icons/result.svg | Recolors icon stroke to amber. |
| docs/public/icons/nest.svg | Recolors icon stroke to amber. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
btravers
added a commit
to btravstack/btravstack.github.io
that referenced
this pull request
Aug 8, 2026
entity is published (0.3.0) with its docs live, so it joins the landing as the
fourth panel. It sits second, after unthrown and before the two contract
packages: the row now reads as the stack does — errors, the domain built on
them, then the transports that carry it.
Its mark is entity's own docs logo, copied under logos/entity-{light,dark}.svg,
which is the same convention the other three follow (verified: the unthrown
pair is byte-identical to unthrown/docs/public/logo-*.svg).
New --pkg-entity token, amber #C8871F: amber encases and preserves — a thing
suspended intact, permanently — which is sealed construction and immutable
data. 6.32 on the dark card, 5.61 as darkened text on white (AA). It replaces
--bt-pink-soft, the org accent, which entity's docs were borrowing;
btravstack/entity#47 moves that half.
The hero count and the footer link lists derive from the array, so only the
section heading and lead needed the three-to-four edit.
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
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.
Companion to btravstack/btravstack.github.io#41, which adds entity to the landing page and needs a package accent for it.
Why not the pink
--accent: #ee9cc4is--bt-pink-soft— the org's own accent.design.mdis explicit: "The org accent never paints package content, and package accents never paint org chrome." entity was wearing the wordmark's color, so on the landing its panel glow and package name would have sat next to the beetroot wordmark in the same pink.Why amber
The other packages' colors mean something — amqp wears RabbitMQ's orange, temporal wears Temporal's indigo, unthrown just moved to teal for not a signal, a value. entity needed one that says what it does.
Amber encases and preserves: a thing suspended intact, permanently. That is sealed construction and immutable data — validate once, seal, and it never changes. It's a material metaphor rather than a signal one, so it doesn't reopen the traffic-light reasoning that put unthrown on teal.
Numbers
#C8871Fmeasures 6.32 on the dark card and 5.61 as darkened text on white — AA in both directions. The lighter ambers were prettier and failed:#D9A441is 4.36 on white,#E0A93Ais 4.14.It is 13° from amqp's orange in hue, which is the honest cost. They separate on lightness and saturation instead — amqp is
#FF6600at full saturation, this is a deep ochre — so side by side they read as "bright orange" and "deep gold" rather than as a pair.What moves
--accentindocs/.vitepress/theme/custom.css.logo-dark.svg/logo-light.svg— the element that means "entity": sealed, validated. Targeted atstroke="#CE3D80"only; the beet's ownfill="#CE3D80"body is untouched, andlogo.svg(the favicon, the mascot lifted out of its frame) has no stamp and needs no change.Docs build is clean; amber is in the emitted CSS and no
ee9cc4survives.