Read more notes

← All journals
July 31, 2026

Start here

This is a placeholder — replace or delete it once you’ve written your first real entry.

To add one: create a new .md file in src/content/journal/. The filename becomes the URL (src/content/journal/foo-bar.md → /journal/foo-bar/).

The basics

Every entry needs a title, a date, and a list of tags. Everything else is optional.

---
title: "Your title"
date: 2026-08-01
tags: ["software engineering", "meaning"]
summary: "One line, shown on cards and previews."
draft: false
pinned: false
---

Set pinned: true to lift an entry onto the shelf at the top of the home page. Pinned entries are left out of the list below it, so nothing shows up twice — five at most. Set draft: true to keep a piece out of the build without deleting it.

New tags don’t need to be registered anywhere — the tag filter rebuilds itself from whatever tags exist across your entries.

Three shapes an entry can take

format decides how an entry is presented. Leave it out and you get a plain note.

A note with a wide picture. Add hero and the image breaks out past the reading column:

format: note
hero: "/images/hero-placeholder.svg"
heroAlt: "Describe the picture"
heroCaption: "Shown small and centred under the image"

A reel. A 9:16 video in the same frame a YouTube Short is cut to. Open one and you can scroll vertically through every other reel:

format: reel
video: "/videos/your-clip.mp4"
poster: "/images/your-frame.jpg"

A carousel. Up to five cards, swiped left to right, numbered so people know to keep going:

format: carousel
slideAspect: "4:5" # or "1:1"
slides:

- src: "/images/slide-1.svg"
  overlay: "Bold words, burned onto the card"
  caption: "A longer line under the frame"

Pictures and videos live in public/ and are referenced from the site root: a file at public/images/x.jpg is written as /images/x.jpg.

The rest

Tags colour themselves, and the colour comes from the tag’s name, so it stays the same everywhere it appears. To pin a specific tag to a specific colour, edit TAG_HUE_OVERRIDES in src/lib/format.ts.

The header text, the quote, your avatar, the Kit subscribe URL, and how many entries fit on a page all live in src/lib/site.ts.