Documentation

La plateforme est en préversion. Comptes, équipes, projets, variables, domaines et API sont réels. Les builds, eux, sont encore simulés : un déploiement passe par toutes ses étapes et garde ses fichiers, mais son URL ne sert pas encore le site. L'infrastructure suisse qui construit et sert les sites arrive ensuite.

Crée ton compte, puis une équipe. Dans Réglages de l'équipe → Clés d'API, crée une clé : elle commence par ah_ et n'est affichée qu'une fois.

Depuis le dossier de ton projet, avec la CLI Vercel installée (npm i -g vercel) :

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

Le projet est créé au premier déploiement, sous le nom du dossier, et la CLI le relie au dossier dans .vercel/project.json. Ajoute --prod pour la production. La connexion passe toujours par la clé : vercel login ne fonctionne pas ici. Pour ne pas répéter l'adresse, un alias suffit :

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

Tu peux aussi construire en local et n'envoyer que le résultat (.vercel/output, le format Build Output API) :

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

Dans GitHub Actions, la clé va dans les secrets du dépôt :

- run: npx vercel --api https://host.smartflowsa.ch --token ${{ secrets.AGENTHOST_TOKEN }} deploy --prod

Dans Réglages du projet → Variables d'environnement. Chaque variable vise un ou plusieurs environnements : production, preview, développement. Les valeurs sont chiffrées ; les membres en lecture seule ne les voient pas. Les noms commençant par VERCEL_ ou AGENTHOST_ sont réservés à la plateforme.

Ajoute ton domaine dans les réglages du projet, puis pose deux enregistrements chez ton hébergeur DNS :

• un TXT sur _agenthost.ton-domaine, qui prouve que le domaine est à toi ;
• un CNAME vers l'edge de la plateforme, qui y amène le trafic.

La vérification repasse toute seule toutes les 15 minutes. Le certificat HTTPS sera émis automatiquement par l'edge, qui arrive avec l'infrastructure suisse.

• Propriétaire : tout, y compris les membres, les clés d'API et la suppression de projets.
• Membre : crée et déploie des projets, gère variables et domaines.
• Lecture seule : voit projets et déploiements, sans les valeurs des variables. Pratique pour un client.

Les commandes vercel deploy et vercel deploy --prod, ainsi que la liaison de projet, testées avec la CLI Vercel 63.vercel deploy --prebuilt utilise les mêmes appels et devrait fonctionner, sans avoir encore été testé. Côté frameworks : tout ce qui produit le format Build Output API de Vercel, soit Next.js, Astro, SvelteKit, Nuxt, TanStack Start et React Router avec leur adapter Vercel, plus les sites statiques.

Pas encore : les edge functions, l'optimisation d'images, l'ISR, les crons et les commandes vercel env et vercel domains.