Settlers Journal
A development journal for a Settlers of Catan web application, published as a searchable static site with Astro and Pagefind.

Building in the Open, One Session at a Time
One Entry per Session
Every work session on the Catan app ends with an entry: a TLDR, the main work, challenges, learnings, and screenshots or code.
Search Every Entry
Pagefind indexes the built site, so full text search runs in the browser with no search server.
Browse by Topic
Tags group entries by subsystem and tool, from java and postgres to react and svg.
At a Glance
From Work Session to Searchable Page
- EntryMarkdown Template
- Astro BuildAstroPaper Theme
- PagefindIndexes the Built Pages
- NGINXStatic Files over HTTPS
Built with
Key takeawayWriting an entry right after a session is easy. Reconstructing why a decision was made days later is not, so the fixed template matters more than any feature of the site.
Build Notes
Challenges, learnings, and what's next
Challenges
- Maintaining consistent journal entries alongside active development requires discipline and time.
- Pagefind requires a completed
dist/directory before it can index anything, so search does not work on the dev server.
Learnings
- Pagefind integrates cleanly into an Astro site with no server-side infrastructure, and the default search UI requires no customization.
- AstroPaper covers most of what a development journal needs out of the box: dark mode, RSS feed, tag filtering, OG image generation, and pagination.
- Writing entries close to each development session is significantly easier than reconstructing decisions days later.
Next
- Add a stats or summary page showing total entry count, most-used tags, and development activity over time.
- Cross-reference related journal entries by linking between sessions that cover the same feature or subsystem.
- Automate parts of the entry creation process, such as pre-populating the date and linking to relevant commits.
- Explore RAG systems that could answer questions about previous design choices or jog my memory.
- Review past journal entries and use them to improve the development workflow.
More Apps

Scratch
A platform for deploying and browsing experimental web apps. Each web app is a collection of static files and an optional backing API implemented in Python.

DuckDB WASM Demo
A full SQL database running inside your browser tab. Walk through a small analysis, then write your own queries.

Cooking Recipes
Recipes without the ads, life stories, or popups. Built for cooking from a phone.


