← Back to notes
permanent/budding

An Astro site is a small system

I am treating this Astro site as a small system rather than a collection of pages. The visible pages matter, but they are the surface. Underneath them are a content model, a set of routes, a publishing rhythm, and a few decisions about what should stay simple.

The content collections give the system its vocabulary. A log entry records a moment. A note gives a useful idea enough room to develop. An article makes a longer argument and names the sources that shaped it. A map helps a reader move between those pieces without needing to understand the folder structure first.

That separation is practical. It lets me choose the right size for a thought instead of forcing every idea to become an article. It also makes the site easier to maintain, because the schema describes what each type is for while the pages focus on making the content readable.

The next test is whether the structure continues to help after the novelty of setup wears off. If adding a piece of writing feels heavier than writing the piece, the system needs to become simpler.