Guides

Site statique sans build

Déployez un dossier HTML, CSS et JavaScript en une commande.

Aucune étape de build n'est nécessaire : lancez la commande depuis le dossier du site.

Terminal
vercel --api https://api.host.hgdc.ch --token ah_… deploy --prod

Structure attendue

Arborescence
mon-site/
├── index.html
├── a-propos.html
├── 404.html
├── styles.css
└── images/
    └── logo.svg
  • Le dossier servi doit contenir un index.html à sa racine.
  • Un dossier qui ressemble à des sources (un package.json sans index.html) est refusé : construisez-le avec vercel build et envoyez-le avec --prebuilt.
  • Les fichiers et dossiers qui commencent par un point (.env, .git) ne sont jamais servis, ni vercel.json.
  • 404.html sert de page d'erreur.

Servir un sous-dossier

Si les fichiers à servir sont dans un sous-dossier (public/), indiquez-le comme dossier de sortie dans les réglages de build du projet.

URL propres et redirections

Ajoutez un vercel.json à la racine pour servir /a-propos sans .html, ou pour rediriger d'anciennes adresses :

vercel.json
{
  "cleanUrls": true,
  "redirects": [{ "source": "/ancienne-page", "destination": "/a-propos", "permanent": true }]
}

Toutes les options : Routage et vercel.json.