Skip to main content
In this guide, you’ll learn how to:
  • Connect your Supabase account.
  • Select or create an organization and project.
  • Disconnect or switch accounts if needed.

​
Before you begin

You’ll need:
  • A Rocket account - rocket.new.
  • A Supabase account.

​
Connect Supabase to Rocket

Skip the keys. You don’t need to find or paste any Supabase API keys. Rocket handles everything for you as soon as you connect your account, securely and automatically.
1

Choose your connection method

You can start connecting Supabase from a few different places:A. From Account Settings
  • On the top-right corner of the homepage, click .
    Profile icon button beside My Projects

    Profile icon on the homepage in the navbar

  • Choose Account Settings
    Account Settings

    Select Account Settings

  • Click on the Integrations tab in the left menu.
    Open Integration tabOpen Integration tab

    Open Integration tab

  • Click Connect next to the Supabase option.
    Connect Supabase integrationConnect Supabase integration

    Connect Supabase integration

B. From a Rocket project
  • Open any project.
  • Go to Integrations.
    Integrations tabIntegrations tab

    Integrations tab

  • Scroll to Supabase and click Connect.
    Supabase connect in IntegrationsSupabase connect in Integrations

    Supabase connect in Integrations

C. From Chat
  • If your prompt includes terms like “auth” or “database,” Rocket will suggest connecting.
  • Click Connect in the popup.
    Supabase connect in chatSupabase connect in chat

    Supabase connect in chat

2

Authorize your Supabase account

  • A secure Supabase authorization popup appears.
  • Sign in and review the requested permissions.
  • Click Authorize Rocket to continue.
    Supabase OAuth screenSupabase OAuth screen

    Supabase authorization screen

Permissions you’ll grant Rocket:
  • Read and manage your Supabase projects and organizations.
  • Access project settings and API keys.
  • Create and manage database schemas, storage buckets, and edge functions.
You’ll be asked to create or select your organization.If not:
  • You’ll be prompted to create one first.
    Create Supabase orgCreate Supabase org

    Create a new Supabase organization

  • Click Create organization to create your organization and you will be redirected to the above condition.
If you already have one:
  • Select it from the dropdown.
    Supabase OAuth screen with organization createdSupabase OAuth screen with organization created

    Supabase authorization screen with organization created

  • Click Authorize Rocket to connect.
Success check: You’ll see a confirmation message and be redirected back to Rocket with Supabase connected.

Need to create or select a Supabase project?

Once your Supabase account is authorized and your organization is selected, you’ll be prompted to link a project.If you already have one:
  • Choose it from the dropdown list.
    Select Supabase projectSelect Supabase project

    Select a Supabase project

If you don’t:
  • Click Create new Supabase project to open a quick-setup popup.
    Create Supabase projectCreate Supabase project

    Create Supabase project popup

  • Set your project name, password, and region.
  • Click Create a new project.
Want to switch projects later?
  • Head to Integrations and use the Supabase project dropdown to select a different project.
To disconnect only the currently linked project:
  • Go to Integrations.
  • Click Disconnect project.
    Disconnect one projectDisconnect one project

    Disconnect a single Supabase project

You can disconnect Supabase from either global settings or from an individual project.Option A: From global Settings
  • Go to Account Settings → Integrations.
  • Click Disconnect next to the Supabase option.
  • In the popup that appears, click Yes, disconnect to confirm,
    or click to cancel.
    Supabase disconnect popupSupabase disconnect popup

    Supabase disconnect popup

Option B: From an open project
  • Open the project that’s connected to Supabase.
  • Go to Integrations
  • Click Disconnect next to the org name under the Supabase option.
    Disconnect via project settingsDisconnect via project settings

    Disconnect Supabase from project settings

​
Start building with Supabase

Once Supabase is connected, you can start building full-stack features:
  • Open any project and ask Rocket to add features like “Create a user login page” or “Add a database table for products.”
  • Rocket automatically uses your connected Supabase project for authentication, database, and storage.

Ready to build?
Learn how to use Supabase features in your Rocket app.

You did it!

Supabase is now linked to Rocket. Go ahead and build your app with full backend access.
Need help?
Email us at [email protected] or join our Discord community to get help, share ideas, and connect with other creators.