Projects / This website

This website

A small static site that tries to explain itself: where it came from, what serves it, and which parts of the picture are documented and which are not.

How a page reaches you

1 · Build

Astro

Pages are generated ahead of time into plain HTML, CSS and a little JavaScript.

2 · Reach

Cloudflare Tunnel

The lab connects out to Cloudflare, so no inbound router port is needed.

3 · Serve

Nginx

Hands the right static file back. No database, no application server.

The path Cloudflare Tunnel → Nginx → static files is the documented public website path. Follow a request through it.

Where it started

The first version was an Eleventy project. Posts were written in Markdown, which Eleventy turned into HTML inside a base layout, and a deployment script pushed the generated dist/ folder to an LXC container. The first Markdown post explains why that was appealing: plain text to write, instant builds.

Recovering it

At some point only the published HTML remained: no Eleventy source, no Git history. The recovery note covers the method: snapshot the production directory, hash every file, rebuild as a separate project, compare, and commit the matching output before touching the design. All 20 deployed files matched byte for byte.

The redesign

This version was built separately from the recovered baseline, so the live site was never the thing being experimented on. The design question was how to show that hardware, services, projects, writing and lessons are all connected without making a visitor learn an interface first. The answer was the layered map, with a plain list behind it for anyone who prefers text.

Decisions

  • Static, and boring on purpose. Nothing to patch, nothing to log into, nothing that can fail at request time.
  • Documented, not live. The diagrams describe architecture. No page here reports live CPU, memory or uptime, because none of it is measured.
  • Gaps stay visible. Where the documentation doesn’t say which machine runs a service, the diagram shows it unattached rather than guessing.
  • Old links keep working. URLs from the previous site redirect to their new homes, and the feed is still at /feed.xml.
  • One source of truth. Projects, articles, lessons and technologies live in structured data, and the map, indexes and related links all derive from it. The map’s data is validated at build time, so a collision or a broken link fails the build instead of shipping.

What it taught

Take a baseline before changing anything you only have the output of. More on that lesson.

Related writing

What it taught

  • Baseline firstTwenty published files were rebuilt byte for byte before any design change.