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 :

  1. un framework reconnu ;
  2. un script build ;
  3. un nom usuel : web, site, www, frontend, app, landing, marketing ;
  4. 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 :

Terminal
cd apps/web
vercel --api https://api.host.hgdc.ch --token ah_… deploy