In this guide, you’ll learn how to:
  • Connect multiple Rocket projects to the same Supabase database.
  • Build a new Rocket project using an existing Supabase project.
  • Understand when and why sharing a database is useful.

​
Before you begin

You’ll need:
  • A Supabase account with at least one active project.
  • Your Supabase account connected to Rocket.
  • Access permissions for the database you plan to use.

​
Why share a Supabase database

Connecting multiple Rocket projects to the same Supabase database is helpful when you want to:
  • Build different frontends (e.g., web and admin dashboard) that share the same data.
  • Maintain consistent authentication, storage, and API settings across projects.
  • Test new UI designs in a separate Rocket project without duplicating the backend.
You can also use an existing Supabase project to build in Rocket if you already have a working database and want to revamp its UI.

​
Use an existing Supabase project in Rocket

1

Start a new project in Rocket

From the Rocket dashboard, create a new project and choose your preferred starting point (blank or with templates).
Success check: You’re taken to the Rocket workspace for your new project.
2

Connect your existing Supabase project

  1. When prompted to connect a database, select Supabase.
  2. Log in to your Supabase account.
  3. From the list of projects, choose the Supabase project you want to link.
You can connect to a Supabase project used by another Rocket app or even one created entirely outside of Rocket.
Success check: Rocket confirms your Supabase project is connected.
3

Start building your UI in Rocket

Once connected, Rocket automatically uses the schema, tables, and auth settings from your linked Supabase project.
You can design pages, components, and workflows without changing the database.
Success check: Your Rocket app displays live data from your shared Supabase database.

​
Troubleshooting

​
1. I don’t see my Supabase project in Rocket

What you’ll see:
After signing in to Supabase, your project list is empty.
How to fix it:
  • Make sure you are signed into the correct Supabase account.

​
2. Changes in one Rocket project affect another

What you’ll see:
Updating data in one Rocket project instantly updates it in another.
How to fix it:
  • This is expected when projects share the same database.
  • If you want separate data, connect each Rocket project to its own Supabase project instead.

One database, multiple projects

Share data, streamline development, and revamp existing apps by connecting Rocket projects to the same Supabase database.
Need help?
Email us at support@rocket.new or join our Discord community.