agentic

Hoe u een website publiceert met Cursor: Cloud Agent of uw eigen host10 min read

Reading Time: 7 minutesPubliceer een website die is gebouwd in Cursor: test het project, gebruik Cloud Agent Publish met Vercel als u hiervoor in aanmerking komt, of implementeer uw repository via een andere host.

Cursor publishing a website cover

Hoe u een website publiceert met Cursor: Cloud Agent of uw eigen host10 min read

Reading Time: 7 minutes

Om een ​​website te publiceren met Cursor, moet u eerst het project uitvoeren en vervolgens het implementatiepad kiezen. Cursor’s Cloud Agent heeft een gedocumenteerde publicatiestroom voor een repository die is verbonden met Vercel. Als u de desktopeditor hebt ingebouwd of een andere host gebruikt, implementeert u de beoordeelde opslagplaats met de normale pijplijn van die host. Met de preview en doorgestuurde poort van Cursor kunt u de app inspecteren, maar dat geldt ook voor het openbare adres dat u aan klanten geeft.

Deze walkthrough is bedoeld voor een bouwer die een werkende lancering wil in plaats van een gegenereerde screenshot van de landingspagina. Het omvat de keuze van de repository, aanwijzingen, lokale en cloudvoorbeelden, buildcontroles, publicatie en het optionele gedeelde artefactpad voor belanghebbenden. Als meerdere mensen hetzelfde concept moeten beoordelen voordat het wordt gelanceerd, overweeg dan een gedeelde AgentGrid.io-werkruimte in plaats van schermafbeeldingen uit te wisselen.

Hoe u een website bouwt in Cursor en deze publiceert met AgentGrid.io

Stel AgentGrid.io in voordat u code schrijft in Cursor, zodat de app in de juiste werkruimte terechtkomt.

Stap 1: Maak de sitewerkruimte in AgentGrid.io

Log in op app.agentgrid.io, selecteer het juiste team en kies een werkplek voor de website. Gebruik een aparte werkruimte voor een kleiner publiek. Kies een app-artefact voor de website, geen Markdown-briefing. Het delen van een link naar een privéartefact verandert deze niet in een openbare site.

AgentGrid.io-werkruimte met Een agent uitnodigen gemarkeerd
In een AgentGrid.io-werkruimte start het uitnodigen van een agent een ondersteunde verbinding.

Stap 2: Verbind de Cursor Agent, niet alleen de editor

Open het siteproject in Cursor en gebruik de Agent-modus, waarmee u bestanden kunt bewerken en terminalopdrachten kunt uitvoeren. Geef het deze instructie: 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. Keur de naam, werkruimte en Lezen en Schrijven goed in uw browser. Laat Publiceren uitgeschakeld tenzij u wilt dat de agent wordt geïmplementeerd. Vraag vervolgens Cursor om uit te voeren npx @animaapp/cli@latest workspaces en controleer of het de beoogde werkruimte kan zien. Als terminaltoegang is uitgeschakeld, gebruik dan handmatige mapimport.

Stap 3: Bouw, test en importeer het project één keer

Vraag Cursor: Bouw een responsieve boekingslandingspagina voor een fietsenwerkplaats. Gebruik deze repository, voeg een duidelijke servicelijst en call-to-action voor boekingen toe, voer de beschikbare controles uit en vertel mij welke bestanden het toegangspunt van de site zijn. Wijzig geen niet-gerelateerde code. Bekijk het verschil en open het lokale voorbeeld. Laat de verbonden agent uitvoeren npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, waarbij de daadwerkelijke map en de daarin vermelde werkruimte-ID worden vervangen. Open de geretourneerde artefact-URL. Zorg voor een statische site index.html en de activa waarnaar wordt verwezen, zijn aanwezig. Uitsluiten node_modules, build-uitvoer en referenties. Als de verbinding niet mogelijk was, kies dan Nieuw → Map uploaden of Nieuw → Importeren uit ZIP in AgentGrid.io. Importeren is een momentopname en geen automatische synchronisatie met de repository. Controleer de bestanden, het voorbeeld en de werkruimte ervan.

White Lotus-demowebsite-artefact in AgentGrid.io
Voorbeeld van een website-artefact in AgentGrid.io: de White Lotus-demo is privé terwijl de versie ervan wordt beoordeeld.

Stap 4: Update hetzelfde artefact en publiceer het vervolgens opzettelijk

Plak de artefact-URL in Cursor Agent en vraag om een ​​precieze verbetering, zoals het corrigeren van het mobiele menu voor dat artefact. Bevestig de wijziging in Geschiedenis. Wanneer de site is goedgekeurd, gebruikt u Publiceren in AgentGrid.io of vraagt ​​u uitdrukkelijk een verbonden agent met publicatiemogelijkheden om deze te implementeren. Open de resulterende openbare URL en test de navigatie- en boekingslink. Publiceren staat los van het delen van het privé-artefact. Latere codewijzigingen vervangen niet automatisch de openbare implementatie: publiceer een update wanneer u deze live wilt hebben.

Bijgewerkt AgentGrid.io Share-menu met de optie Publiceren
Het bijgewerkte menu Delen omvat Publiceren, waarmee een goedgekeurd artefact in een live website wordt omgezet.

Wat Cursor direct kan publiceren

Cursor’s Documentatie over het instellen van de cloudomgeving beschrijft een specifieke volgorde: werk opslaan in een repository, verbinding maken met een Vercel-account, Publiceren selecteren in het Agents-venster en een implementatie-URL ontvangen. Cursor koppelt de repository aan een Vercel-project en implementeert de standaardvertakking ervan. Latere standaard-branch commits worden automatisch geïmplementeerd. Een Cursor-team dat wordt ingezet in een Vercel-team heeft een plan boven Hobby nodig. Deze vereisten vormen geen universele publicatieknop voor elk lokaal editorproject.

Stap 1: Begin in de juiste repository

Voor een bestaande site opent u de repository in Cursor en vraagt u Agent om het bestaande raamwerk, de componenten, tests en ontwerpconventies te volgen. Laat het identificeren wat al is geïmplementeerd en welke tak in productie is voordat de code wordt gewijzigd. Voor een nieuw Cloud Agent-project documenteert Cursor een start-from-scratch-route en een stap voor het maken van een Origin-repository; controleer de beschikbaarheid in uw account voordat u erop vertrouwt. Een conceptomgeving zonder opgeslagen repository is niet gereed voor het gedocumenteerde Vercel Publish-pad.

Voorbeeldprompt: “Bouw in deze repository een responsieve Home-, Workshop- en Visit-site voor de Cedar House-fabriekswinkel. Gebruik het meegeleverde logo en workshopschema, niet de verzonnen beschikbaarheid. Houd het bestaande raamwerk en de stijlconventies in stand. Voeg paginatitels en beschrijvingen toe, werkende aanmeldingslinks van project-notes.md en een toetsenbordvriendelijk mobiel menu. Toon een plan, implementeer het, maak een lijst van gewijzigde bestanden en tests en stop vóór de implementatie.”

Als het project API-routes, authenticatie of door de server weergegeven pagina’s heeft, identificeer deze dan nu. Een host die alleen statisch is, ondersteunt de runtime mogelijk niet. Vraag welke omgevingsvariabelen de app verwacht en of deze aan de browser worden blootgesteld. Plak nooit productiegeheimen in een agentprompt en leg ze nooit vast aan broncontrole.

Stap 2: Bekijk een voorbeeld van de actieve app

Installeer afhankelijkheden en voer de ontwikkelingsopdracht uit die door het project is gedefinieerd. Voor een lokale Cursor-editorsessie opent u de lokale ontwikkelings-URL in een browser. Voor een Cloud Agent hebben Cursor-documenten doorgestuurde poorten gedetecteerd en handmatig geconfigureerd in het Agents-venster. Open de doorgestuurde app in de interne browser en inspecteer echte pagina’s. Een buildlogboek dat ‘voltooid’ zegt, kan geen responsieve navigatie of werkende call-to-action valideren.

Controleer de site op smalle en brede breedtes. Volg links naar de beoogde bestemmingen en testformulieren. Probeer toetsenbordnavigatie en zichtbare focus. Inspecteer afbeeldingsalternatieven, metagegevens, kopvolgorde, ontbrekende elementen en laadstatussen. Valideer winkeltijden, contactgegevens, legale kopieën en beeldrechten tegen de goedgekeurde bron. Als de site afhankelijk is van een API, controleer dan een mislukt verzoek en bevestig dat er geen inloggegevens verschijnen in browserbundels.

Testprompt: “Voer de lint-, test- en productie-build-scripts van deze repository uit. Open de drie pagina’s in een browser op mobiele en desktopbreedte. Rapporteer kapotte assets, dode links en ontoegankelijke bedieningselementen en repareer vervolgens codedefecten. Wijzig de implementatieconfiguratie niet en publiceer niet. Vat fouten samen die een menselijke beslissing vereisen. ” Open de browser daadwerkelijk zelf nadat de agent succes meldt.

Stap 3: Kies het lanceerpad

Pad Beste wanneer Wat openbaar wordt
Cloud Agent publiceren naar Vercel Repository en Vercel-verbinding zijn gereed Vercel-implementatie-URL en geconfigureerd domein
De implementatieworkflow van uw host U gebruikt al een CI/CD-pijplijn of een ander platform De implementatie-URL van de host
AgentGrid.io-artefact Een team heeft eerst een reviewbare werkversie nodig Niets totdat het artefact afzonderlijk wordt gepubliceerd

De eerste twee paden zijn implementatieroutes. De derde is een samenwerkings- en publicatieworkflow met een eigen exemplaar van de app. Kies één bron van waarheid en noteer welke versie reviewers hebben gezien.

Stap 4: Publiceer met Cursor Cloud Agent en Vercel

Zodra het werk zich in een repository bevindt, koppelt u het Vercel-account in Cursor. In het Agents-venster selecteert u Publiceren boven de agentinvoer. Als Cursor Add Vercel aanbiedt, voltooi dan eerst die verbinding. Controleer de repository, het Vercel-doelteam, de standaardvertakking, de omgevingsvariabelen en de build-instellingen voordat u deze goedkeurt. De gedocumenteerde stroom van Cursor koppelt vervolgens de repository, implementeert de standaardvertakking en retourneert de URL.

Gebruik geen preview branch als bewijs van wat er op de standaard branch terecht zal komen. Controleer de diff en eventuele vereiste beoordeling van de menselijke code voordat u samenvoegt. Een latere toewijzing aan die vertakking kan de live site automatisch opnieuw implementeren, dus definieer nu goedkeurings- en terugdraaiprocedures. Als een gegenereerde site statisch is, bevestig dan de uitvoermap; als er serverroutes bij betrokken zijn, controleer dan of de host de runtime van de app ondersteunt. Behandel domein DNS en facturering als afzonderlijke eigendomsbeslissingen.

Stap 5: Implementeer via een andere host of deel ter beoordeling

Met een andere host legt u de beoordeelde code vast en volgt u de raamwerkspecifieke repository of uploadworkflow van die provider. Configureer de build-opdracht, uitvoerlocatie, omgevingsvariabelen, omleidingen en aangepast domein op die host. Gebruik de preview-implementatie voor goedkeuring door belanghebbenden, indien beschikbaar. Cursor helpt met code en opdrachten; de host is eigenaar van de openbare URL en productie-instellingen.

Voor een teambeoordeling documenteert AgentGrid.io a Cursor-aansluiting. Controleer of de agentomgeving de verbindingsstroom kan uitvoeren, alleen toegang tot de beoogde werkruimte kan verlenen en deze kan vragen de artefactkoppeling te retourneren. Als verbinden niet geschikt is, importeer dan zelf de beoordeelde projectmap of ZIP. Inspecteer het artefactvoorbeeld en de bron na overdracht; een privélink is geen productiewebsite en bewerkingen in de originele opslagplaats worden niet automatisch gesynchroniseerd met een geïmporteerde kopie.

Scoped handoff-prompt: “Nadat ik de verbinding heb geautoriseerd, plaatst u het beoordeelde Cedar House-project in de genoemde werkruimte als een niet-gepubliceerd app-artefact. Retourneer de privé-URL en vermeld eventuele afhankelijkheden of backend-functies die niet kunnen worden overgedragen. Niet publiceren, extern delen of een andere werkruimte kiezen.” Wanneer het team zich afmeldt, gebruik dan de artefacten afzonderlijke publicatiestroom als AgentGrid.io de gekozen host is.

Stap 6: Controleer de daadwerkelijke implementatie

Open de openbare URL terwijl u bent uitgelogd en vanaf een telefoon. Vergelijk de pagina’s met het goedgekeurde voorbeeld. Test navigatie, formulieren, aanmeldingsbestemming, HTTPS, metagegevens, het laden van afbeeldingen en elk aangepast domein. Registreer de geïmplementeerde commit of artefactrevisie. Als de openbare pagina ouder is, controleer dan de vertakkingsselectie, bouw de uitvoer, omgevingsvariabelen, implementatielogboeken en caching voordat u deze aankondigt. Voer de tests opnieuw uit na elke productie-update.

Maak de volgende update bewust

Noteer de goedgekeurde versie en de openbare URL. Nieuwe bewerkingen zijn concepten totdat ze worden beoordeeld en opnieuw worden gepubliceerd.

Veelgestelde vragen

Kan Cursor een website publiceren zonder Vercel?

Ja, door code te produceren voor de workflow van een andere hostingprovider. Het hier besproken gedocumenteerde Cloud Agent Publish-besturingselement maakt gebruik van Vercel. Preview- en doorgestuurde poorten van de Desktop-editor zijn geen onafhankelijke hostingservices.

Waarom is Publiceren niet beschikbaar in mijn Cloud Agent-sessie?

Controleer of het project is opgeslagen in een repository en of Vercel is verbonden. Geschiktheid, plan, organisatie-instellingen en repositorymachtigingen kunnen ook van belang zijn. Volg de huidige installatiehandleiding van Cursor in plaats van ervan uit te gaan dat dezelfde bedieningselementen in elk account verschijnen.

Zal een Cursor-preview mijn live website updaten?

Nee. Een lokale of doorgestuurde preview legt een ontwikkelingsproces ter inzage. Een implementatie is een aparte gebeurtenis. In het Vercel-pad van Cursor kunnen toekomstige commits naar de standaardvertakking de productie bijwerken nadat de integratie is ingesteld.

Kan ik AgentGrid.io alleen gebruiken voor goedkeuring?

Ja. Bewaar een niet-gepubliceerd artefact voor gedeelde beoordeling en publiceer vervolgens dat goedgekeurde artefact of implementeer de bijbehorende beoordeelde opslagplaats via uw bestaande host. Houd beide kopieën uitgelijnd als u beide gebruikt.

Zie onze handleiding voor een vergelijking van de overdracht deel de uitvoer van een agent als een link. De publiceer een Claude Design-website omvat een ander uitgangspunt, terwijl de Handleiding voor het publiceren van Muse-websites toont een beoordeeld artefact dat naar publicatie gaat. Dit zijn verschillende workflows, geen uitwisselbare productfuncties.

|

Co-founder & CEO