> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Build Output
description: What vite build produces and how to serve it.
icon: folder-output
---

# Build Output

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

## Normal build directory structure

```diagram
dist/
├── 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.


---

*Powered by [holocron.so](https://holocron.so)*