Supabase
Supabase is a managed backend platform built on PostgreSQL — with the PostGIS spatial extension, authentication, storage and edge functions. Connecting Supabase gives an application you build a real database of its own.
What it enables in ALIGN
Section titled “What it enables in ALIGN”Connecting your Supabase account unlocks the database capability of the App Builder: from the Data Sources panel you can
- link your Supabase account,
- pick an existing project or create a new database, which deploys a managed Postgres + PostGIS instance for your app,
- and manage the connected project, including its edge functions.
This is the simplest way to give your application a spatial database it can read from and write to. Full details are on the Data and databases page.
What connecting puts in your project
Section titled “What connecting puts in your project”Nothing until you connect. A project that never needs a database never carries one.
When you link or create a Supabase project, ALIGN adds the pieces your app needs to talk
to it: the @supabase/supabase-js client at src/lib/supabase.ts, the dependency in
package.json, the connection variables in .env, and src/types/database.types.ts — the
TypeScript types of your actual tables, regenerated every time the AI Builder changes the
schema, so the code it writes is checked against your real columns. That code is yours like the rest
of the project — editable, exportable, and it stays if you later disconnect.
How to connect
Section titled “How to connect”Supabase connects through OAuth — there is no key to copy.
- In ALIGN, go to Dashboard → Integrations and click Connect on the Supabase card.
- Authorize ALIGN in the Supabase window that opens (database read/write access).
- Back in an App Builder project, open the Data Sources panel to create or link a project.
Your credentials stay yours
Section titled “Your credentials stay yours”The Supabase connection is stored on your ALIGN account and scoped to what it is for. It is never written into a saved app, an export, or anything you share. Your database and its data remain yours, in standard PostgreSQL — no lock-in.
Related
Section titled “Related”- Data and databases — connecting and deploying a database in the App Builder.
- Integrations overview — how ALIGN keeps your credentials secure.