Skip to content

Build and preview

  1. Check content
    bash
    pnpm docs:check

    Checks config, frontmatter, code fences, internal links, static assets, routes, and translation gaps.

  2. Build the site
    bash
    pnpm docs:build

    Static files are written to .docfuse/dist/ by default.

  3. Preview production output
    bash
    pnpm docs:preview

    Check the home page, deep routes, 404 page, search, locales, versions, and static assets.

Run pnpm exec docfuse build --no-cache to rule out stale cache state. Run pnpm exec docfuse clean to delete generated output and build state.

Verify each capability

table
Markdown pluginPages show transformed math, diagrams, or HTML, with no browser console errors
Search providerSearch finds a new page, and /search/ or /pagefind/ assets are reachable
ExtensionSource and page changes are visible, and declared files exist under outputDir/extensions/{name}/
Project assetsImages, fonts, and downloads work from deep routes without 404 responses

When the build is ready, publish .docfuse/dist/ using the deployment guide.