Cockpitify Docs Search the docs⌘K Product Sign in Try the live demo

Connect your Supabase project

Updated · Every plan · Phone · Web

How Cockpitify connects to Supabase with OAuth, what the small ops layer adds to your project, and what it never touches.

Cockpitify connects to your app through a small, isolated ops layer that it installs in your own Supabase project. Your users’ data stays there; Cockpitify reads it through that layer. You can connect from the phone or from the web; the steps are the same.

Before you start

  • You need to be able to approve OAuth access for the Supabase organization that owns the project.
  • One Supabase project backs one app in Cockpitify.
  • A paused project can’t be set up. If Supabase paused it for inactivity, restore it in the Supabase dashboard first.
  • Your plan sets how many apps you can connect: Free 1, Pro 3, Max and Team 10. See Plans, trials and billing.

Step 1: choose the backend

  1. Start from Connect your first app, or add another app:
    • On the phone: tap the app name at the top, then Add app.
    • On the web: open the app switcher or the account menu and choose Connect an App.
  2. Keep Supabase selected and tap Connect with Supabase.
  3. Your browser opens Supabase’s consent screen. Approve it and you’re sent back to Cockpitify.

Using your own Postgres, Firebase or AWS? Those are listed under Soon (on the web, Coming later). Tap Notify me on the one you use and we’ll email you when it’s ready; the most requested comes first.

Step 2: pick the project and review

  1. Pick your project from the list. Projects already connected show Connected or Another account.
  2. Check the App name (it defaults to the project name, up to 60 characters).
  3. Read To be added to your project:
    • the ops schema and its tables
    • four Edge Functions: ops-api, ops-revenuecat, ops-expo and ops-sentry
    • a few scheduled jobs (heartbeat, readings, retention and similar)
    • the pgcrypto, pg_net and pg_cron extensions, skipped if already enabled
    • one entry point that your app sends usage events to; it writes only to ops tables
  4. Under Left untouched you see your existing tables and the auth schema. They are only read.
  5. Want to see every line? Tap See all the SQL and function code, which also shows the SQL that removal runs.
  6. Tap Confirm and install.

If you are already at your plan’s app limit, Cockpitify tells you before anything is installed, for example “Your Free plan connects 1 app”.

Step 3: install

The install screen shows seven steps, from Enabling extensions to Testing the connection, with a progress bar. It takes about 30–60 seconds. You can leave the screen: you’ll get a notification when it’s done.

When it finishes you see that your app is connected and how many users were found. From here, allow notifications and work through the setup checklist (see Get started).

If setup doesn’t finish

You see Setup couldn’t finish with the step that failed. Tap Repair to run it again; repair reinstalls missing parts without deleting anything. Common causes:

  • The Supabase authorization expired. Connect again; the consent is only valid for a short time.
  • This project is already connected. Repair or update it instead: open the app, then App → Connections. On the phone, Account settings → Apps has the same buttons. See Repair, update or remove an app.
  • You’re at your plan’s app limit. Upgrade, or remove an app first. See Plans, trials and billing.

More fixes are in Troubleshooting.

What Cockpitify stores

Your users’ records stay in your project. Our backend keeps your account, how to reach each app’s ops layer, and notification metadata such as when and how many pushes went out. API keys you add later go into your project’s Supabase Vault, not to us. For what the ops layer keeps and for how long, see Data and limits.

Was this page helpful?YesNo
Ask a question
Questions? Ask me.I’m Murat, the indie developer behind Cockpitify.

I read every message and reply by email, usually within a day.