Démarrer

Démarrage rapide

Mettez votre premier site en ligne avec la CLI Vercel en cinq minutes.

Ce guide met un site statique en ligne avec la CLI Vercel. Il vous faut Node.js et npm.

  1. Créez votre compte et votre équipe

    Inscrivez-vous, confirmez votre adresse avec le code reçu par e-mail, puis créez une équipe. Le nom de l'équipe apparaît dans l'adresse de la console.

  2. Créez une clé d'API

    Dans l'équipe, ouvrez Clés d'API et créez une clé. Elle commence par ah_ et ne s'affiche qu'une fois : copiez-la tout de suite. Voir Clés d'API.

  3. Installez la CLI Vercel

    Terminal
    npm install --global vercel@63

    vercel login ne sert pas ici : la connexion passe toujours par la clé.

  4. Déployez une preview

    Depuis le dossier du site :

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

    Au premier envoi, la CLI crée le projet sous le nom du dossier et le relie au dossier dans .vercel/project.json. Elle affiche l'URL du déploiement, de la forme https://mon-site-abc123xyz.hgdc.cloud.

  5. Passez en production

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

    Le déploiement devient la production du projet. Ajoutez ensuite votre domaine : Domaines.

Ne pas répéter l'adresse de l'API

Un alias de shell, ou la clé dans une variable d'environnement, évite de retaper les options :

alias vh="vercel --api https://api.host.hgdc.ch --token ah_…"
vh deploy --prod

Avec un framework

Pour Astro, Vite, SvelteKit, Next.js ou un autre framework, construisez en local puis envoyez le résultat. Les sources ne sont jamais servies telles quelles :

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

Pour automatiser ces étapes à chaque push, passez par l'intégration GitHub.