Skip to content
@jordanlee
documentation

Customization

Colours & fonts

Change the entire look of the site by editing design tokens in one CSS file.

on this page

Design tokens

All colours are CSS custom properties defined in src/styles/global.css — one set for light, one for dark. Components only ever reference the tokens, so editing this block restyles the whole site.

src/styles/global.css
:root {
--background: #ffffff;
--surface: #f8f8f8;
--border: #cccccc;
--foreground: #111111;
--muted-foreground: #666666;
--code-bg: #f8f8f8;
--accent: var(--foreground);
}
.dark {
--background: #000000;
--surface: #111111;
--border: #333333;
--foreground: #f5f5f5;
--muted-foreground: #888888;
--code-bg: #0c0c0c;
--accent: var(--foreground);
}

The theme is monochrome by design, but --accent is there if you want a tint: set it to any colour and links, active states, and callout labels pick it up.

Prefer a softer dark mode? Change `--background` to `#0b0b0c` and `--surface` to `#141416`. Keep the contrast between `--foreground` and `--background` at 7:1 or better for body text.

Fonts

Two typefaces are self-hosted through Fontsource: Dela Gothic One for the display face and Space Grotesk (variable) for everything else. They are wired up in global.css:

@import '@fontsource/dela-gothic-one';
@import '@fontsource-variable/space-grotesk';
@theme inline {
--font-heading: 'Dela Gothic One', 'Arial Black', Impact, sans-serif;
--font-sans: 'Space Grotesk Variable', -apple-system, BlinkMacSystemFont, sans-serif;
--font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

To swap a face, install another Fontsource package, change the @import, and update the matching variable. Page titles use --font-heading; in-article headings deliberately use --font-sans at a heavier weight.

The starfield

The animated background is a single component, src/components/layout/Starfield.astro: a thousand points in a cube, rotated a little every frame and projected onto a full-screen <canvas>. It draws in the current --foreground colour at low opacity, follows the pointer slightly, pauses in hidden tabs, and holds one static frame for visitors who prefer reduced motion.

Set features.starfield: false to remove it entirely. To tune it, edit the constants at the top of the component’s script — COUNT (number of stars), POINT_SIZE, and the two rotation speeds in draw().

The halftone overlay

A very faint screentone (radial-gradient dots at 1.5% opacity) sits over the page. Disable it with features.halftone: false, or tune it in global.css under html[data-halftone] body::before.

Code blocks

Expressive Code themes and frame colours are set in astro.config.ts. The defaults use github-dark / github-light and map the frame to the same tokens as the rest of the site.

Tailwind

Styling uses Tailwind CSS 4 utilities with a handful of custom ones defined in global.css: container-page, container-wide, nav-link, chip, pill, and link-dotted. The tokens above are exposed as Tailwind colours (bg-surface, text-muted-foreground, border-border …) through the @theme inline block.