← Blog
Guides1 min read

How this blog works

File-based MDX posts with categories and RSS. Write a Markdown file, commit, done.

This blog ships with the kit and works the way a starter blog should: no database, no CMS, no external service. Every post is a file in content/blog/, and publishing is a git commit.

Writing a post

Create an .mdx file in content/blog/. The filename becomes the URL slug, and the frontmatter carries the metadata:

---
title: "My first post"
description: "One sentence that shows up in the index, in search results and in the RSS feed."
date: "2026-08-01"
category: "Product"
---

Your content here. Markdown works, GFM tables work, and since these are
MDX files you can also import and render React components.

That is the whole workflow. Reading time is computed for you, and posts are sorted newest first.

Categories

Categories are free-form strings: use one per post and the kit builds the category pages automatically at /blog/category/[slug]. Keep the set small; two or three categories are plenty for most products.

Drafts

Add draft: true to the frontmatter and the post disappears from the index, the category pages, the RSS feed and the sitemap. It still renders at its direct URL in development, so you can preview it.

RSS

The feed lives at /blog/rss.xml and is generated from the same frontmatter. Point your readers there, or plug it into your newsletter tool of choice.