Chatblocks Docs

Public documentation at https://docs.chatblocks.ai. Built with Mintlify.

Local dev

pnpm --filter @chatblocks/docs dev

Opens at http://localhost:3000.

Regenerating the MCP tool reference

The page at mcp/tool-reference.mdx is auto-generated from the MCP server's tool registrations at apps/web/src/lib/mcp/server.ts.

pnpm --filter @chatblocks/docs gen

CI runs pnpm --filter @chatblocks/docs gen:check, which re-runs the generator and diffs the output against the committed file. If they differ, CI fails.

Edit anywhere else; the generated file gets rewritten on every gen run.

Validating

pnpm --filter @chatblocks/docs validate     # strict — exits on warnings/errors
pnpm --filter @chatblocks/docs broken-links # link check

Deploy

Mintlify auto-deploys from apps/docs in the private monorepo on push to main once the GitHub app is connected (one-time setup at https://dashboard.mintlify.com). Config lives in docs.json. Custom domain (docs.chatblocks.ai) is configured in the Mintlify dashboard.

Public mirror

The public docs repository is generated from this directory for Context7 and agent-platform reviewers. It is not the source of truth. See docs/public-docs-mirror.md at the private monorepo root for setup details.