Déployer ton premier projet

Tu as un repo Git et tu veux le voir tourner sur une vraie URL. Cette leçon te guide à travers les deux chemins possibles : le dashboard Vercel (rapide, visuel) et le CLI (pratique depuis le terminal). Les deux aboutissent au même résultat : une URL en .vercel.app fonctionnelle en quelques minutes.

Via le dashboard Vercel (import Git)

C'est le chemin le plus rapide pour un premier déploiement. Tout se passe dans le navigateur.

1. Créer un compte et connecter ton Git

Rends-toi sur vercel.com/signup et inscris-toi avec GitHub, GitLab ou Bitbucket. Vercel utilisera ce compte pour accéder à tes repos.

2. Importer un repo

Dans le dashboard, clique sur Add New... > Project (bouton en haut à droite), puis Import Git Repository. Vercel liste tous les repos auxquels ton compte Git a accès. Sélectionne celui que tu veux déployer.

3. Configurer et déployer

Sur la page de configuration, Vercel détecte automatiquement ton framework (Next.js, Vite, SvelteKit, etc.) et pré-remplit les commandes de build. Dans la plupart des cas, tu n'as rien à changer.

Clique sur Deploy. Vercel build et déploie ton projet. Le premier build prend 1 à 3 minutes selon la taille du projet.

Via le CLI Vercel

Le CLI est utile quand tu veux déployer sans quitter ton terminal, ou automatiser des déploiements dans un pipeline.

1. Installer le CLI

$npm i -g vercel

Le paquet s'appelle vercel (sans prefixe). Une fois installé, la commande vercel (ou son alias vc) est disponible globalement.

2. Se connecter

$vercel login

Le CLI ouvre un lien dans ton navigateur. Authentifie-toi avec le même compte que ton dashboard. De retour dans le terminal, tu verras une confirmation.

3. Déployer en preview

Depuis le dossier de ton projet :

$vercel

La première fois, le CLI te pose quelques questions : compte cible, nom du projet, dossier racine. Il détecte ton framework et configure le build automatiquement. À la fin, il affiche une URL de preview unique.

4. Pousser en production

$vercel --prod

Cette commande déploie sur la branche de production et met à jour l'URL stable de ton projet (ex: https://mon-projet.vercel.app).

Preview deployments : chaque PR a sa propre URL

Une fois ton repo connecté à Vercel via le dashboard, chaque pull request (ou merge request) déclenche automatiquement un déploiement de preview. Vercel poste l'URL directement en commentaire sur la PR dans GitHub, GitLab ou Bitbucket.

La logique est simple :

• Branche main (ou master) - deployment de production, sert ta vraie URL.
• Toute autre branche - deployment de preview, URL unique du type <projet>-git-<branche>.vercel.app.

Tu peux changer la branche de production dans Project Settings > Environments > Production > Branch Tracking.

Retrouver l'URL de production

Trois façons de la trouver :

1. Dans le dashboard Vercel, carte du projet en haut : l'URL cliquable sous le nom du projet.
2. Dans l'onglet Deployments du projet : le dernier déploiement étiqueté "Production".
3. Via le CLI avec vercel inspect suivi de l'URL du deployment, ou simplement vercel list pour voir les derniers déploiements.