ftsfn dev

writing posts

where a post goes, its frontmatter, and what the build checks

where it goes

a post is content/blog/<category>/<slug>.mdx and lands at /<category>/<slug>, the folder is the category, there is no category field. one level of folder only, a deeper file fails the build rather than going live at a url nothing links to

a category gets a nicer label and a blurb by adding it to categories in lib/blog.ts, an unlisted folder still works and just shows its slug with the dashes taken out

some names are taken by routes and fail the build as a category, docs api og page series tags rss.xml sitemap.xml and the llms files, and a post cant be called page

frontmatter

---
title: the title              # required
description: one line blurb   # shows on the card, the og image and the feed
date: 2026-10-06              # required, a bad date fails the build
updated: 2026-10-08           # optional, shows under the meta line and in the sitemap
author: Finn Le Var           # optional, this is the default
tags: [lua, c api]            # optional, any spelling, the url is the slugified form
image: /img/cover.png         # optional, replaces the generated og card
draft: true                   # optional, only shows under npm run dev
series: lua-bindings          # optional, needs part too
part: 2                       # the posts place in the series
---

drafts

draft: true shows the post under npm run dev with a draft badge, a production build leaves it out of every list, route, tag, series, search index, og image, sitemap and the rss feed, so pushing a draft is safe

series

every post with the same series slug is one series, ordered by part rather than date. each part shows a box listing the others, and /series/<slug> lists them all. a label and blurb go in series_labels in lib/blog.ts

the rest

  • tags each get a page at /tags/<tag>, and /tags lists them all
  • the front page and each category page 10 posts at a time, page_size in lib/blog.ts
  • the feed is /rss.xml, the newest 20 posts
  • relative links between .mdx files work, [the other post](../notes/other.mdx)

On this page