Static Hosting

If your application consists only of static routes (no mode: "app"), you can deploy it to any static hosting provider (GitHub Pages, Netlify, AWS S3, etc.).

Usage

The static adapter ships inside @neutron-build/core and is selected at build time via the CLI's --preset flag — no separate install needed.

1. Build with the static preset:

   npx @neutron-build/cli build --preset static
   

Output

The build command will produce a directory (usually dist) containing pure .html, .css, and .js (for islands) files. Upload this directory to your host.

Client-Side Routing?

Static builds produce standard HTML files. Navigation between pages is standard browser navigation. If you need SPA-like navigation on a static host, consider using View Transitions.