Guides
Monorepo et sous-dossier
Déployez une app qui vit dans un sous-dossier ou dans un monorepo.
Le dossier peut s'appeler apps/web ou site/. Indiquez le dossier racine du projet : c'est là que le build s'exécute.
Détection à l'import GitHub
À l'import, la plateforme lit tout le dépôt et cherche les dossiers qui contiennent un package.json, jusqu'à quatre niveaux de profondeur. Elle préfère, dans l'ordre :
- un framework reconnu ;
- un script
build; - un nom usuel :
web,site,www,frontend,app,landing,marketing; - le dossier le moins profond.
La racine d'un monorepo (champ workspaces, pnpm-workspace.yaml, turbo.json, nx.json…) n'est jamais choisie seule. Si le dépôt contient plusieurs apps, choisissez celle à déployer. Les dossiers node_modules, dist, build et les caches sont ignorés.
Fichier de verrouillage
Dans un monorepo, le fichier de verrouillage (pnpm-lock.yaml, bun.lock…) est souvent à la racine. Il compte pour toutes les apps : la commande d'installation suit le gestionnaire qu'il désigne.
Plusieurs sites dans un dépôt
Importez le dépôt une fois par site, en choisissant à chaque fois un dossier différent. Chaque projet a ses domaines, ses variables et son historique.
Avec la CLI
Lancez la CLI depuis le dossier de l'app :
cd apps/web
vercel --api https://api.host.hgdc.ch --token ah_… deploy