Themes

This site ships with four designs. Switch between them with the ✦ theme button in the header of any page, or via a shareable URL param — your choice is remembered in localStorage.

The param works on any page, so you can link directly to a post in a specific skin, e.g. /posts/rag/?design=ide.

Use them on your own blog

github.com/alexjacobs08/papermod-themes — each design is a drop-in theme for Hugo blogs running PaperModX (and mostly stock PaperMod — see the notes). Star it if you use one.

No theme surgery required: PaperMod(X) concatenates anything in assets/css/extended/ after its own styles, and site-level layouts/ partials override the theme’s. Pick a design, copy its files into your site, rebuild.

The three designs also live as branches of this blog’s repo (redesign/claude-code, redesign/geist-minimal, redesign/tokyo-night-ide) if you want to see them in a real working site.

agent session — redesign/claude-code

1assets/css/extended/custom.css        # the whole design
2assets/css/lib/chroma-dark.css        # warm gruvbox-style syntax (dark)
3assets/css/lib/chroma-light.css       # warm light syntax
4layouts/partials/home_info.html       # welcome-session home hero
5layouts/_default/list.html            # post list as tool calls
6layouts/_default/single.html          # posts as terminal windows
7layouts/partials/footer.html          # composer footer

Browse the files: github.com/alexjacobs08/dev-blog/tree/redesign/claude-code

docs minimal — redesign/geist-minimal

1assets/css/extended/custom.css        # the whole design
2assets/css/lib/chroma-dark.css        # GitHub dark syntax
3assets/css/lib/chroma-light.css       # GitHub light syntax
4layouts/partials/home_info.html       # minimal hero
5layouts/_default/list.html            # post index as hairline rows
6layouts/partials/footer.html          # minimal footer

Browse the files: github.com/alexjacobs08/dev-blog/tree/redesign/geist-minimal

the editor — redesign/tokyo-night-ide

1assets/css/extended/custom.css        # the whole design
2assets/css/lib/chroma-dark.css        # Tokyo Night syntax
3assets/css/lib/chroma-light.css       # Tokyo Night Light syntax
4layouts/partials/home_info.html       # welcome.md editor hero
5layouts/_default/list.html            # posts as a file-explorer tree
6layouts/partials/footer.html          # VS Code status bar

Browse the files: github.com/alexjacobs08/dev-blog/tree/redesign/tokyo-night-ide

Notes for PaperMod(X) users

• Syntax themes are class-based chroma, so keep pygmentsUseClasses: true (or markup.highlight.noClasses: false) in your config. The palettes drop into assets/css/lib/chroma-{dark,light}.css, which PaperModX’s highlight.scss imports automatically.
• defaultTheme: dark pairs best with agent session and the editor; docs minimal is built for auto.
• Everything degrades gracefully: no JS required, and the stock features (search, ToC, archives, tags, covers) keep working.
• If you use a design, a link back to alex-jacobs.com somewhere on your site is appreciated.