Justin Vollmer

A New Theme

Contents

If you’re reading this on the site itself, you’ve probably already noticed: things look different around here! After two years on my fork of the Bilberry Hugo Theme, I’ve moved to a theme of my own, currently called justinvollmer (creative, I know).

The Bilberry theme hasn’t been in active development for some time, and I wanted more control over the look and feel of the site without building on someone else’s work and reworking my changes every time I pulled in theirs. I also just spent a good chunk of time moving two other sites from bespoke WordPress designs to Hugo sites with custom themes, and it seemed worthwhile to do the same here.

What it looks like

The home page is now a log-style stream: a vertical timeline with month and year rules, and a small colored dot for each kind of entry, so posts, notes, and statuses are easy to tell apart at a glance. Photos are responsive (WebP, with the right size sent to your device), and statuses with photos get tidy crops or a grid in the stream, while the full photo is one click away.

The header sticks to the top as you scroll, and the page you’re on is marked with a little > prompt in the navigation.

For type, I switched to Atkinson Hyperlegible for everything, with the monospace variant used only for dates and code. It was designed by the Braille Institute for low-vision readers, so letters that usually look alike (like I, l, and 1, or O and 0) are easy to tell apart, which should make it comfortable to read for everyone else too. It’s also openly licensed, so the fonts are self-hosted.

Light and dark mode carried over, and by default the site follows your system setting, because that’s how I like things to work on my own devices. If you’d rather pick for yourself, there’s a toggle in the header.

What changed on the pages

  • On this day: the home page shows entries from earlier years that were posted on today’s date, with thumbnails where there are photos. It’s calculated in your browser, so it changes every day without me deploying anything.
  • Likes: statuses that I syndicate to Mastodon and Bluesky show a small ♥ count. Just the number, none of the names or replies.
  • Table of contents: on wide screens it now lives in the left margin as you read. On narrow screens it’s a collapsible block at the top of the post.
  • IndieWeb: I’m sticking with the POSSE approach (publish here first, then syndicate elsewhere), and the new theme keeps leaning into IndieWeb ideas, with the microformats (h-card, h-entry) cleaned up as part of the move.

Under the hood

The theme is plain CSS and a few small scripts, and now lives in the site’s repo instead of as a submodule. Other than GoatCounter, which I’ve used for analytics since 2020, nothing on the site makes requests to a third party.

I also added a couple of automated guardrails, since I’d like the site to keep working without me babysitting it:

  • A monthly check for broken external links, which opens an issue if anything is actually dead
  • A monthly pull request that updates Hugo and the build tooling, which gets checked against a build of the current site before I merge it

Notes

Posts, statuses, and pages all kept their URLs, and I compared the built output of the old and new versions to make sure. The feeds keep the same items and IDs, so they shouldn’t reappear as new in your feed reader, though some older entries changed slightly and a few readers may show them as updated.

If you come across something that looks broken, please let me know!

Here’s to this theme outlasting the last one (a low bar, I know… two years)! 🎉