Esc

Static Hosting

Streak.js generates fully static HTML files. The out/ directory produced by streak-forge pre-build contains everything needed to run the site — no server runtime is required.


Build First

Before deploying, generate the static output:

bun run build

This runs streak-forge pre-build and writes all pages to out/.


Output Structure

out/
  homeRenderId/
    index.html
  aboutRenderId/
    index.html

Each sitemap entry produces one subdirectory named after its renderId, containing a single index.html.


Preview Locally

Use Python's built-in HTTP server to preview the output before deploying:

python3 -m http.server 8000 --directory out

Navigate to port 8000 in your browser.


Deploying

Upload the contents of out/ to any static hosting provider. The site requires no server-side processing.

Examples of compatible hosting:

  • Netlify — set publish directory to out
  • nginx — serve out/ as the document root
  • Any other static file server or object storage with static website hosting enabled

No specific configuration is documented here beyond what the reference provides. Consult your hosting provider's documentation for deployment steps.


Path Requirement for Assets

The asset worker fetches runtime JS and CSS from /assets/. Ensure your hosting configuration serves public/assets/ at the /assets/ path. If this path is not preserved, gDom.loadPackage() calls will fail at runtime.