Build Output

Running npx vite build produces a dist/ directory with everything needed to serve your docs site.

Normal build directory structure

123456dist/
├── rsc/
│   ├── index.js          # server entry
│   └── ...
├── client/               # browser assets, CSS, JS, public files
└── holocron-cache.json   # Navigation cache for fast rebuilds

Cache for fast rebuilds

dist/holocron-cache.json contains the enriched navigation tree with git SHA hashes for each page. On subsequent builds, pages with unchanged SHAs are reused without re-parsing. Caching dist/ between CI runs gives near-instant rebuilds.

Static assets

Fonts, processed images, and bundled JavaScript are placed in the client output. These are fingerprinted with content hashes for long-term caching.

Deploy build output

The holocron deploy CLI builds to dist/.holocron/ before upload. It uploads dist/.holocron/rsc as Worker files and dist/.holocron/client as static assets.

Self-contained output

The production output is self-contained. Navigation, frontmatter, image metadata, and cache data are prepared at build time. Page requests still parse and render the MDX source at runtime through React Server Components.

Ask AI about this page