Getting started
Add a page, link it from the sidebar, and ship it.
This guide walks you through the three things you'll do most often.
The dev server runs at http://localhost:5176. Start it with
bun --filter @konvoai/docs dev.
Create an MDX file
Every file under content/docs/ becomes a page. The filename (minus .mdx)
becomes the URL slug.
---
title: Billing
description: How invoices, proration, and refunds work.
---
Content goes here.Control the sidebar
Add a meta.json next to your pages to set the title and order. Anything you
don't list still appears, just in filesystem order.
{
"title": "Documentation",
"pages": ["index", "getting-started", "billing", "components"]
}Write rich content
You get all the standard markdown features, plus Fumadocs components like
<Callout>, <Tabs>, <Steps>, <Cards>, and more — already registered
globally, no imports needed.
<Callout type="warn">Be careful with this one.</Callout>
<Tabs items={["bun", "npm"]}>
<Tab value="bun">`bun install`</Tab>
<Tab value="npm">`npm install`</Tab>
</Tabs>Build & deploy
bun --filter @konvoai/docs build
bun --filter @konvoai/docs deployThe build outputs a fully static site to build/client/. The deploy step pushes
those static assets to Cloudflare Workers — no runtime server required.
You're done. Run the dev server and start writing.