Supabase Arka Ucu (Bir Kez Bağlayın)

1Supabase'i bağlamak size ne sağlar#

Varsayılan olarak yapay zekâyla oluşturulan bir uygulama verilerini yalnızca yüklü olduğu telefonda tutar - 'Çevrimdışı' mod. Supabase'i bağlayın, aynı uygulama gerçek bir bulut veritabanı (Postgres), kullanıcı hesapları ve dosya depolama kazansın; veriler cihazlar ve kullanıcılar arasında paylaşılsın.

KENDİ HESABINIZI GETİRİN modeldir: uygulama SİZİN ücretsiz Supabase projenizle konuşur. AppMint sizin için hiçbir şey barındırmaz ve bunun için ek ücret almaz.

Tablo tasarlamanız veya SQL yazmanız gerekmez. AppMint şemayı uygulama açıklamanızdan çıkarır, uygular ve her derlemede senkron tutar.

2Önce nelere ihtiyacınız var#

Ücretsiz bir Supabase hesabı - hepsi bu. Önce proje oluşturmanız GEREKMEZ; AppMint giriş sırasında sizin için bir tane oluşturabilir.

Ücretsiz plan hakkında bilmeniz gerekenler:

• Kuruluş başına 2 proje.
• Projeler bir hafta trafik olmazsa duraklatılır ve bir sonraki istekte uyanır.

Yeniden kullanmak istediğiniz bir projeniz varsa o da olur - AppMint her uygulamayı projenin içinde kendi şemasına koyar, böylece birkaç uygulama tek projeyi paylaşabilir.

3Bağlayın (tek dokunuş, önerilir)#

AI Studio'da 'WHERE YOUR APP'S DATA LIVES' altında 'Supabase' kartına dokunun ('Tap to connect' yazar). 'Sign in with OAuth'u seçin.

Tarayıcınız Supabase'i açar, giriş yapıp AppMint'i onaylarsınız ve otomatik olarak uygulamaya dönersiniz - kopyalanacak bir belirteç yoktur.

Aynısı ⚙ Ayarlar dişlisinden de yapılabilir → 'BACKEND - SUPABASE' → '🔗 Supabase'i Bağla (OAuth)'.

Ücretsiz Supabase hesabı oluştur →

4Projeyi seçin veya oluşturun#

Onayladıktan hemen sonra AppMint 'Bir Supabase projesi seçin' ekranını gösterir:

• Mevcut bir proje seçin veya
• '➕ Yeni proje oluştur…'a dokunun → kuruluşu seçin → bir ad verin (örn. appmint-prod) → kullanıcılarınıza yakın bir bölge seçin (daha sonra değiştirilemez) → 'Oluştur'. Hazırlanması 1-2 dakika sürer.

AppMint projeyi oluştururken veritabanı parolasını BİR KEZ gösterir, çünkü Supabase yalnızca özetini saklar. Pencereyi kapatmadan önce güvenli bir yere kopyalayın - AppMint için gerekmez ama başka bir araç bağlamak için gerekir.

Ücretsiz katman sınırına mı takıldınız ('Free tier allows 2 projects per organization')? Bunun yerine mevcut bir projeyi seçin veya Supabase panelinden yükseltin.

5Veya elle bağlayın (kendi sunucunuz / OAuth yok)#

Ayarlar → 'BACKEND - SUPABASE' → 'MANUAL / SELF-HOSTED':

1. Proje URL'si - Supabase panelinizden, Project Settings → API. https://YOUR-PROJECT-REF.supabase.co gibi görünür
2. anon key - aynı sayfadaki yayınlanabilir anahtar; 'eyJ' ile başlar. Bu anahtar herkese açık olacak şekilde tasarlanmıştır: verilerinizi anahtarı gizlemek değil, Row-Level Security korur.
3. 'Oluşturulan uygulamalar için Supabase arka ucunu etkinleştir'i açın ve 'Supabase yapılandırmasını kaydet'e dokunun.

Supabase'i kendiniz çalıştırıyorsanız 'Self-hosted instance' kutusunu işaretleyin. Manuel mod, Cloud'da şemayı otomatik dağıtamaz - bunu istiyorsanız bir Kişisel Erişim Belirteci ekleyin (sonraki adım).

Project URL   https://abcdefghijkl.supabase.co
anon key      eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

6AppMint her derlemede ne yapar#

Bağlandıktan sonra her oluşturmada arka uç işini sizin yerinize yapar:

• Yapay zekânın yazdığı şemayı (tablolar, dizinler, Row-Level-Security politikaları) uygular.
• Uygulamanın gerektirdiği başlangıç verilerini çalıştırır.
• Yüklemeler ve görseller için Storage bucket'ları oluşturur.
• Edge işlevlerini (ödemeler, e-posta, webhook'lar) dağıtır ve değişmeyenleri atlar.
• Kimlik doğrulama sağlayıcılarını ve Site URL'sini ayarlar.
• Bir güvenlik kapısı ve bir geçiş kapısı çalıştırır, ardından TypeScript türlerini projeye geri çeker.

Uygulamanızın tabloları appmint_<uygulamanız> adlı kendi şemasında bulunur. Kullanıcı hesapları projedeki tüm uygulamalar arasında paylaşılır, bu yüzden tek bir kayıt her yerde çalışır.

7Çalıştığını kontrol edin#

İki hızlı kontrol:

• AI Studio'daki 'Supabase' kartı artık 'Bağlı' yazar ve Ayarlar proje referansını gösterir.
• Ayarlar → 'DIAGNOSTICS' → '⚡ Supabase bağlantısını test et' - başarıyı veya tam hatayı bildirir.

Bir uygulama oluşturduktan sonra Supabase panelinizi → Table Editor'ı açın ve şema seçicisini 'public'ten appmint_<uygulamanız>'a değiştirerek AppMint'in oluşturduğu tabloları görün.

8Hangi anahtar nerede güvenli#

• anon key - oluşturulan uygulamaların içinde güvenlidir. Row-Level Security, oturum açmış her kullanıcının neyi okuyup yazabileceğini belirler.
• service_role key - ASLA bir uygulamanın içine konmaz. AppMint bunu yalnızca bu cihazda şifreli saklar ve Storage bucket'ları ile kendi sunucunuzda şema uygulaması için kullanır.
• Kişisel Erişim Belirteci (sbp_…) - o da yalnızca cihazda kalır; AppMint'in Supabase Cloud'da şemayı ve edge işlevlerini otomatik dağıtmasını sağlar. supabase.com/dashboard/account/tokens adresinde okuma + yazma proje kapsamıyla oluşturun.

İki isteğe bağlı anahtar da Ayarlar → 'ADVANCED - DEPLOY CREDENTIALS' bölümündedir.

Kişisel Erişim Belirteci oluştur →

9Açar: Google ile Giriş, Stripe, Uzaktan Güncelleme#

Birkaç özellik önce Supabase'in bağlanmasını ister ve bağlanana kadar sizi buraya yönlendirir:

• Oluşturulan uygulamalarda 'Google ile devam et'.
• Stripe ödemeleri (ödeme, projenizdeki bir edge işlevinde çalışır).
• Uzaktan Güncelleme - yüklü uygulamalara gönderdiğiniz güncellemeler kendi Supabase projenizde saklanır.

Bir kez bağlayın, üçü de kullanılabilir olur; bunu uygulama başına tekrarlamazsınız.

10Bir uygulamanın arka ucunu kaldırma#

Ayarlar → 'DANGER ZONE' (bağlıyken görünür):

• '📋 Proje tablolarını listele ve sil' - AppMint'in oluşturduğu tüm tablolara göz atın ve artık gerekmeyenleri silin.
• '🗑 Bu uygulamanın tüm arka ucunu sil' - uygulamanın şemasını ve isteğe bağlı olarak Storage bucket'larını ve edge işlevlerini kaldırır. Onaylamak için DELETE yazarsınız.

Emin değilseniz 'Yalnızca veri'yi seçin: bucket'lar ve edge işlevleri uygulama başına değil, tüm proje genelinde paylaşılır. Kullanıcı hesaplarınıza asla dokunulmaz.

Tamamen bağlantıyı kesmek için: Ayarlar → 'ONE-TAP OAUTH' → '🔒 Supabase OAuth bağlantısını kes'.

11Bir şey çalışmazsa#

• Giriş yaptıktan sonra 'Bağlı değil' → OAuth tamamlandı ama henüz bir proje bağlanmadı. Ayarlar → 'Proje seç'.
• anon key'in otomatik alınmadığına dair bir uyarı → Supabase OAuth onayınızda Secrets:Read kapsamı yok. anon key'i Project Settings → API'den kopyalayıp Ayarlar'a yapıştırın (5. adım).
• Proje oluştururken 'Supabase kuruluşlarınız listelenemedi' → projeyi bunun yerine Supabase panelinde oluşturun, sonra geri dönüp seçin.
• Uzaktan Güncelleme veya Stripe'ta 'Önce Supabase'i bağlayın' → bu bölüm, 3. adım.
• Oluşturulan uygulamada veri okuma/yazma başarısız → önce '⚡ Supabase bağlantısını test et'i çalıştırın; geçerse yapay zekâdan adını verdiği tablo için Row-Level-Security politikasını düzeltmesini isteyin.