Skip to content

docs: brand styling — CipherStash code theme + Geist Sans headings#70

Merged
coderdan merged 3 commits into
v2from
docs/code-theme
Jul 15, 2026
Merged

docs: brand styling — CipherStash code theme + Geist Sans headings#70
coderdan merged 3 commits into
v2from
docs/code-theme

Conversation

@coderdan

@coderdan coderdan commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Two brand-styling changes to bring the docs in line with the marketing site. Independent and self-contained.

1. CipherStash code syntax theme

Replaces Shiki's default GitHub themes with two custom themes (light + dark) built from the CipherStash palette — code blocks stop looking like generic GitHub red/purple/blue.

Role Dark Light
Keyword lime #b7e64f #567d0d
Function teal #5ec8b8 #15776a
Type aqua #7fd0c4 #1c8577
String gold #d9b36a #946618
Number amber #e0a35c #9a5f18
Comment #6b6559 italic #8b8676
Text warm off-white #e7e2d4 near-black #2b2822

Anchored on the lime accent for keywords, with a tight harmonized set of warm/cool supporting hues (no rainbow), on warm near-black / off-white grounds. Shiki already runs in dual-theme mode, so this is purely a themes swap in rehypeCodeOptions (source.config.ts) — the copy button, line highlighting, diff/focus transformers, and Fira Code font are untouched.

Palette preview (with a GitHub before/after toggle): https://claude.ai/code/artifact/448cedef-0414-4c14-8435-330f9ea46fa4

2. Geist Sans headings

H2 and below now render in Geist Sans (loaded via next/font/google), matching the marketing site. H1 keeps its Fira Code monospace treatment. Body text and code are unchanged.

Verification

  • Full bun run build compiles with 0 errors.
  • Code blocks carry the CipherStash colors in both light and dark; GitHub's are gone.
  • The Geist variable is applied on <html> alongside Fira Code and Inter.

Best reviewed on the Vercel preview: check a few pages (SQL / TypeScript / bash / JSON) in both light and dark for the code theme, and eyeball the heading hierarchy (H1 mono vs H2+ sans).

https://claude.ai/code/session_01NkxKebM3qffTB7FayXsfxP

Replace Shiki's default GitHub themes with two custom themes (light + dark)
built from the site palette: the lime-green brand accent for keywords, warm
neutrals for text and comments, and teal / gold / amber supporting hues tuned
to the near-black and off-white grounds the docs already use.

Shiki already runs in dual-theme mode, so this is purely a themes swap in
rehypeCodeOptions — the copy button, line highlighting, diff/focus transformers,
and Fira Code font are unchanged, and every code block picks it up.
@vercel

vercel Bot commented Jul 15, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
public-docs Ready Ready Preview, Comment Jul 15, 2026 1:39am

Request Review

Match the marketing site: H2 and below now render in Geist Sans (loaded via
next/font/google), while H1 keeps its Fira Code monospace treatment. Body text
and code are unchanged.
@coderdan coderdan changed the title docs: brand the code syntax highlighting with a CipherStash theme docs: brand styling — CipherStash code theme + Geist Sans headings Jul 15, 2026
-0.02em reads too tight on the smaller Geist Sans headings; H2-H3 keep it.
@coderdan
coderdan merged commit 9a2bf64 into v2 Jul 15, 2026
1 of 2 checks passed
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