Skip to content

feat(docs): custom mdBook theme with Zeph brand colors#759

Merged
bug-ops merged 2 commits intomainfrom
feat/mdbook-theme
Feb 23, 2026
Merged

feat(docs): custom mdBook theme with Zeph brand colors#759
bug-ops merged 2 commits intomainfrom
feat/mdbook-theme

Conversation

@bug-ops
Copy link
Owner

@bug-ops bug-ops commented Feb 23, 2026

Summary

  • Add custom CSS theme for mdBook documentation matching Zeph TUI color palette (navy+amber)
  • Override built-in navy theme CSS variables with brand colors from crates/zeph-tui/src/theme.rs
  • Add Z-letter favicon SVG and sidebar logo via inline data URI
  • Set navy as default theme for consistent branding
  • WCAG AA compliant contrast ratios on all text elements

Changes

  • docs/theme/custom.css — 25 CSS variable overrides + typography, code, blockquote, menu bar styles
  • docs/theme/favicon.svg — minimal Z-letter SVG (#142850 bg, #C8DCFF text)
  • docs/book.toml — default-theme changed to navy, additional-css configured

Test plan

  • Run mdbook build in docs/ — verify clean build
  • Open generated HTML — verify navy theme applied by default
  • Check sidebar logo, favicon, heading colors, code blocks, blockquotes
  • Verify search highlight contrast (mark element)

Override navy theme CSS variables with Zeph brand colors (navy+amber),
add Z-letter favicon SVG, sidebar logo via data URI, WCAG AA compliant
mark highlights, and set navy as default theme.
@github-actions github-actions bot added documentation Improvements or additions to documentation enhancement New feature or request size/M labels Feb 23, 2026
@bug-ops bug-ops enabled auto-merge (squash) February 23, 2026 02:31
@bug-ops bug-ops merged commit 9c31b5a into main Feb 23, 2026
35 checks passed
@bug-ops bug-ops deleted the feat/mdbook-theme branch February 23, 2026 02:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request size/M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant