Supabase integration
Connecting your TatbiQ app to Supabase adds a real backend to your app: a PostgreSQL database, user authentication, storage, and more. Your data lives in your own Supabase project, and TatbiQ handles the setup for you.

What you need
- A Supabase account. You can create one and a new project at supabase.com.
- A TatbiQ app that has been built and previewed. The integration requires your app to be ready first, so build and preview your app before connecting.
Connecting to Supabase
Open your project and go to Settings, then select Database.
Select Connect Supabase Account.
A Supabase window opens where you authorize TatbiQ. After you authorize, you are brought back to your project.
Choose the Supabase project to connect from the list of your projects. Each TatbiQ app should use its own Supabase project, so pick one that is not already used by another app.
You can also do this from the Go Live wizard, which includes a database step while you publish your app.
TatbiQ connects to Supabase securely and sets up the connection keys for you, so you do not need to copy and paste any URLs or API keys.
Adding the database to your app
Once your Supabase project is connected, TatbiQ walks you through three steps in the Database settings:
Choose the Supabase project to link, as described above.
TatbiQ analyzes your app's code, generates the database schema, adds authentication where your app needs it, and updates your app to use Supabase. This can take a few minutes.
TatbiQ applies the changes to your Supabase project, creating the tables and relationships your app needs.
After the schema is deployed, your app is republished so the live version uses your Supabase backend.
What you can do with Supabase
Once connected, you can manage your backend directly from your Supabase dashboard, including:
- Authentication: manage users, sign-up and login, and email templates.
- Database: view and edit your tables and data.
- Storage and other backend features that Supabase provides.
The Database settings include quick links that take you to the matching areas of your Supabase dashboard.
Disconnecting
You can disconnect a Supabase project from the Database settings. Because your app relies on Supabase for authentication, data, and backend features, disconnecting may stop parts of your app from working until you reconnect.