Static Hosting

Streak.js generates fully static HTML files — no server runtime is required to serve them. Building and deploying is handled by Nexus, the Streak cloud build system.

How Deployment Works

When you publish your site, Nexus runs the build pipeline and deploys the output automatically based on your site configuration. You do not need to run bun run build locally or manage the out/ directory yourself.

For full deployment configuration and publishing steps, refer to the Nexus documentation.

Output Structure

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

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

This structure is managed by Nexus during the build — you will not normally need to work with it directly.

Preview Locally

For local development, use the dev server:

bun run dev

This renders pages on demand at port 3690 and reloads on file changes. A production preview is not required — Nexus handles the final build and deployment.

Path Requirement for Assets

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