Welcome to the starter

This is a sample post from the blog content collection. It exists so the collection, the index page, the detail route, the RSS feed and the sitemap all have something real to render. Delete this file and the others alongside it once you have your own content.

What to change first

Everything about this specific site lives in four files under src/config/:

• site.ts — name, URL, description, author, socials, analytics ID
• theme.ts — colours, corner rounding, motion, layout widths
• fonts.ts — the three typefaces
• nav.ts — header and footer links

Nothing else in the codebase hard-codes any of that, so a new project is mostly a matter of working through those four files. docs/01-new-project.md has the full checklist.

Writing posts

Frontmatter is validated against the schema in src/content.config.ts. A missing description or a malformed pubDate fails the build rather than producing a broken page — which is what you want, especially once a CMS is writing these files.

Both .md and .mdx work. Reach for MDX when a post needs to import and use a component; plain Markdown is faster to build and perfectly sufficient otherwise.

Set draft: true in frontmatter to keep a post out of the built site while you work on it.