Cursor ile Bir Web Sitesi Nasıl Yayınlanır: Bulut Aracısı veya Kendi Barındırıcınız13 min read
Reading Time: 7 minutesCursor ile bir web sitesi yayınlamak için önce projeyi çalıştırın, ardından dağıtım yolunu seçin. Cursor’in Bulut Aracısı, Vercel’e bağlı bir depo için belgelenmiş bir Yayınlama akışına sahiptir. Masaüstü düzenleyiciyi oluşturduysanız veya farklı bir ana bilgisayar kullanıyorsanız, incelenen depoyu o ana bilgisayarın normal işlem hattıyla dağıtın. Cursor’in önizlemesi ve iletilen bağlantı noktası, uygulamayı incelemenize olanak tanır, ancak müşterilerinize verdiğiniz genel adres de aynı şekilde değildir.
Bu izlenecek yol, oluşturulmuş bir açılış sayfası ekran görüntüsü yerine çalışan bir lansman isteyen bir inşaatçı içindir. Depo seçimini, istemleri, yerel ve bulut önizlemelerini, derleme kontrollerini, yayınlamayı ve paydaşlar için isteğe bağlı paylaşılan yapı yolunu kapsar. Lansmandan önce birden fazla kişinin aynı taslağı incelemesi gerekiyorsa, paylaşılan AgentGrid.io çalışma alanı ekran görüntülerini değiştirmek yerine.
Cursor’te bir web sitesi nasıl oluşturulur ve AgentGrid.io ile nasıl yayınlanır?
Uygulamanın doğru çalışma alanına ulaşması için Cursor’te kod yazmadan önce AgentGrid.io’i kurun.
1. Adım: AgentGrid.io’te site çalışma alanını oluşturun
app.agentgrid.io adresinde oturum açın, doğru ekibi seçin ve web sitesi için bir çalışma alanı seçin. Daha dar bir hedef kitle için ayrı bir çalışma alanı kullanın. Web sitesi için bir Markdown özeti değil, bir uygulama yapısı seçin. Özel bir yapı bağlantısının paylaşılması, onu genel bir siteye dönüştürmez.

2. Adım: Yalnızca düzenleyiciyi değil, Cursor Agent’ı bağlayın
Site projesini Cursor’te açın ve dosyaları düzenleyebilen ve terminal komutlarını çalıştırabilen Aracı modunu kullanın. Ona şu talimatı verin: 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. Tarayıcınızda adını, çalışma alanını ve Okuma ve Yazma’yı onaylayın. Aracının dağıtılmasını istemediğiniz sürece Yayınlamayı kapalı bırakın. Ardından Cursor’in çalışmasını isteyin npx @animaapp/cli@latest workspaces ve amaçlanan çalışma alanını görebildiğini doğrulayın. Terminal erişimi devre dışıysa bunun yerine manuel klasör içe aktarmayı kullanın.
3. Adım: Projeyi bir kez oluşturun, test edin ve içe aktarın
Cursor istemi: Bir bisiklet atölyesi için duyarlı bir rezervasyon açılış sayfası oluşturun. Bu havuzu kullanın, net bir hizmet listesi ekleyin ve harekete geçirici mesaj rezervasyonu yapın, mevcut kontrolleri çalıştırın ve bana hangi dosyaların site giriş noktası olduğunu söyleyin. İlgisiz kodu değiştirmeyin. Farkını inceleyin ve yerel önizlemeyi açın. Bağlı aracının çalışmasını sağlayın npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, gerçek klasörü ve listelediği çalışma alanı kimliğini değiştirerek. Döndürülen yapı URL’sini açın. Statik bir site için şunları sağlayın: index.html ve referans alınan varlıkları mevcuttur. Hariç tut node_modules, derleme çıktısı ve kimlik bilgileri. Bağlantı mümkün değilse AgentGrid.io’te Yeni → Klasör Yükle veya Yeni → ZIP’ten İçe Aktar’ı seçin. İçe aktarma bir anlık görüntüdür, depoyla otomatik senkronizasyon değildir. Dosyalarını, önizlemesini ve çalışma alanını doğrulayın.

4. Adım: Aynı yapıyı güncelleyin ve ardından kasıtlı olarak yayınlayın
Yapı URL’sini Cursor Agent’a yapıştırın ve bu yapı üzerindeki mobil menüyü düzeltmek gibi kesin bir iyileştirme isteyin. Geçmiş’te değişikliği onaylayın. Site onaylandığında, AgentGrid.io’te Yayınla seçeneğini kullanın veya Yayınlama özelliğine sahip bağlı bir aracıdan siteyi dağıtmasını açıkça isteyin. Ortaya çıkan genel URL’yi açın ve navigasyon ve rezervasyon bağlantısını test edin. Yayınlamak, özel eseri paylaşmaktan farklıdır. Daha sonraki kod değişiklikleri otomatik olarak genel dağıtımın yerine geçmez: bir güncellemenin yayınlanmasını istediğinizde yayınlayın.

Cursor’in doğrudan yayınlayabileceği şeyler
Cursor’ler Bulut Ortamı Kurulumu belgeleri belirli bir sırayı açıklar: çalışmayı bir depoya kaydedin, bir Vercel hesabına bağlanın, Aracılar Penceresinde Yayınla’yı seçin ve bir dağıtım URL’si alın. Cursor, repoyu bir Vercel projesine bağlar ve varsayılan dalını dağıtır. Daha sonra varsayılan şube taahhütleri otomatik olarak dağıtılır. Vercel ekibine konuşlandırılan Cursor ekibinin Hobby’nin ötesinde bir plana ihtiyacı var. Bu gereksinimler her yerel editör projesi için evrensel bir yayınlama düğmesi değildir.
1. Adım: Doğru depodan başlayın
Mevcut bir site için Cursor’teki depoyu açın ve Agent’tan mevcut çerçeveyi, bileşenleri, testleri ve tasarım kurallarını takip etmesini isteyin. Kodu değiştirmeden önce neyin halihazırda dağıtıldığını ve hangi dalın üretimde olduğunu belirlemesini sağlayın. Yeni bir Cloud Agent projesi için Cursor, sıfırdan başlama rotasını ve Origin deposu oluşturma adımını belgeliyor; güvenmeden önce hesabınızdaki kullanılabilirliği kontrol edin. Kaydedilmiş deposu olmayan bir taslak ortamı, belgelenen Vercel Yayınlama yolu için hazır değildir.
Örnek istem: “Bu depoda, Cedar House fabrika mağazası için duyarlı bir Ev, Atölyeler ve Ziyaret sitesi oluşturun. Mevcut logoyu ve atölye programını kullanın, icat edilmemiş kullanılabilirliği kullanın. Mevcut çerçeveyi ve stil kurallarını koruyun. Sayfa başlıklarını ve açıklamalarını, project-notes.md’den çalışan kayıt bağlantılarını ve klavye dostu bir mobil menü ekleyin. Bir plan gösterin, uygulayın, değiştirilen dosyaları ve testleri listeleyin ve dağıtımdan önce durun.”
Projede API rotaları, kimlik doğrulama veya sunucu tarafından oluşturulan sayfalar varsa bunları şimdi tanımlayın. Yalnızca statik bir ana bilgisayar çalışma zamanını desteklemeyebilir. Uygulamanın hangi ortam değişkenlerini beklediğini ve bunlardan herhangi birinin tarayıcıya açık olup olmayacağını sorun. Üretim sırlarını asla bir aracı istemine yapıştırmayın veya bunları kaynak kontrolüne teslim etmeyin.
2. Adım: Çalışan uygulamayı önizleyin
Bağımlılıkları yükleyin ve proje tarafından tanımlanan geliştirme komutunu çalıştırın. Yerel Cursor düzenleyici oturumu için yerel geliştirme URL’sini bir tarayıcıda açın. Bir Bulut Aracısı için Cursor, Aracılar Penceresinde iletilen bağlantı noktalarını algıladı ve manuel olarak yapılandırdı. İletilen uygulamayı dahili tarayıcıda açın ve gerçek sayfaları inceleyin. “Tamamlandı” yazan bir derleme günlüğü, duyarlı gezinmeyi veya çalışan eylem çağrılarını doğrulayamaz.
Dar ve geniş genişliklerde siteyi kontrol edin. Hedeflenen hedeflere ve test formlarına giden bağlantıları izleyin. Klavyeyle gezinmeyi ve görünür odağı deneyin. Görüntü alternatiflerini, meta verileri, başlık sırasını, eksik varlıkları ve yükleme durumlarını inceleyin. Mağaza çalışma saatlerini, iletişim bilgilerini, yasal kopyayı ve görsel haklarını onaylı kaynağa göre doğrulayın. Site bir API’ye bağlıysa başarısız bir isteği kontrol edin ve tarayıcı paketlerinde hiçbir kimlik bilgisinin görünmediğini doğrulayın.
Test istemi: “Bu havuzun tüy bırakmayan, test eden ve üretim derleme komut dosyalarını çalıştırın. Üç sayfayı mobil ve masaüstü genişliklerinde bir tarayıcıda açın. Bozuk varlıkları, ölü bağlantıları ve erişilemeyen kontrolleri bildirin, ardından kod kusurlarını düzeltin. Dağıtım yapılandırmasını değiştirmeyin veya yayınlamayın. İnsan kararı gerektiren hataları özetleyin.” Temsilci başarıyı bildirdikten sonra tarayıcıyı aslında kendiniz açın.
3. Adım: Başlatma yolunu seçin
| Yol | En iyi zaman | Kamuya açık hale gelen şey |
|---|---|---|
| Cloud Agent’ı Vercel’e Yayınlayın | Repository ve Vercel bağlantısı hazır | Vercel dağıtım URL’si ve yapılandırılmış alan adı |
| Ana makinenizin dağıtım iş akışı | Zaten bir CI/CD işlem hattı veya başka bir platform kullanıyorsunuz | Ana bilgisayarın dağıtım URL’si |
| AgentGrid.io eseri | Bir ekibin öncelikle incelenebilir bir çalışma sürümüne ihtiyacı var | Eser ayrı olarak yayınlanana kadar hiçbir şey yapılmaz |
İlk iki yol dağıtım rotalarıdır. Üçüncüsü, uygulamanın kendi kopyasına sahip bir işbirliği ve yayınlama iş akışıdır. Bir gerçek kaynağı seçin ve hangi sürümü inceleyenlerin gördüğünü kaydedin.
4. Adım: Cursor Cloud Agent ve Vercel ile yayınlayın
Çalışma bir depoya alındıktan sonra Vercel hesabını Cursor’e bağlayın. Aracılar Penceresinde, aracı girişinin üzerindeki Yayınla’yı seçin. Cursor Vercel Ekle seçeneğini sunuyorsa önce bu bağlantıyı tamamlayın. Onaylamadan önce depoyu, hedef Vercel ekibini, varsayılan dalı, ortam değişkenlerini ve yapı ayarlarını inceleyin. Cursor’in belgelenen akışı daha sonra repoyu bağlar, varsayılan dalı dağıtır ve URL’yi döndürür.
Varsayılan dalda neyin bulunacağının kanıtı olarak önizleme dalını kullanmayın. Birleştirmeden önce farkı ve gerekli insan kodu incelemesini kontrol edin. Bu şubeye daha sonra yapılacak bir taahhüt, canlı siteyi otomatik olarak yeniden dağıtabilir; dolayısıyla onay ve geri alma prosedürlerini şimdi tanımlayın. Oluşturulan site statikse çıktı dizinini onaylayın; sunucu rotaları söz konusuysa ana bilgisayarın uygulamanın çalışma zamanını desteklediğini doğrulayın. DNS alan adını ve faturalandırmayı ayrı sahiplik kararları olarak değerlendirin.
5. Adım: Başka bir ana makine aracılığıyla dağıtın veya inceleme için paylaşın
Başka bir ana makineyle, incelenen kodu kaydedin ve o sağlayıcının çerçeveye özel deposunu veya yükleme iş akışını izleyin. Bu ana bilgisayarda derleme komutunu, çıktı konumunu, ortam değişkenlerini, yönlendirmeleri ve özel etki alanını yapılandırın. Mümkün olduğunda paydaş onayı için önizleme dağıtımını kullanın. Cursor kod ve komutlara yardımcı olur; ana bilgisayar genel URL’nin ve üretim ayarlarının sahibidir.
Ekip incelemesi için AgentGrid.io, bir Cursor bağlantısı. Aracı ortamının bağlantı akışını çalıştırabildiğini, yalnızca amaçlanan çalışma alanına erişim izni verdiğini ve yapı bağlantısını döndürmesini isteyebildiğini doğrulayın. Bağlanmak uygun değilse incelenen proje klasörünü veya ZIP dosyasını kendiniz içe aktarın. Aktarımdan sonra yapı önizlemesini ve kaynağı inceleyin; özel bağlantı, üretim web sitesi değildir ve orijinal depodaki düzenlemeler, içe aktarılan kopyayla otomatik olarak senkronize edilmez.
Kapsamlı devir istemi: “Bağlantıyı yetkilendirdikten sonra, incelenen Cedar House projesini yayınlanmamış bir uygulama yapısı olarak adlandırılmış çalışma alanına yerleştirin. Özel URL’sini döndürün ve aktarılamayan tüm bağımlılıkları veya arka uç özelliklerini listeleyin. Yayınlamayın, harici olarak paylaşmayın veya başka bir çalışma alanı seçmeyin.” Ekip imzayı attığında eserin ayrı Yayınlama akışı AgentGrid.io seçilen ana bilgisayar ise.
6. Adım: Gerçek dağıtımı doğrulayın
Oturumunuz kapalıyken ve telefondan genel URL’yi açın. Sayfalarını onaylanmış önizlemeyle karşılaştırın. Gezinmeyi, formları, kayıt hedefini, HTTPS’yi, meta verileri, resim yüklemeyi ve herhangi bir özel alanı test edin. Dağıtılan işlemi veya yapıt revizyonunu kaydedin. Genel sayfa daha eskiyse, duyurmadan önce şube seçimini, derleme çıktısını, ortam değişkenlerini, dağıtım günlüklerini ve önbelleğe almayı kontrol edin. Her üretim güncellemesinden sonra testleri yeniden çalıştırın.
Bir sonraki güncellemeyi kasıtlı yapın
Onaylanan sürümü ve genel URL’yi kaydedin. Yeni düzenlemeler, incelenip tekrar yayınlanana kadar taslak niteliğindedir.
Sık sorulan sorular
Cursor, Vercel olmadan bir web sitesi yayınlayabilir mi?
Evet, başka bir barındırma sağlayıcısının iş akışı için kod üreterek. Burada tartışılan belgelenmiş Bulut Aracısı Yayınlama kontrolü Vercel’i kullanır. Masaüstü düzenleyici önizlemesi ve iletilen bağlantı noktaları bağımsız barındırma hizmetleri değildir.
Yayınlama neden Cloud Agent oturumumda kullanılamıyor?
Projenin bir havuza kaydedildiğinden ve Vercel’in bağlı olduğundan emin olun. Uygunluk, plan, organizasyon ayarları ve depo izinleri de önemli olabilir. Her hesapta aynı kontrollerin göründüğünü varsaymak yerine Cursor’in mevcut kurulum kılavuzunu izleyin.
Cursor önizlemesi canlı web sitemi güncelleyecek mi?
Hayır. Yerel veya iletilen önizleme, inceleme için bir geliştirme sürecini ortaya çıkarır. Dağıtım ayrı bir olaydır. Cursor’in Vercel yolunda, varsayılan dalın gelecekteki taahhütleri, entegrasyon kurulduktan sonra üretimi güncelleyebilir.
AgentGrid.io’i yalnızca onay için kullanabilir miyim?
Evet. Yayınlanmamış bir yapıyı paylaşılan inceleme için saklayın, ardından bu onaylanmış yapıyı yayınlayın veya ilgili incelenen veri havuzunu mevcut ana makineniz aracılığıyla dağıtın. Her ikisini de kullanıyorsanız her iki kopyayı da aynı hizada tutun.
Aktarımın karşılaştırması için kılavuzumuza bakın. bir aracı çıktısını bağlantı olarak paylaşma. Claude Tasarım web sitesini yayınlayın başka bir başlangıç noktasını kapsarken, Muse web sitesi yayınlama kılavuzu gözden geçirilmiş bir yapıtın yayına taşınmasını gösterir. Bunlar farklı iş akışlarıdır, değiştirilebilir ürün özellikleri değildir.

Figma
Adobe XD
Blog


