Comment publier un site Web avec Cursor : agent cloud ou votre propre hôte13 min read
Reading Time: 8 minutesPour publier un site Web avec Cursor, lancez d’abord le projet, puis choisissez le chemin de déploiement. L’agent cloud de Cursor dispose d’un flux de publication documenté pour un référentiel connecté à Vercel. Si vous avez intégré l’éditeur de bureau ou utilisez un autre hôte, déployez le référentiel examiné avec le pipeline normal de cet hôte. L’aperçu et le port transféré de Cursor vous permettent d’inspecter l’application, mais l’adresse publique que vous donnez aux clients ne l’est pas non plus.
Cette procédure pas à pas est destinée à un constructeur qui souhaite un lancement fonctionnel plutôt qu’une capture d’écran de page de destination générée. Il couvre le choix du référentiel, les invites, les aperçus locaux et cloud, les vérifications de build, la publication et le chemin facultatif des artefacts partagés pour les parties prenantes. Si plusieurs personnes doivent réviser le même brouillon avant le lancement, envisagez espace de travail partagé AgentGrid.io au lieu d’échanger des captures d’écran.
Comment créer un site Web dans Cursor et le publier avec AgentGrid.io
Configurez AgentGrid.io avant d’écrire du code dans Cursor afin que l’application atterrisse dans le bon espace de travail.
Étape 1 : Créer l’espace de travail du site dans AgentGrid.io
Connectez-vous sur app.agentgrid.io, sélectionnez la bonne équipe et choisissez un espace de travail pour le site Web. Utilisez un espace de travail séparé pour un public plus restreint. Choisissez un artefact d’application pour le site Web, pas un brief Markdown. Le partage d’un lien d’artefact privé ne le transforme pas en site public.

Étape 2 : Connectez l’agent Cursor, pas seulement l’éditeur
Ouvrez le projet de site dans Cursor et utilisez le mode Agent, qui peut modifier des fichiers et exécuter des commandes de terminal. Donnez-lui cette instruction : Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. Approuvez son nom, son espace de travail et Lire et écrire dans votre navigateur. Laissez Publier désactivé, sauf si vous souhaitez que l’agent soit déployé. Demandez ensuite à Cursor d’exécuter npx @animaapp/cli@latest workspaces et vérifiez qu’il peut voir l’espace de travail prévu. Si l’accès au terminal est désactivé, utilisez plutôt l’importation manuelle de dossiers.
Étape 3 : Créez, testez et importez le projet une fois
Invite Cursor : Créez une page de destination de réservation réactive pour un atelier de vélo. Utilisez ce référentiel, ajoutez une liste de services claire et un appel à l’action de réservation, exécutez les vérifications disponibles et dites-moi quels fichiers sont le point d’entrée du site. Ne modifiez pas le code sans rapport. Vérifiez sa différence et ouvrez l’aperçu local. Demandez à l’agent connecté d’exécuter npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, en remplaçant le dossier réel et l’ID de l’espace de travail qu’il répertorie. Ouvrez l’URL de l’artefact renvoyé. Pour un site statique, assurez-vous index.html et ses actifs référencés sont présents. Exclure node_modules, la sortie de build et les informations d’identification. Si la connexion n’était pas possible, choisissez Nouveau → Dossier de téléchargement ou Nouveau → Importer depuis ZIP dans AgentGrid.io. L’importation est un instantané et non une synchronisation automatique avec le référentiel. Vérifiez ses fichiers, son aperçu et son espace de travail.

Étape 4 : Mettre à jour le même artefact, puis le publier intentionnellement
Collez l’URL de l’artefact dans l’agent Cursor et demandez une amélioration précise, comme la correction du menu mobile sur cet artefact. Confirmez le changement dans l’historique. Lorsque le site est approuvé, utilisez Publier dans AgentGrid.io ou demandez expressément à un agent connecté ayant la capacité de Publier de le déployer. Ouvrez l’URL publique résultante et testez le lien de navigation et de réservation. La publication est distincte du partage de l’artefact privé. Les modifications de code ultérieures ne remplacent pas automatiquement le déploiement public : publiez une mise à jour lorsque vous souhaitez qu’elles soient mises en ligne.

Ce que Cursor peut publier directement
Cursor Documentation sur la configuration de l’environnement cloud décrit une séquence spécifique : enregistrez le travail dans un référentiel, connectez un compte Vercel, sélectionnez Publier dans la fenêtre Agents et recevez une URL de déploiement. Cursor lie le dépôt à un projet Vercel et déploie sa branche par défaut. Les commits de branche par défaut ultérieurs se déploient automatiquement. Une équipe Cursor déployée dans une équipe Vercel a besoin d’un plan supérieur à Hobby. Ces exigences ne constituent pas un bouton de publication universel pour chaque projet d’éditeur local.
Étape 1 : Démarrer dans le bon référentiel
Pour un site existant, ouvrez son référentiel dans Cursor et demandez à l’agent de suivre le cadre, les composants, les tests et les conventions de conception existants. Demandez-lui d’identifier ce qui est déjà déployé et quelle branche est en production avant de modifier le code. Pour un nouveau projet Cloud Agent, Cursor documente un itinéraire de départ à partir de zéro et une étape de création du référentiel Origin ; vérifiez la disponibilité dans votre compte avant de vous y fier. Un brouillon d’environnement sans dépôt enregistré n’est pas prêt pour le chemin de publication Vercel documenté.
Exemple d’invite : « Dans ce référentiel, créez un site d’accueil, d’ateliers et de visite réactif pour le magasin d’usines Cedar House. Utilisez le logo fourni et le calendrier des ateliers, et non la disponibilité inventée. Conservez le cadre et les conventions de style existants. Ajoutez des titres et des descriptions de page, des liens d’inscription fonctionnels à partir de project-notes.md et un menu mobile convivial pour le clavier. Affichez un plan, mettez-le en œuvre, répertoriez les fichiers et les tests modifiés et arrêtez-vous avant le déploiement. «
Si le projet comporte des routes API, une authentification ou des pages rendues par le serveur, identifiez-les maintenant. Un hôte uniquement statique peut ne pas prendre en charge le runtime. Demandez quelles variables d’environnement l’application attend et si certaines seraient exposées au navigateur. Ne collez jamais de secrets de production dans une invite d’agent et ne les confiez jamais au contrôle de code source.
Étape 2 : Prévisualiser l’application en cours d’exécution
Installez les dépendances et exécutez la commande de développement définie par le projet. Pour une session d’éditeur Cursor locale, ouvrez l’URL de développement local dans un navigateur. Pour un agent cloud, les documents Cursor ont détecté et configuré manuellement les ports transférés dans la fenêtre Agents. Ouvrez l’application transférée dans le navigateur interne et inspectez les vraies pages. Un journal de construction indiquant « terminé » ne peut pas valider une navigation réactive ou des appels à l’action fonctionnels.
Vérifiez le site sur des largeurs étroites et larges. Suivez les liens vers les destinations prévues et les formulaires de test. Essayez la navigation au clavier et la mise au point visible. Inspectez les alternatives d’images, les métadonnées, l’ordre des titres, les ressources manquantes et les états de chargement. Validez les heures d’ouverture du magasin, les coordonnées, la copie légale et les droits à l’image par rapport à la source approuvée. Si le site dépend d’une API, vérifiez une demande ayant échoué et confirmez qu’aucune information d’identification n’apparaît dans les bundles du navigateur.
Invite de test : « Exécutez les scripts de lint, de test et de production de ce référentiel. Ouvrez les trois pages dans un navigateur aux largeurs d’un mobile et d’un ordinateur de bureau. Signalez les actifs rompus, les liens morts et les contrôles inaccessibles, puis corrigez les défauts de code. Ne modifiez pas la configuration de déploiement et ne publiez pas. Résumez les échecs qui nécessitent une décision humaine. » En fait, ouvrez vous-même le navigateur une fois que l’agent a signalé le succès.
Étape 3 : Choisissez le chemin de lancement
| Chemin | Meilleur quand | Ce qui devient public |
|---|---|---|
| Publication de l’agent cloud sur Vercel | Le référentiel et la connexion Vercel sont prêts | URL de déploiement Vercel et domaine configuré |
| Le workflow de déploiement de votre hébergeur | Vous utilisez déjà un pipeline CI/CD ou une autre plateforme | L’URL de déploiement de l’hôte |
| Artefact AgentGrid.io | Une équipe a d’abord besoin d’une version de travail révisable | Rien jusqu’à ce que l’artefact soit publié séparément |
Les deux premiers chemins sont des itinéraires de déploiement. Le troisième est un workflow de collaboration et de publication avec sa propre copie de l’application. Choisissez une source de vérité et enregistrez la version que les réviseurs ont vue.
Étape 4 : Publier avec l’agent cloud Cursor et Vercel
Une fois l’œuvre dans un référentiel, connectez le compte Vercel en Cursor. Dans la fenêtre Agents, sélectionnez Publier au-dessus de l’entrée de l’agent. Si Cursor propose Ajouter Vercel, effectuez d’abord cette connexion. Vérifiez le référentiel, l’équipe Vercel de destination, la branche par défaut, les variables d’environnement et les paramètres de construction avant d’approuver. Le flux documenté de Cursor lie ensuite le référentiel, déploie la branche par défaut et renvoie l’URL.
N’utilisez pas de branche d’aperçu comme preuve de ce qui atterrira sur la branche par défaut. Vérifiez la différence et toute révision du code humain requise avant la fusion. Une validation ultérieure sur cette branche peut redéployer automatiquement le site actif, alors définissez dès maintenant les procédures d’approbation et de restauration. Si un site généré est statique, confirmez le répertoire de sortie ; si des routes de serveur sont impliquées, confirmez que l’hôte prend en charge le runtime de l’application. Traitez le domaine DNS et la facturation comme des décisions de propriété distinctes.
Étape 5 : Déployer via un autre hôte ou partager pour examen
Avec un autre hôte, validez le code révisé et suivez le référentiel spécifique au framework ou le workflow de téléchargement de ce fournisseur. Configurez la commande de build, l’emplacement de sortie, les variables d’environnement, les redirections et le domaine personnalisé sur cet hôte. Utilisez son déploiement préliminaire pour l’approbation des parties prenantes lorsqu’il est disponible. Cursor aide avec le code et les commandes ; l’hôte est propriétaire de l’URL publique et des paramètres de production.
Pour une revue d’équipe, AgentGrid.io documente un Connexion Cursor. Confirmez que l’environnement de l’agent peut exécuter le flux de connexion, accorder uniquement l’accès à l’espace de travail prévu et lui demander de renvoyer le lien d’artefact. Si la connexion ne convient pas, importez vous-même le dossier du projet examiné ou le ZIP. Inspectez l’aperçu et la source de l’artefact après le transfert ; un lien privé n’est pas un site Web de production et les modifications dans le dépôt d’origine ne se synchronisent pas automatiquement avec une copie importée.
Invite de transfert étendue : « Après avoir autorisé la connexion, placez le projet Cedar House examiné dans l’espace de travail nommé en tant qu’artefact d’application non publié. Renvoyez son URL privée et répertoriez toutes les dépendances ou fonctionnalités back-end dont le transfert a échoué. Ne pas publier, partager en externe ou choisir un autre espace de travail. » Lorsque l’équipe se termine, utilisez le nom de l’artefact. flux de publication séparé si AgentGrid.io est l’hôte choisi.
Étape 6 : Vérifier le déploiement réel
Ouvrez l’URL publique lorsque vous êtes déconnecté et depuis un téléphone. Comparez ses pages avec l’aperçu approuvé. Testez la navigation, les formulaires, la destination d’inscription, HTTPS, les métadonnées, le chargement d’images et tout domaine personnalisé. Enregistrez la validation déployée ou la révision de l’artefact. Si la page publique est plus ancienne, vérifiez la sélection de branche, la sortie de build, les variables d’environnement, les journaux de déploiement et la mise en cache avant de l’annoncer. Réexécutez les tests après chaque mise à jour de production.
Rendre la prochaine mise à jour délibérée
Enregistrez la version approuvée et l’URL publique. Les nouvelles modifications sont des brouillons jusqu’à ce qu’elles soient révisées et publiées à nouveau.
Questions fréquemment posées
Cursor peut-il publier un site Web sans Vercel ?
Oui, en produisant du code pour le workflow d’un autre fournisseur d’hébergement. Le contrôle de publication de l’agent Cloud documenté présenté ici utilise Vercel. L’aperçu de l’éditeur de bureau et les ports transférés ne sont pas des services d’hébergement indépendants.
Pourquoi la publication n’est-elle pas disponible dans ma session Cloud Agent ?
Vérifiez que le projet est enregistré dans un référentiel et que Vercel est connecté. L’éligibilité, le plan, les paramètres de l’organisation et les autorisations du référentiel peuvent également être importants. Suivez le guide de configuration actuel de Cursor plutôt que de supposer que les mêmes commandes apparaissent dans chaque compte.
Un aperçu Cursor mettra-t-il à jour mon site Web en ligne ?
Non. Un aperçu local ou transmis expose un processus de développement pour inspection. Un déploiement est un événement distinct. Dans le chemin Vercel de Cursor, les futurs commits sur la branche par défaut peuvent mettre à jour la production une fois l’intégration configurée.
Puis-je utiliser AgentGrid.io uniquement pour approbation ?
Oui. Conservez un artefact non publié pour une révision partagée, puis publiez cet artefact approuvé ou déployez le référentiel révisé correspondant via votre hôte existant. Gardez les deux copies alignées si vous utilisez les deux.
Pour une comparaison du transfert, consultez notre guide sur partager la sortie d’un agent sous forme de lien. Le publier un site Web Claude Design couvre un autre point de départ, tandis que le Procédure pas à pas de publication du site Web Muse montre un artefact révisé en cours de publication. Il s’agit de flux de travail différents et non de fonctionnalités de produit interchangeables.

Figma
Adobe XD
Sketch
Blog


