# Sites statiques

> Servez des SPA et des builds statiques depuis nginx, avec redirections, réécritures et en-têtes.

Source: https://gheima.ma/fr/docs/static-sites

Les sites statiques servent des SPA et des builds statiques depuis un edge nginx léger, en HTTPS. Vous n’avez aucun processus serveur à gérer.

### Créer un site

1. **Nouveau site** — Sur la page Hébergement statique, cliquez sur « Nouveau site ».
2. **Pointez vers un dépôt** — Choisissez un projet si vous le souhaitez, nommez le site et saisissez son URL Git.
3. **Définissez le dossier de sortie** — Indiquez le dossier produit par votre build (par défaut dist).

### Préréglages de framework

Dans Paramètres, choisissez un préréglage de framework pour préremplir la commande de build et le dossier de sortie :

- `Vite`: npm run build → dist
- `Next.js (export statique)`: npm run build → out
- `Create React App`: npm run build → build
- `Astro`: npm run build → dist

### Redirections, réécritures et en-têtes

L’éditeur de routage dans Paramètres vous permet d’ajouter des règles que nginx applique au prochain déploiement :

- Les redirections envoient /old vers /new, éventuellement en 301 permanente.
- Les réécritures servent un chemin sous un autre, par exemple /api/(.*) vers /proxy/$1.
- Les en-têtes ajoutent des en-têtes de réponse à un chemin, par exemple X-Frame-Options: DENY sur /.

> Result: Votre build statique est servi en périphérie, en HTTPS, avec vos propres règles de redirection, de réécriture et d’en-têtes.

---

All docs: https://gheima.ma/fr/docs.md
