Blog

Overview

Blog content is managed using Fumadocs and stored in web/next/content/blog/.

Content Structure

• Location: web/next/content/blog/
• Format: MDX files with frontmatter
• Configuration: Defined in web/next/source.config.ts

Creating a Blog Post

1. Create a new .mdx file in web/next/content/blog/
2. Add frontmatter with title and description
3. Write content using MDX syntax
4. Add entry to web/next/content/blog/meta.json

Images for a post are committed as static assets under web/next/public/blog/<slug>/images/ and referenced by absolute path, e.g. ![Diagram](/blog/<slug>/images/diagram.svg).

Configuration

Blog source is configured in web/next/source.config.ts:

export const blog = defineDocs({
  dir: "content/blog",
  docs: {
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
})

Pages are listed in web/next/content/blog/meta.json. The sequence matters - it determines the order pages appear in navigation:

{
  "pages": ["index", "mcp-per-workspace", "a-biography-written-in-code", "web-development-2026"]
}