Deployment

Nera erzeugt einen einfachen public/-Ordner — deploye ihn überall dort, wo statische Dateien ausgeliefert werden.

Bauen

Terminal

npm run build

Hosten

Netlify / Vercel — Build-Befehl npm run build, Publish-Verzeichnis public.
GitHub Pages — in GitHub Actions bauen und public/ mit actions/upload-pages-artifact und actions/deploy-pages veröffentlichen, wie diese Website es tut.
Beliebiger statischer Host / CDN — den Inhalt von public/ hochladen.

Cache Busting

Browser speichern Stylesheets, Skripte und Schriften zwischen, deshalb sehen Besucher nach einem Deploy eventuell noch das alte CSS oder JS, bis sie die Seite hart neu laden. Aktiviere Content-Hashing in config/app.yaml (benötigt @nera-static/core 4.11 oder neuer):

yaml

asset_hashing: true

Bei jedem Build hängt Nera ?v=<hash> an jede lokale Asset-URL an — Stylesheets, Skripte, Bilder, srcset, den Suchindex und url(…)-Verweise im CSS wie Schriften. Der Hash stammt aus dem Inhalt der Datei, die URL ändert sich also genau dann, wenn sich die Datei ändert, und bleibt sonst cachebar. Deine Templates behalten einfache Pfade wie /css/main.css; füge ?v= niemals von Hand hinzu.

Links auf Seiten, externe URLs und URLs, die bereits einen Query-String haben, bleiben unverändert, und es funktioniert zusammen mit base_path. Ohne den Schlüssel bleibt die Build-Ausgabe unverändert.

Bevor du startest

Setze origin in config/app.yaml auf deine echte Domain, damit die kanonischen URLs korrekt sind (siehe Canonical-Links für SEO).
Füge eine .neraignore im Projektstamm hinzu, um reine Quell-Assets aus dem Build herauszuhalten.

public/ wird bei jedem Rendern gelöscht und neu gebaut — bearbeite es niemals von Hand und committe es niemals als Quelle.