How this site is organised
One collection, three lenses — format, topic and tags — and never more than two levels deep.
Building thingsEverything on this site is a single kind of thing: an item. An item is a folder with an
index.md inside, plus whatever images belong to it:
src/content/items/
how-its-organised/
index.md ← this page
colour-studies/
index.md
study-1.svg
The folder name becomes the URL, /p/how-its-organised/. Moving an item between topics never
changes its address.
Three lenses
| Lens | Answers | Shape |
|---|---|---|
Format (type) |
How is it presented? | fixed list: article, note, video, gallery, software, tool |
| Topic | What is it about? | a tree, at most two levels |
| Tags | What else is it related to? | free-form, flat |
A series can additionally stitch a few items together in order — like the three parts of this one.
Why a two-level limit
Deep hierarchies feel organised when you create them and become mazes a year later. Two levels — Building things → Front-end — is enough to give shape without making anyone click through folders. The build refuses a third level on purpose.
Filtering
Explore lists everything and lets you combine one format, one topic and one tag. The filter state lives in the URL, so a filtered view is shareable: /explore?type=article&tag=meta.