> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.new/llms.txt
> Use this file to discover all available pages before exploring further.
# Supabase
> Connect Supabase to Rocket and get a full backend - database, auth, file storage, and edge functions - all scaffolded from chat.
export const LlmsDirective = () =>
For the complete documentation index, see llms.txt.
For a lightweight markdown version of this page, append .md to the URL.
;
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
Sign-up, login, password reset, and protected routes. Supports email/password and social providers like Google and GitHub.
Store and manage structured data with a PostgreSQL database. Control who can read or edit each row with row-level security policies.
Push live changes to your UI instantly when rows are inserted, updated, or deleted in your database.
Let users upload images, documents, or other files with secure access controls and organized storage buckets.
Build SaaS products where each organization sees only its own data, with invite flows and role management.
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.
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.
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**.
Open the **Connectors** tab, click the **Supabase** card, and follow the OAuth flow.
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**.
Click the **Supabase** card in the Connectors panel.
Then click **Connect**.
**Option 3: From chat**
Type a prompt that mentions auth, database, or file storage. Rocket detects the intent and shows a **Connect** button inline.
**After clicking Connect**
A Supabase authorization screen opens. Sign in, review the permissions, and click **Authorize Rocket**.
You will then be asked to select or create an organization and link a project.
If you do not have one yet, you will be prompted to create one first.
Click **Create organization**. Rocket redirects you to select it and continue.
Choose your organization from the dropdown, then click **Authorize Rocket**.
Once authorized, you will be prompted to link a project to this task.
**Select an existing project** from the dropdown.
Or click **Create new Supabase project**, enter a name, password, and region, then click **Create a new project**.
To switch to a different project later, go to **Connectors** and use the Supabase project dropdown.
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.
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**.
**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**.
**After tapping Connect**
A Supabase authorization screen opens. Sign in, review the permissions, and tap **Authorize Rocket**.
You will then be asked to select or create an organization and link a project.
If you do not have one yet, you will be prompted to create one first.
Tap **Create organization**. Rocket redirects you to select it and continue.
Choose your organization from the dropdown, then tap **Authorize Rocket**.
Once authorized, you will be prompted to link a project to this task.
**Select an existing project** from the dropdown.
Or tap **Create new Supabase project**, enter a name, password, and region, then tap **Create a new project**.
To switch to a different project later, go to **Integrations** and use the Supabase project dropdown.
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 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
Apply Rocket-generated SQL migration scripts to keep your schema in sync.
Set up file storage buckets and wire them into your app.
Generate and deploy Supabase Edge Functions without leaving Rocket.
Add Google, GitHub, and other social login providers.
Set the correct redirect URLs so login and password resets work.
Step-by-step Google sign-in setup for Android APKs.
Reuse an existing Supabase project across multiple Rocket tasks.
Customize auth email templates to match your app's branding.
## What's next?
Add payments, subscriptions, and checkout to your Supabase-powered app.
Send transactional emails - welcome messages, receipts, password resets.
Full walkthrough combining Supabase, Stripe, Resend, and Netlify.