Skip to content

Update: apply CorvidLabs design system to the docs#420

Closed
0xLeif wants to merge 1 commit into
mainfrom
brand/theme-docs
Closed

Update: apply CorvidLabs design system to the docs#420
0xLeif wants to merge 1 commit into
mainfrom
brand/theme-docs

Conversation

@0xLeif

@0xLeif 0xLeif commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Brings the fledge site's docs and shared chrome onto the CorvidLabs design-system standard, with working light + dark mode. Marketing-landing polish was kept light per the plan (the landing is moving to the corvidlabs-site hub separately) β€” but its off-brand colors were still removed so nothing ships purple/orange.

  • Vendored the standard into site/public/brand/ via podo-designs/sync-to.sh (tokens.css, theme.js, theme-toggle.html, crow head mark + reversed, mascot, theme-adaptive favicon, VERSION β€” design-system v1.1.0).
  • Tokens: import brand/tokens.css globally in BaseLayout's <head>. globals.css bridges the site's legacy CSS vars (--bg, --text, --accent, …) onto brand tokens so every component themes for free; remaining hardcoded colors were replaced directly.
  • Fonts: Schibsted Grotesk (display/body) + Spline Sans Mono (code/labels) via Google Fonts.
  • Light + dark: honors prefers-color-scheme (tokens.css) and adds the standard sun/moon toggle in the header (desktop + mobile menu) with the pre-paint no-flash snippet and brand/theme.js. Never a "THEME" text button.
  • Logo + favicon: crow head mark inlined with currentColor in the header (themes with the page); favicon set to /brand/favicon.svg (theme-adaptive head mark).
  • Code highlighting: switched Shiki to the css-variables theme and mapped --astro-code-token-* onto the brand --code-keyword/string/number/function/comment tokens β€” on-brand in both modes, no GitHub-dark defaults.
  • No purple / no orange: the purple tutorial tag and orange accent are gone; category/tier tags use the brand --chart-1..5 palette, callouts/terminal dots use --danger/--warning/--success, decorative orange glows neutralized.
  • Square corners throughout (--radius: 0), focus-visible, prefers-reduced-motion, WCAG AA in both modes, responsive (mobile drawer + horizontal-scroll code/tables preserved).

Test Plan

  • bun run build passes (80 pages)
  • Built dist grepped clean of off-brand colors (no #ea580c, #c084fc, rgba(234,88,12), …)
  • Headless-Chrome screenshots of docs home, a content page (pillars), code-heavy (quick-start), and code+data (cli-reference) β€” plus plugins index and landing β€” in light and dark at 1440 and 500 wide; reviewed each:
    • No purple, no invisible/low-contrast text in either mode
    • Dual-mode verified: ?theme= toggle override + prefers-color-scheme default (no forced data-theme on <html>)
    • Code syntax shows distinct on-brand tokens (keyword teal / string green / number amber / comment muted)
    • Crow head mark + theme toggle present in header (desktop and mobile menu); brand favicon wired
    • Mobile (500px) layout intact β€” header, breadcrumb, "on this page" drawer, horizontally-scrolling code/tables

Note: site/src/data/plugins.json is regenerated by the prebuild step; it was reverted to keep this PR scoped to theming. No redirects added (separate step).

πŸ€– Generated with Claude Code

Vendor the brand standard into site/public/brand (tokens.css, theme.js,
crow head mark + favicon) and rebuild the docs and shared chrome on the
brand tokens with working light + dark.

- Import tokens.css globally + Schibsted Grotesk / Spline Sans Mono fonts
- Bridge legacy CSS vars onto brand tokens so components theme for free
- Light + dark: honor prefers-color-scheme + add the standard sun/moon
  header toggle (pre-paint snippet, theme.js, no-flash)
- Crow head mark in the header (inline, currentColor) + brand favicon
- Map Shiki onto the css-variables theme β†’ brand --code-* tokens
- Replace all off-brand colors (orange accent, purple tag) with brand
  semantic + chart tokens; square corners throughout

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@0xLeif 0xLeif requested a review from a team as a code owner June 12, 2026 22:06
@0xLeif 0xLeif requested review from 0xGaspar, Kyntrin and tofu-ux June 12, 2026 22:06
@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

βœ… Corvin says...

      _
    <(^\  .oO(Caw! ^v^)
     |/(\
      \(\\
      " "\\

"That's a nice looking export you've got there."

CI Summary

Check Status
Dependency Audit βœ… Passed
Integration (3 OS) βœ… Passed
Lint (fmt + clippy) βœ… Passed
Spec Validation βœ… Passed
Tests (3 OS) βœ… Passed

Powered by corvid-pet

@0xLeif

0xLeif commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

Superseded by the single-site consolidation: docs are migrating into corvidlabs-site (the only site updated going forward); this site will be redirected/retired. Closing per the new strategy.

@0xLeif 0xLeif closed this Jun 12, 2026
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