How this website fits together

I wanted a durable home for the things I'm learning and collecting. Social posts are useful for sharing an idea, but I also wanted somewhere those ideas could sit together and remain easy to find.

That's the job of this website. There are essays for longer thoughts, project pages for things I'm building, a bookshelf for reading, and a Now page for a current snapshot.

Start with the content

Most of the site's collections come from structured records: a book has an author and reading notes; a project has a description, its current question and a next step. The site turns those records into pages.

That matters because it gives the same information more than one useful home. A project can appear on the homepage, in the projects collection, and on its own page without rewriting its description three times.

Keep publishing straightforward

The public site is built with Astro and hosted on GitHub Pages. A release builds the pages, checks them, and publishes the tested output. Visitors receive ordinary web pages they can read, link to and share.

There is also a search index and a public data API. Those help people and tools find individual entries across the collections.

The harder part is deciding what to show

Adding another collection is easier than explaining why a stranger should explore it. A page full of interesting things still needs a starting point.

The homepage now introduces the monthly update and surfaces current work. Project pages explain what something is, why it exists and what comes next. The rest of the archive is there for anyone who wants to explore further.

A useful pattern for your own project

Give each project a short answer to four questions:

1. What are you making?
2. Why does it matter to you?
3. What can someone see or use today?
4. What is the next step?

Then add dated notes as the answers change. The questions give the project a shape; the notes give people something to return for.

Explore the website's project page →