Build & Preview

A Nebari docs pack is a static Astro site. Building it produces a dist/ directory of HTML, CSS, JS, and a prebuilt Pagefind search index that you can host anywhere.

Build

1. Install dependencies (once):

   npm

   npm install

   Bun

   bun install

2. Produce the production build:

   npm

   npm run build

   Bun

   bun run build

3. Preview the built site locally — this serves dist/ exactly as production will, including working search:

   npm

   npm run preview

   Bun

   bun run preview

Note

Search only works against a build. npm run dev skips Pagefind indexing for speed, so the search box returns nothing in dev — use preview to test it.

What the build produces

• Directorydist

  • index.html
  • Directorygetting-started/

    • …
  • Directoryguides/

    • …
  • Directory_astro/ hashed CSS/JS and self-hosted fonts

    • …
  • Directorypagefind/ prebuilt search index

    • …

Building under a base path

If your pack is served from a subpath, build with the matching base so every asset URL is prefixed. This site’s build:base script does exactly that:

Script

package.json

{
  "scripts": {
    "build:base": "astro build --base /demo-pack"
  }
}

CLI

astro build --base /my-pack

Caution

The base you build with must match the path the site is actually served from. A mismatch produces assets that 404 (missing prefix) or links that double the prefix.

Next

Once the build and preview look right, continue to Deploy to Production.