Statische sites

Bouw de bestanden en lever ze uit met een statische webserver.

Stapsgewijze deployhandleidingen: Static sites and SPAs, Astro, Next.js.

Dit buildpack bouwt zelf geen taalruntime. Voor JS-frontends draait Node.jseerst npm run build. Zie Buildpacksvoor de detectievolgorde.

Detectie

• static.toml in de Base directory, of
• Een bekend statisch JS-framework (Vite, Astro zonder serveradapter, Angular, Gatsby en vergelijkbare frameworks), of
• package.json met een build-script en zonder server-entrypoint (server.js, index.js, …)

Next.js, Nuxt en andere SSR-frameworks blijven bij het Node-buildpack en worden niet als statische bestanden uitgeleverd, tenzij Next op output: 'export' staat.

Outputmap

Nodion bepaalt de map in deze volgorde:

1. output-dir in static.toml
2. De standaardmap van het framework (dist, out, build, public, _site, de geneste dist/…/browser van Angular)
3. De eerste van die mappen die index.html bevat

output-dir = "dist"
fallback = "index.html"

fallback bepaalt de SPA-rewrite. Laat je die weg en bestaat index.html, dan gebruikt Nodion dat bestand.

Startcommando

static-web-server op 0.0.0.0:$PORT (8080 als PORT niet is ingesteld), met compressie. Je kunt dit zo nodig overschrijven met een Procfile.