GitHub'ı bağlayın
Rendel, ekleyip hiçbir zaman kaydetmediğiniz bir ekran da dâhil olmak üzere kodunuzdaki yeni ekranları ve uç noktaları tespit eder ve bunları tek bir yapıştırmayla senkronize edersiniz.
Uygulamanın deposunu bağladığınızda Rendel, varsayılan dalınıza yapılan her push'u henüz bilmediği ekranlar ve uç noktalar için kontrol eder; buna eklediğiniz ve registerRoute işlevine hiç iletmediğiniz, tek başına bir derlemenin asla bildirmeyeceği bir ekran da dâhildir. Overview bunları listeler ve Sync with code tek bir yapıştırmayla kaydeder.
Bağlama
- Yönetim panelinde Settings → GitHub bölümünü açın ve Connect GitHub butonuna basın. Bunu yalnızca uygulamanın bir sahibi veya yöneticisi yapabilir.
- GitHub, Rendel uygulamasının nereye yükleneceğini ve hangi depoları görebileceğini sorar. Bu uygulamanın derlendiği depoyu seçin (daha fazlası da olabilir; yalnızca seçtiğiniz klasörler okunur).
- Settings bölümüne geri döndüğünüzde, Where is this app's code? en uygun olanı ilk sırada olmak üzere içinde Rendel bulunan depoları listeler. En üstteki satır genellikle doğru olandır, örneğin ✓ Grove's key found: acme/grove-app (Flutter, /). Bind butonuna basın.
Platform başına bir klasör: Bir Flutter uygulaması ve web sürümü iki ayrı depo veya tek bir deponun iki klasörü olabilir. Rendel, bir klasörün bu uygulamaya ait olduğunu koddaki yayınlanabilir anahtarından anlar. Başka bir Rendel uygulamasının anahtarına sahip bir klasör buraya bağlanamaz; hiç anahtarı olmayan bir klasör ise Bind anyway ile bağlanabilir. Setup yapay zekâ kodlama aracı kodun nerede olduğunu bildirdiyse bu klasör de önerilir.
Rendel klasörü hemen okur, ardından dalına yapılan her push'u takip eder. Klasör bu uygulamanın anahtarını içermeyi bırakırsa Settings bunu belirtir ve siz hâlâ bu uygulamanın kodu olduğunu onaylayana veya başka bir klasör seçene kadar oradan yeni hiçbir şey bildirilmez.
Rendel'in yapabildikleri ve yapamadıkları
| İzin | Sade bir dille |
|---|---|
| Contents: read-only | Seçtiğiniz depodaki dosyaları okur. Bir dosyayı değiştiremez, ekleyemez veya silemez. |
| Metadata: read-only | Deponun adını ve varsayılan dalını görür. |
| Push events | Bir push yapıldığını ve hangi dosyalara dokunduğunu algılar. |
Issue'lar veya pull request'ler açamaz ya da bunlara yorum yapamaz, ayarları değiştiremez veya kendisine vermediğiniz hiçbir depoyu göremez. Rendel dosyalarınızı değil, bulduklarını (bir ad, dosya ve commit) saklar.
Nelere bakar
- Ekranlar: Flutter rotaları (
GoRoute, adlandırılmış rotalar, bir rota tablosu veya switch,MaterialPageRouteile push edilen bir sayfa widget'ı), Next.jsapp/vepages/rotaları ve React Router rotaları. - Bir push işleminin metot ve yol olarak çağrı eklediği uç noktalar. Kodunuzun zaten yapmış olduğu çağrılara dokunulmaz.
pubspec.yaml,package.jsonveya script etiketinizin sabitlediği SDK sürümü.
Her biri; en son derlemenizin kaydettiği rotalarla, bunları kaydeden dosyada adı geçen yollarla, yönetim panelinde bağlı uç noktalarla ve Rendel'in en son gördüğü SDK sürümüyle karşılaştırılır. Yalnızca Rendel'in bilmediği unsurlar saklanır. Giriş ve oturum çağrıları (/auth/login ve benzerleri) ile uygulamanızın kök ekranı hiçbir zaman bildirilmez.
Bu dosyaların hiçbirine dokunmayan bir push işlemi kesinlikle okunmaz. Bind anyway ile bağlanan ve içinde Rendel SDK bulunmayan bir klasör, Rendel orada kurulana kadar hiçbir şey bildirmez; Overview bunun yerine söz konusu kurulumu önerir.
Ne görürsünüz
Kodda Rendel'in bilmediği bir şey olduğunda Overview'daki Needs you alanı; adlar, dosyalar ve commit ile birlikte bunu belirtir (örneğin Your code has 2 screens Rendel doesn't know yet). Buradaki Sync with code, bu bulgular doğrultusunda What changed? kısmı önceden yazılmış şekilde senkronizasyon ekranını açar:
Sync Rendel (rendel.ai) for my app {your app's slug} with its code. Bring the Rendel SDK up to date (website: the script https://rendel.ai/sdk/web/0.27.0/rendel.js, Flutter: the package from https://github.com/neon-apps/rendel-flutter at v0.50.0) and, if the app has sign-in, make sure my signed-in user's token is passed to it so Rendel can call my API as that user. Then describe the app as it is now in rendel/setup.json as https://rendel.ai/schemas/setup/v1.json describes. Send nothing anywhere: I will import the file into my Rendel console myself.
Yönetim paneli size uygulamanızın slug'ını içeren bu istemi verir. Claude Code, Cursor, Codex, Windsurf, GitHub Copilot ve Gemini CLI üzerinde çalışır.
Bunu yapay zekâ kodlama aracınıza yapıştırın; ekranları kaydeder ve senkronize eder; derleme bunları bildirdiğinde veya bir sonraki push kayıtlı olduklarını gösterdiğinde bu öge kaybolur.
Bağlantıyı kesme
Settings → GitHub → Disconnect, okuma işlemini durdurur ve her bulguyu siler. Rendel uygulaması, siz GitHub üzerinden kaldırana kadar (GitHub → Settings → Applications) GitHub'da yüklü kalmaya devam eder.
Depo silinir veya arşivlenirse, Rendel depoya erişimini kaybederse ya da uygulama kaldırılır veya askıya alınırsa, Settings ve Overview bunu bildirir ve tekrar bağlanmayı önerir. Yeniden adlandırılan veya transfer edilen bir depo, yeni adı altında bağlı kalmaya devam eder.
Bir değişiklikten sonra eşitleme
Kodunuza yeni bir ekran, bir API çağrısı veya bir özellik eklendi. Yapay zekâ kodlama aracınıza neyin değiştiğini söyleyin; Rendel'i kodla aynı seviyeye getirsin.
Ekran ekleme
Rendel'in tek bir eşitlemeyle, uygulamanızın kendi navigasyonu üzerinden bir ekranı açmasını sağlayın.