> ## Documentation Index
> Fetch the complete documentation index at: https://dhiwisepvtltd-5e04e6a4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Add Supabase to Rocket.new to scaffold a complete backend with Postgres database, user authentication, file storage, and edge functions from chat.

Tell Rocket what your app needs in chat - user accounts, a database, file uploads - and it generates the complete backend implementation.

Supabase bundles PostgreSQL, auth, file storage, and edge functions into a single service. It is the foundational backend for most Rocket apps and pairs naturally with Stripe, Resend, and SendGrid.

## What you can build

> **User authentication**
>
> Sign-up, login, password reset, and protected routes. Supports email/password and social providers like Google and GitHub.

> **Database and content**
>
> Store and manage structured data with a PostgreSQL database. Control who can read or edit each row with row-level security policies.

> **Real-time updates**
>
> Push live changes to your UI instantly when rows are inserted, updated, or deleted in your database.

> **File uploads and storage**
>
> Let users upload images, documents, or other files with secure access controls and organized storage buckets.

> **Multi-tenant apps**
>
> Build SaaS products where each organization sees only its own data, with invite flows and role management.

> **Edge functions**
>
> Run server-side logic like sending emails or calling third-party APIs without exposing secret keys to the client.

## Connect Supabase

Supabase connects via OAuth - no API keys needed.

> [!NOTE]
>
> Supabase is a **workspace-level** connector. No matter where you connect it (Settings, Connectors tab, or chat), it links to your entire Rocket workspace and is available across all tasks.

**Web Browser**

You can connect from three places - all do the same thing.

**Option 1: From workspace Settings**

Click your profile in the top-left, then select **Settings**.

![Profile menu with Settings option highlighted.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-settings-profile-light.webp)

![Profile menu with Settings option highlighted.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-settings-profile-dark.webp)

Open Settings from your profile

Open the **Connectors** tab, click the **Supabase** card, and follow the OAuth flow.

![Workspace Settings showing the Connectors tab with the Supabase card.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-settings-light.webp)

![Workspace Settings showing the Connectors tab with the Supabase card.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-settings-dark.webp)

Supabase card in workspace Settings

> **[Manage workspace connectors](https://dhiwisepvtltd-5e04e6a4.mintlify.site/getting-started/workspace/connectors.md)**
>
> Connect once from Settings and it is available to all tasks.

**Option 2: From the Connectors tab inside a task**

Click the **`...`** button in the preview toolbar, then select **Connectors**.

Open Connectors from the toolbar

Click the **Supabase** card in the Connectors panel.

![Connectors panel showing the Supabase card.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-connectors-tab-light.webp)

![Connectors panel showing the Supabase card.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-connectors-tab-dark.webp)

Supabase card in the Connectors panel

Then click **Connect**.

![Supabase card with Connect button highlighted.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-click-connect-light.webp)

![Supabase card with Connect button highlighted.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-click-connect-dark.webp)

Supabase Connect button

**Option 3: From chat**

Type a prompt that mentions auth, database, or file storage. Rocket detects the intent and shows a **Connect** button inline.

![Rocket chat panel showing a Connect prompt for Supabase.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-through-chat-light.webp)

![Rocket chat panel showing a Connect prompt for Supabase.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/supabase-through-chat-dark.webp)

Rocket prompts you to connect Supabase from chat

**After clicking Connect**

A Supabase authorization screen opens. Sign in, review the permissions, and click **Authorize Rocket**.

![Supabase OAuth authorization screen.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/authorize-create-organization-light.webp)

![Supabase OAuth authorization screen.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/authorize-create-organization-dark.webp)

Supabase authorization screen

You will then be asked to select or create an organization and link a project.

> **Create a Supabase organization**
>
> If you do not have one yet, you will be prompted to create one first.
>
> ![Create Supabase org.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/create-organization-light.webp)
>
> ![Create Supabase org.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/create-organization-dark.webp)
>
> Create a new Supabase organization
>
> Click **Create organization**. Rocket redirects you to select it and continue.

> **Select an existing organization**
>
> Choose your organization from the dropdown, then click **Authorize Rocket**.
>
> ![Supabase org selection screen.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/select-organization-light.webp)
>
> ![Supabase org selection screen.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/select-organization-dark.webp)
>
> Select your Supabase organization

> **Link a Supabase project**
>
> Once authorized, you will be prompted to link a project to this task.
>
> **Select an existing project** from the dropdown.
>
> ![Select Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/select-existing-project-light.webp)
>
> ![Select Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/select-existing-project-dark.webp)
>
> Select a Supabase project
>
> Or click **Create new Supabase project**, enter a name, password, and region, then click **Create a new project**.
>
> ![Create Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/create-new-project-light.webp)
>
> ![Create Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/create-new-project-dark.webp)
>
> Create a new Supabase project
>
> To switch to a different project later, go to **Connectors** and use the Supabase project dropdown.

> **Disconnect this task from its Supabase project**
>
> This removes the linked project from the current task only. Your Supabase account stays connected to the workspace.
>
> 1. Click the **`...`** button in the toolbar and select **Connectors**.
> 2. Click the **Supabase** card.
> 3. Use the **Demo** dropdown to switch projects, or click **Disconnect** to unlink the current project.
>
> ![Supabase Connectors panel showing the project selector dropdown.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/task-disconnect-light.webp)
>
> ![Supabase Connectors panel showing the project selector dropdown.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/web-browser/task-disconnect-dark.webp)
>
> Switch or disconnect the linked Supabase project

**Mobile App**

You can connect from two places.

**Option 1: From Settings**

1. Tap **Settings** in the footer of the homepage.
2. Tap **Integrations**.
3. Enable the toggle next to **Supabase**.

![Settings icon in footer.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/supabase-connect-setting-in-rocket-app.webp)

Settings in the footer

![Integrations tab.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/select-integrations-in-rocket-app.webp)

Integrations tab

![Supabase toggle enabled.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/enable-toggle-supabase-in-rocket-app.webp)

Enable the Supabase toggle

**Option 2: From the Connectors tab inside a task**

1. Tap the **More** button in the header.
2. Tap **Integrations**.
3. Tap the **Supabase** card, then tap **Connect**.

![Integrations tab via More.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/more-button-integration-tab-in-rocket-app.webp)

Connectors tab via More

![Supabase connect card.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/supabase-connect-in-rocket-app.webp)

Supabase card in Connectors

**After tapping Connect**

A Supabase authorization screen opens. Sign in, review the permissions, and tap **Authorize Rocket**.

![Supabase OAuth screen.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/authorize-create-organization-light.webp)

Supabase authorization screen

You will then be asked to select or create an organization and link a project.

> **Create a Supabase organization**
>
> If you do not have one yet, you will be prompted to create one first.
>
> ![Create Supabase organization.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/create-organization-in-rocket-app.webp)
>
> Create a Supabase organization
>
> Tap **Create organization**. Rocket redirects you to select it and continue.

> **Select an existing organization**
>
> Choose your organization from the dropdown, then tap **Authorize Rocket**.
>
> ![Supabase org selection.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/select-organization-light.webp)
>
> Select your Supabase organization

> **Link a Supabase project**
>
> Once authorized, you will be prompted to link a project to this task.
>
> **Select an existing project** from the dropdown.
>
> ![Select Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/select-project-from-supabase-in-rocket-app.webp)
>
> Select a Supabase project
>
> Or tap **Create new Supabase project**, enter a name, password, and region, then tap **Create a new project**.
>
> ![Create Supabase project.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/create-a-project-in-supabase-in-rocket-app.webp)
>
> Create a new Supabase project
>
> To switch to a different project later, go to **Integrations** and use the Supabase project dropdown.

> **Disconnect this task from its Supabase project**
>
> This removes the linked project from the current task only. Your Supabase account stays connected to the workspace.
>
> 1. Tap **More** in the header, then tap **Integrations**.
> 2. Tap the **Supabase** card.
> 3. Tap **Disconnect project**.
>
> ![Disconnect project on mobile.](https://mintlify.s3.us-west-1.amazonaws.com/dhiwisepvtltd-5e04e6a4/images/build/connectors/supabase/overview/mobile-app/disconnect-supabase-project-in-rocket-app.webp)
>
> Disconnect a Supabase project

> **[Manage workspace connectors](https://dhiwisepvtltd-5e04e6a4.mintlify.site/getting-started/workspace/connectors.md#manage-connectors)**
>
> Disconnect or switch accounts from workspace Settings.

## Example prompts

Once Supabase is connected, paste any of these into chat to get started.

| What you want | Prompt to use |
| :- | :- |
| Email sign-up and login | `Add email/password sign-up and login with a protected dashboard page.` |
| Database with a UI | `Create a products table with name, description, price, and image URL. Add a page to list and filter products.` |
| File uploads | `Let users upload profile avatars. Store images in Supabase Storage and display them on the profile page.` |
| Server-side email on sign-up | `Create a Supabase Edge Function that sends a welcome email when a new user signs up.` |
| Per-user data access | `Add row-level security so users can only read and edit their own records in the posts table.` |
| Social login | `Add Google and GitHub login options to the sign-up page using Supabase Auth.` |
| Live data feed | `Show a live feed of new messages in the chat room using Supabase real-time subscriptions.` |
| Branded emails | `Customize the Supabase confirmation email template to match my app's branding.` |
| Multi-tenant data | `Scope all database queries to the current user's organization using RLS policies.` |
| Password reset | `Add a forgot-password page that sends a reset link via Supabase Auth.` |

## Tips

* **One Supabase project per task.** Each Rocket task links to a single Supabase project. Use separate tasks if you need separate databases.
* **Use edge functions for server-side logic.** When code should not reach the client - sending emails, calling APIs with secret keys - ask Rocket to create a Supabase Edge Function instead.
* **Free tier limits.** Supabase free includes two active projects, 500 MB database storage, and 1 GB file storage. See [Supabase pricing](https://supabase.com/pricing) for current limits.
* **Advanced database settings live in Supabase.** Extensions, connection pooling, and RLS policy debugging are managed directly from the [Supabase dashboard](https://supabase.com/dashboard).

## Go deeper

> **[Push migration scripts](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/push-migration-scripts.md)**
>
> Apply Rocket-generated SQL migration scripts to keep your schema in sync.

> **[Storage buckets](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/storage-buckets.md)**
>
> Set up file storage buckets and wire them into your app.

> **[Edge functions](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/edge-functions.md)**
>
> Generate and deploy Supabase Edge Functions without leaving Rocket.

> **[Social auth](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/social-auth.md)**
>
> Add Google, GitHub, and other social login providers.

> **[Redirect URLs](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/redirect-urls.md)**
>
> Set the correct redirect URLs so login and password resets work.

> **[Google sign-in](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/google-sign-in.md)**
>
> Step-by-step Google sign-in setup for Android APKs.

> **[Existing project](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/existing-project.md)**
>
> Reuse an existing Supabase project across multiple Rocket tasks.

> **[Email templates](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/supabase/email-templates.md)**
>
> Customize auth email templates to match your app's branding.

## What's next?

> **[Stripe](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/stripe.md)**
>
> Add payments, subscriptions, and checkout to your Supabase-powered app.

> **[Resend](https://dhiwisepvtltd-5e04e6a4.mintlify.site/build/connectors/resend.md)**
>
> Send transactional emails - welcome messages, receipts, password resets.

> **[Build a SaaS app](https://dhiwisepvtltd-5e04e6a4.mintlify.site/learn/recipes/saas.md)**
>
> Full walkthrough combining Supabase, Stripe, Resend, and Netlify.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.