Skip to content

docs(theme): align heading typography and fix the mobile theme-color - #19

Merged
bloxster merged 2 commits into
mainfrom
docs/align-typography-rhythm
Aug 3, 2026
Merged

bloxster merged 2 commits into
mainfrom
docs/align-typography-rhythm

Conversation

@bloxster

@bloxster bloxster commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Two theme-alignment fixes, keeping the green body theme intact.

1. Heading typography (src/css/custom.css)

The Erigon docs site gained a typography pass in erigontech/erigon a9135af285 that never reached the sibling sites. Ports that block verbatim: h1/h2 letter-spacing, uppercase h6, font smoothing, --ifm-heading-line-height: 1.2, .markdown h2/h3 margins, and scroll-margin-top so heading anchors clear the sticky navbar. Verified byte-identical to erigon's block at the same offset. Palette-agnostic.

2. Mobile theme-color (docusaurus.config.ts)

The terminal-green theme recolored the stylesheet but left the theme-color meta tag at #EF7716. That tag tints the browser chrome on mobile — Chrome's address bar on Android, the status-bar area on iOS — so the mobile site rendered an Erigon-orange bar above an otherwise green site. Now #1F9D3E, matching --ifm-color-primary.

A full sweep confirms this was the last unintentional orange: every remaining #EF7716 is the shared corporate footer, which stays orange by design (see #18).

Comment corrections

The green theme changed hex values by find-and-replace and left the English labels behind, so the file documented #1F9D3E as "Erigon Orange" in two places — the header and the /* Erigon Orange scale */ comment above the ramp. Both corrected to "Zilkworm Green", plus the Quantify wordmark role documented in the header.

⚠️ Spec divergence

The header comment now states plainly that docusaurus-design-spec.md still specifies orange site-wide and has not yet been amended (zilkworm-docs-spec.md:29, docusaurus-design-spec.md:233 — "always orange — brand convention").

The green was a deliberate product decision (#12, #16) and is being kept. But until erigon-documents records it, the code and the spec contradict each other, and any spec-compliance check will flag zilkworm's green as a violation. A follow-up PR to erigon-documents should ratify the exception.

Verification

  • tsc --noEmit and npm run build clean
  • Built CSS confirms --ifm-color-primary:#1f9d3e intact and text-rendering:optimizeLegibility applied
  • Built HTML confirms <meta name="theme-color" content="#1F9D3E">

🤖 Generated with Claude Code

bloxster and others added 2 commits August 3, 2026 15:51
The Erigon docs site gained a typography pass in erigontech/erigon
a9135af285 ("enforce brand font consistency") that never reached the
sibling sites, so headings here have rendered slightly looser and
anchor links land under the sticky navbar.

Ports that block verbatim: h1/h2 negative letter-spacing, the uppercase
h6 treatment, font smoothing, --ifm-heading-line-height 1.2, h2/h3 top
margins, and scroll-margin-top so heading anchors clear the navbar.

Palette-agnostic -- no color token is touched.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The terminal-green theme recolored the stylesheet but left the
theme-color meta tag at #EF7716. That tag tints the browser chrome on
mobile -- Chrome's address bar on Android, the status bar area on iOS --
so the mobile site rendered an Erigon-orange bar above an otherwise
green site.

Point it at #1F9D3E to match --ifm-color-primary.

This is the last unintentional orange in the site: every remaining
#EF7716 is the shared corporate footer, which stays orange by design.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bloxster
bloxster merged commit e1955f1 into main Aug 3, 2026
1 check passed
@bloxster
bloxster deleted the docs/align-typography-rhythm branch August 3, 2026 14:18
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