Content Model
Define how files map to routes and how metadata is derived.
Mental model
All published content is read from app/content/posts/.
Route paths come from relative file paths, segment by segment.
Do this
Use these rules when creating content:
index.mdmaps to/.- Other markdown files map from folder path + filename.
- Folder notes use matching names (for example
Documentation/Documentation.md).
Route examples:
Documentation/Quickstart.md->/documentation/quickstartLocations/Locations.md->/locations(folder note de-duplication)index.md->/
Optional frontmatter:
---
title: My Page
publishedAt: 2026-03-05
summary: Short summary
image: /images/cover.png
category: Optional Category
published: true
---
Verify
- Create or edit a page under
app/content/posts/. - Run
npm run dev. - Confirm expected route path and page title.
- Run
npm run testto catch route collisions and ambiguous bare links.
Notes
titleandsummaryare auto-derived if omitted.publishedAtdefaults to file modified date.publisheddefaults totrue.- Use path-qualified links (
[Folder/Page](/folder/page)) when names are duplicated.