Fumadocs collections (blog + changelog)

• The /docs site (this site, at docs.vibestrap.dev) is on Mintlify. It lives under docs/ and docs/docs.json at the repo root. Setup walkthrough: Deploy docs on Mintlify.
• The /blog and /changelog routes on the marketing app are on Fumadocs. Their MDX lives under content/blog/ and content/changelog/. This page covers those two.

​

How the collections are defined

export const blog = defineCollections({
  type: 'doc',
  dir: 'content/blog',
  schema: frontmatterSchema.extend({ /* date, author, categories, … */ }),
});

export const changelog = defineCollections({
  type: 'doc',
  dir: 'content/changelog',
  schema: frontmatterSchema.extend({ version: z.string(), date: ... }),
});

export const pages = defineCollections({
  type: 'doc',
  dir: 'content/pages',
  schema: frontmatterSchema,
});

​

Add a new blog post

---
title: Welcome to Vibestrap
description: One-line summary.
date: 2026-04-27
author: Vibestrap
categories: [release, indie-hacking]
---

​

Add a changelog entry

---
title: v1.1 — credit packs
description: Small but mighty.
version: 1.1.0
date: 2026-05-15
---

​

The pages collection

​

Customize MDX components

export function getMDXComponents(components?: MDXComponents): MDXComponents {
  return {
    Callout: ({ children }) => <div className="callout">{children}</div>,
    ...components,
  };
}

​

Verify it works

pnpm exec fumadocs-mdx   # regenerate .source/
pnpm dev                 # visit your new post
pnpm build               # catches any frontmatter schema errors

​

Common pitfalls

1. Forgetting to regenerate .source/ — if you add a file and the page 404s in dev, run pnpm exec fumadocs-mdx.
2. Invalid frontmatter — Zod rejects unknown shapes. Date must parse, version is required for changelog, published: false hides blog posts.
3. MDX autolinks — writing <https://example.com> breaks the MDX parser. Use [example.com](https://example.com) or bare URL text.
4. Wrong collection dir — files outside the configured dir are silently ignored. Double-check the path matches source.config.ts.
5. Don’t put docs here — anything you’d want under /docs belongs in docs/ at the repo root (Mintlify), not content/docs/.

​

Official docs

• fumadocs.vercel.app — Fumadocs reference
• Fumadocs MDX — collection config
• MDX — Markdown + JSX syntax
• Zod — frontmatter schema syntax