Colors and Fonts

Brand colours and fonts live in one file, src/config/theme.json, using the same keys as Astroplate, so Sitepins CMS can edit them. It is read at build time; there is no generator to run.

Key Used for (Tailwind token)
colors.theme_color.primary brand orange: bg-brand, text-brand, glows, loader, cursor
colors.theme_color.primary_soft soft tint of the brand colour in gradient rings and the footer glow (brand-soft)
colors.theme_color.body page background (surface), also the browser theme-color
colors.theme_color.dark deepest background (surface-deep)
colors.theme_color.light raised surface, cards (surface-dark)
colors.text_color.default main text and hairlines (light, with opacity steps like text-light/70)
colors.text_color.light bright text and the eyes (snow)
colors.text_color.white warm white (pure)
fonts.font_family.primary body and headings (font-sans), e.g. "Manrope:wght@200..800"
fonts.font_family.secondary labels and eyebrows (font-mono), e.g. "Geist Mono:wght@400;500"
fonts.font_family.*_type fallback family: sans-serif, serif or monospace

How it is wired:

  • src/lib/utils/theme.ts parses theme.json.
  • src/layouts/base.astro writes the colours as --theme-* CSS variables, and src/styles/variables.css points the --color-* tokens at them. Opacity steps (/70, /8…) and tints use color-mix(), so changing one hex recolours the whole site.
  • astro.config.ts takes the font names and weights from theme.json, and the Astro Fonts API downloads and self-hosts them from Google Fonts at build time. Font names are Google Fonts family names; weights are 400;500 (single weights) or 200..800 (a variable range). The kinetic hero headline animates the weight between 600 and 800, so keep a variable font that covers that range for primary.

Sitepins reads .sitepins/config.json (content in src/content, media in src/assets/images, configs in src/config) and public/.well-known/sitepins.json.

Improve this page on Github  — Last updated:  Wed, Nov 18, 2026