Backend Supabase (Hubungkan Sekali Saja)

1Yang Anda dapatkan dengan menghubungkan Supabase#

Secara default, aplikasi buatan AI menyimpan datanya di satu ponsel tempat aplikasi terpasang - mode 'Offline'. Hubungkan Supabase dan aplikasi yang sama mendapat database cloud sungguhan (Postgres), akun pengguna, dan penyimpanan file, sehingga data dibagikan antar perangkat dan pengguna.

Ini BRING-YOUR-OWN: aplikasi berkomunikasi dengan proyek Supabase gratis ANDA. AppMint tidak menyediakan hosting apa pun dan tidak menarik biaya tambahan untuk itu.

Anda tidak perlu merancang tabel atau menulis SQL. AppMint menyusun skema dari deskripsi aplikasi Anda, menerapkannya, dan menjaganya tetap sinkron di setiap build.

2Yang Anda butuhkan lebih dulu#

Akun Supabase gratis - hanya itu. Anda TIDAK perlu membuat proyek lebih dulu; AppMint bisa membuatkannya saat Anda masuk.

Hal yang perlu diketahui tentang paket gratis:

• 2 proyek per organisasi.
• Proyek dijeda setelah seminggu tanpa lalu lintas dan aktif lagi pada permintaan berikutnya.

Jika Anda sudah punya proyek yang ingin dipakai ulang, itu juga bisa - AppMint menaruh setiap aplikasi di skemanya sendiri di dalamnya, sehingga beberapa aplikasi bisa berbagi satu proyek.

3Hubungkan (satu ketukan, disarankan)#

Di AI Studio, di bawah 'WHERE YOUR APP'S DATA LIVES', ketuk kartu 'Supabase' (bertuliskan 'Tap to connect'). Pilih 'Sign in with OAuth'.

Browser Anda membuka Supabase, Anda masuk dan menyetujui AppMint, lalu Anda otomatis kembali ke aplikasi - tidak ada token yang perlu disalin.

Hal yang sama tersedia dari ikon roda gigi ⚙ Pengaturan → 'BACKEND - SUPABASE' → '🔗 Connect Supabase (OAuth)'.

Buat akun Supabase gratis →

4Pilih atau buat proyek#

Setelah menyetujui, AppMint menampilkan 'Pick a Supabase project':

• Pilih proyek yang sudah ada, atau
• Ketuk '➕ Create new project…' → pilih organisasi → beri nama (mis. appmint-prod) → pilih wilayah yang dekat dengan pengguna Anda (tidak bisa diubah nanti) → 'Create'. Penyiapan memakan waktu 1-2 menit.

Saat AppMint membuat proyek, kata sandi database ditampilkan SEKALI, karena Supabase hanya menyimpan hash-nya. Salin ke tempat yang aman sebelum menutup dialog itu - Anda tidak membutuhkannya untuk AppMint, tetapi akan memerlukannya untuk menghubungkan alat lain.

Mencapai batas tier gratis ('Free tier allows 2 projects per organization')? Pilih proyek yang sudah ada, atau upgrade di dasbor Supabase.

5Atau hubungkan secara manual (self-hosted / tanpa OAuth)#

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

1. Project URL - dari dasbor Supabase Anda, Project Settings → API. Bentuknya https://YOUR-PROJECT-REF.supabase.co
2. Kunci anon - publishable key dari halaman yang sama; diawali 'eyJ'. Kunci ini memang dirancang untuk publik: yang melindungi data Anda adalah Row-Level Security, bukan menyembunyikan kunci.
3. Aktifkan 'Enable Supabase backend for generated apps' dan ketuk 'Save Supabase config'.

Centang 'Self-hosted instance' jika Anda menjalankan Supabase sendiri. Mode manual tidak bisa men-deploy skema otomatis di Cloud - tambahkan Personal Access Token (langkah berikutnya) jika Anda menginginkannya.

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

6Yang dilakukan AppMint di setiap build#

Setelah terhubung, setiap pembuatan aplikasi mengerjakan urusan backend untuk Anda:

• Menerapkan skema yang ditulis AI (tabel, indeks, kebijakan Row-Level-Security).
• Menjalankan data awal (seed), jika aplikasi membutuhkannya.
• Membuat bucket Storage untuk unggahan dan gambar.
• Men-deploy edge function (pembayaran, email, webhook) dan melewati yang tidak berubah.
• Mengatur penyedia autentikasi dan Site URL.
• Menjalankan gerbang keamanan dan gerbang migrasi, lalu menarik tipe TypeScript kembali ke proyek.

Tabel aplikasi Anda berada di skema sendiri bernama appmint_<aplikasi Anda>. Akun pengguna dibagikan ke semua aplikasi di proyek, jadi satu pendaftaran berlaku di mana saja.

7Pastikan berhasil#

Dua pemeriksaan cepat:

• Kartu 'Supabase' di AI Studio kini bertuliskan 'Connected', dan Pengaturan menampilkan project ref.
• Pengaturan → 'DIAGNOSTICS' → '⚡ Test Supabase connection' - menampilkan keberhasilan atau kesalahan yang tepat.

Setelah Anda membuat aplikasi, buka dasbor Supabase → Table Editor dan ubah pemilih skema dari 'public' ke appmint_<aplikasi Anda> untuk melihat tabel yang dibuat AppMint.

8Kunci mana yang aman di mana#

• Kunci anon - aman di dalam aplikasi yang dibuat. Row-Level Security menentukan apa yang boleh dibaca atau ditulis setiap pengguna yang masuk.
• Kunci service_role - TIDAK PERNAH dimasukkan ke aplikasi. AppMint menyimpannya terenkripsi hanya di perangkat ini, dan memakainya untuk bucket Storage dan penerapan skema self-hosted.
• Personal Access Token (sbp_…) - juga hanya di perangkat; memungkinkan AppMint men-deploy skema dan edge function di Supabase Cloud secara otomatis. Buat di supabase.com/dashboard/account/tokens dengan cakupan proyek baca + tulis.

Kedua kunci opsional ada di Pengaturan → 'ADVANCED - DEPLOY CREDENTIALS'.

Buat Personal Access Token →

9Membuka: Google Sign-In, Stripe, Remote Update#

Beberapa fitur memerlukan Supabase terhubung lebih dulu, dan akan mengarahkan Anda ke sini sampai terhubung:

• 'Continue with Google' di aplikasi yang dibuat.
• Pembayaran Stripe (checkout berjalan di edge function di proyek Anda).
• Remote Update - pembaruan yang Anda kirim ke aplikasi terpasang disimpan di proyek Supabase Anda sendiri.

Hubungkan sekali dan ketiganya tersedia; Anda tidak perlu mengulanginya untuk tiap aplikasi.

10Menghapus backend sebuah aplikasi#

Pengaturan → 'DANGER ZONE' (terlihat saat terhubung):

• '📋 List & delete project tables' - telusuri setiap tabel yang dibuat AppMint dan hapus yang tidak Anda perlukan lagi.
• '🗑 Delete this whole app backend' - menghapus skema aplikasi itu, dan opsional bucket Storage serta edge function-nya. Ketik DELETE untuk mengonfirmasi.

Pilih 'Data only' jika Anda ragu: bucket dan edge function dibagikan di seluruh proyek, bukan per aplikasi. Akun pengguna Anda tidak pernah disentuh.

Untuk memutus sepenuhnya: Pengaturan → 'ONE-TAP OAUTH' → '🔒 Disconnect Supabase OAuth'.

11Jika ada yang tidak berfungsi#

• 'Not connected' setelah masuk → OAuth selesai tetapi belum ada proyek yang terikat. Pengaturan → 'Choose project'.
• Peringatan bahwa kunci anon tidak diambil otomatis → persetujuan OAuth Supabase Anda tidak menyertakan cakupan Secrets:Read. Salin kunci anon dari Project Settings → API dan tempelkan di Pengaturan (langkah 5).
• 'Could not list your Supabase organizations' saat membuat proyek → buat proyek di dasbor Supabase, lalu kembali dan pilih proyek itu.
• 'Connect Supabase first' di Remote Update atau Stripe → bab ini, langkah 3.
• Baca/tulis data gagal di aplikasi yang dibuat → jalankan '⚡ Test Supabase connection' dulu; jika lolos, minta AI memperbaiki kebijakan Row-Level-Security untuk tabel yang disebutkan.