Blog and feeds
src/content/blog/ holds Markdown posts. features.blog, on by default, builds
/blog/, one page per post and /blog/rss.xml.
Write a post
Section titled “Write a post”---title: Why we started this directorydescription: The gap we kept running into.pubDate: 2026-09-14tags: [editorial]draft: false---The body is Markdown.The file name is the URL: my-first-post.md becomes /blog/my-first-post/. Keep posts at the folder’s top level.
| Field | What it does |
|---|---|
title |
required; the heading and <title> (seo.templates.blog.title, then titleTemplate) |
description |
required; the sub-heading line, the meta description, the feed item text |
pubDate |
required; the date shown, newest first |
updatedDate |
Updated when the day differs; article:modified_time, which the sitemap reads as lastmod |
cover |
a path or URL, rendered at 1200×630 as the og:image; not validated |
tags |
default []; chips, no pages behind them |
draft |
default false; hides the post |
Replace the demo posts:
pnpm content:reset --yesIt deletes the demo listings from the local database (--remote for the real one) and their logos from the bucket, then every .md in src/content/blog/ except unpublished-draft.md, writes hello-world.md, logs
blog: kept src/content/blog/unpublished-draft.md (starter fixture, draft: true — delete it if you do not want it).
The reverse is pnpm content:use <dataset> --yes.
Verify
Section titled “Verify”| Where | You should see | |
|---|---|---|
| Index | /blog/ |
your posts newest first and the RSS feed button |
| Post | /blog/<file name>/ |
the title, description, date, tags and body |
| Blog feed | /blog/rss.xml |
<title><site name> Blog</title>, one <item> per published post, every link starting with site.url |
| Listings feed | /rss.xml |
<title><site name></title> and at most 50 items |
| Sitemap chunk | /sitemap-blog-0.xml |
one <url> per post plus /blog/, <priority>0.5</priority>; the build log reads sitemap: N urls in M chunks (listings=…, blog=…) |


Worth knowing
Section titled “Worth knowing”- Feed item links are absolute against
site.url: both feeds point at the wrong domain until it is yours. /rss.xmlis always built — the newest 50 listings byapprovedAt;/blog/rss.xmlfollowsfeatures.blogand has no limit.- The demo posts name real products — Grammarly, LanguageTool, DeepL Write — and are not licensed as your own editorial; replace them before going live.
- Posts are not in the site search,
/blog/has no pagination or tag pages, and an empty folder showsNo posts yet — check back soon. /robots.txtpoints at/sitemap-index.xml, which listssitemap-blog-0.xml; the feeds are files, not pages, and appear in neither. See Sitemap and robots.
When it is off or degraded
Section titled “When it is off or degraded”| Config state | The visitor sees | /admin/ reports |
Fix |
|---|---|---|---|
features.blog: false |
no Blog nav item; /blog/, the post pages and /blog/rss.xml are not built and 404 once deployed; /rss.xml is unaffected |
nothing | set it back to true |
A post with draft: true |
not built, not on /blog/, not in the feed; Draft badge under pnpm dev |
nothing | draft: false, or delete the line |
A post missing title, description or pubDate |
no site: the build stops, **blog → <file>** data does not match collection schema., naming the field |
nothing | add the field |
| A post in a subfolder | no site: the build stops, paths: invalid path segment "<id>" |
nothing | move the file to the top level |
Configuration
Section titled “Configuration”features.blog, seo.templates.blog.title, seo.templates.blog.description (unused today — the index and every post pass their own), site.locale and site.url — features, seo, site.
Directory
src/content/blog/— the posts;unpublished-draft.mdis the draft fixture- …
src/content/schema.ts—blogSchema, the frontmatter rules aboveDirectory
src/pages/blog/—/blog/,/blog/<slug>/and/blog/rss.xml- …
src/pages/rss.xml.ts— the listings feed and its item limitsrc/templates/BlogIndexPage.astro— the indexsrc/templates/BlogPostPage.astro— one postDirectory
src/components/blog/— the post card, the meta line andgetPublishedPosts()- …
integrations/sitemap.ts— the chunked sitemap and its build log line