Skip to main content
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 setup.
  • Understand when and why sharing a database makes sense.

​
Before you begin

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

​
Why share a Supabase database

Sharing a single Supabase project across Rocket apps is useful when you want to:
  • Power multiple frontends (e.g., customer site and admin panel) with the same data.
  • Keep authentication, storage, and APIs consistent across builds.
  • Test new UI designs without duplicating your backend.
Already using Supabase? You can bring that database into Rocket and focus entirely on the UI.

​
Best practices

Rocket connects to your entire Supabase project, but only uses what you tell it to. Clear prompts lead to cleaner builds.
  • Start with your schema
    In your first prompt, mention the tables and fields you need.
    Example:
    • Table: Users → Fields: Name, Email, Date joined
    • Table: Orders → Fields: Order ID, Status, Amount
  • Describe your setup
    If your database is already live, say so. Rocket won’t auto-detect the schema unless you explain it.
  • List the pages you want
    Tell Rocket exactly what you need.
    Example:
    “Create a Users page showing Name and Email, and an Orders page showing Status and Amount.”
  • One project, one purpose
    Keep Rocket projects focused. For example:
    • One for your user-facing app
    • One for your internal dashboard
  • When Rocket generates scripts
    Only push the script if you want to update the actual database.
    • Push when: You’re adding new fields or tables.
    • Don’t push when: Your schema already includes everything you need.
  • If multiple apps share the database
    Database changes affect every connected Rocket project. If one app adds a field, others can access it—but you’ll need to update those UIs separately.
    Example scenario:
    1. In App A, you prompt: “Add a Phone number field to user profiles.”
    2. Supabase now has a new field: Phone number.
    3. App B also connects to this database, but doesn’t yet show the field.
    4. In App B, prompt Rocket: “Update Users page to show Phone number.”
  • Try it in a test project first
    Exploring ideas? Connect to a test Supabase project before making changes to production.
Quick reminder: The more clearly you describe your schema and goals, the better Rocket can build what you need.

​
Use an existing Supabase project in Rocket

1

Start a new project in Rocket

From your Rocket dashboard, create a new project. Start blank or use a template.
Success check: You’re taken to the Rocket workspace for your new project.
2

Connect your existing Supabase project

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

Start building your UI in Rocket

Rocket uses your existing schema, tables, and auth settings.
You can now design pages and components without touching the database.
Success check: Your app shows live data from your Supabase project.

​
Troubleshooting

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

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

​
2. Changes in one Rocket project affect another

What you’ll see:
Updating the database in one Rocket project instantly affects another.
How to fix it:
  • This is expected behavior when projects share a database.
  • To isolate changes, connect each Rocket project to a separate Supabase project.

One database, multiple projects

Share data, streamline your builds, and redesign faster by connecting Rocket apps to the same Supabase database.
Need help?
Email us at support@rocket.new or join our Discord community.