A small website is a feature, not a compromise
When the job is publishing words, fewer moving parts can make the whole system easier to trust.
Demo article · written for this development preview, not author-approved.
A publication has a simple promise: a reader follows a link and finds something worth reading. Every extra system between those two events needs to justify its place.
This demonstration article explores a small architecture for that job. It is not an account of the author’s own project history.
Start with the thing you need to deliver
An article is mostly HTML. It needs a title, readable paragraphs, a stable URL, and perhaps an image or a code sample. Serving that document does not inherently require a database query on every visit.
A static build moves work to publication time. Markdown becomes HTML once; a CDN can then serve the result many times. That trade is attractive when reads are frequent and edits are occasional.
Simpler does not mean careless
The build becomes the boundary where mistakes should be caught. A missing image should fail loudly. Drafts should stay private. A future publication date should have an explicit timezone.
Useful rules are small enough to explain:
- Keep one source of truth for publication eligibility.
- Validate metadata before generating public routes.
- Copy only the media needed by eligible content.
- Make a failed build leave the last good deployment intact.
These are operational features, even if they do not appear in a screenshot.
Know the trade-off
A static site does not wake up at midnight to publish a scheduled post. Something needs to trigger another build. It also cannot erase a page that someone has already saved.
Documenting those limits is more useful than hiding them behind a button marked “Publish.” A small system is strongest when its boundaries are visible.
A useful first question
Before adding a service, ask: can this be a file, a build step, or an existing platform feature? Sometimes the answer is no. Often it saves a surprising amount of maintenance.