Guide

SSG Style & Color Guidelines

This document describes the visual design tokens of the built-in themes. All text colors meet WCAG 2.2 AA contrast (≥4.5:1 for normal text) against their intended background (audit FE-002).

Principles

  • Accessibility first — WCAG 2.2 AA contrast for body and muted text.
  • System fonts — simple, krowy and imd use a native font stack (no external font CDN, no visitor IP leak to third parties; audit FE-003). apidoc and ssgtheme load their faces from Google Fonts (see Fonts).
  • CSS custom properties — every color/spacing token is a --var in :root, so a theme can be re-skinned by overriding variables.
  • Responsive & mobile-first — layouts use relative units and flexbox/grid.

Themes

apidoc — documentation, Google palette

Light and dark, Public Sans and JetBrains Mono. The tokens, every measured contrast ratio and the method label colours are in templates/apidoc/README.

ssgtheme — documentation sites

Light and dark (prefers-color-scheme, overridable with data-theme), Geist, Geist Mono and Instrument Serif. css/tokens.css holds every token with its measured contrast; the roles and ratios are listed in templates/ssgtheme/README.

krowy — light, natural green

Token Value Notes
--color-bg-primary #f8faf5 page background
--color-text-primary #1a2e1a body text
--color-text-secondary #3d5a3d secondary text
--color-accent #2d7d32 links/buttons
--color-text-muted #4a6b4a meta/dates — 5.72:1 on bg-primary (AA)
--font-family 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif system stack

simple — modern dark

Token Value Notes
--color-bg-card #222222 card background
--color-text-muted #9a9a9a meta/dates — 5.65:1 on card (AA)
--color-accent #6366f1 links/buttons; paired with light text on the accent as a button background
--font-family 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif system stack

imd — editorial

Token Value Notes
--font-main 'Manrope', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif system fallback
--font-head 'Space Grotesk', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif system fallback

Checking contrast

When changing a text color, verify it against its background:

  • Normal text (< 18.66px, or < 24px non-bold): ≥ 4.5:1
  • Large text (≥ 24px, or ≥ 18.66px bold): ≥ 3:1

Tools: WebAIM Contrast Checker or any WCAG contrast calculator. Accent colors used as links rely on additional non-color affordances (underline/hover); accent used as a button background must keep its label text at ≥ 4.5:1.

Fonts

simple, krowy and imd ship no bundled or CDN webfonts. The first family in each stack (Inter, Manrope, Space Grotesk) is used only if the visitor already has it installed; otherwise the browser falls back to the platform UI font. This keeps builds self-contained and privacy-respecting.

apidoc (Public Sans, JetBrains Mono) and ssgtheme (Geist, Geist Mono, Instrument Serif) load their faces from Google Fonts in the page <head>, with system fallbacks in each stack. A site that must not contact a third party self-hosts those files under static/ and replaces the <link> in the theme's head partial.