Connecting a Supabase Account

To clone projects, you must first connect your Supabase account to Twins. This gives Twins access to your projects and organizations.

Connection Methods

OAuth (recommended)

OAuth is the simplest and most secure connection method:

  1. Go to Dashboard > Connect
  2. Click Connect with Supabase
  3. You are redirected to Supabase to authorize access
  4. Accept the requested permissions
  5. You are redirected back to Twins — your account is now connected

Benefits of OAuth:

  • No token to copy/paste
  • The token renews automatically
  • Revocable at any time from Supabase

Personal Access Token (PAT)

If you prefer using a token:

  1. Go to your Supabase account settings > Access Tokens
  2. Create a new token
  3. Copy the token
  4. In Twins, go to Dashboard > Connect
  5. Choose Personal Access Token
  6. Paste your token and confirm

Warning: A PAT grants full access to your Supabase account. Never share it and store it in a safe place.

Multiple Accounts

You can connect multiple Supabase accounts to Twins. This is useful if you have:

  • A personal account and a company account
  • Projects spread across multiple organizations
  • Access to client accounts

Each connected account is independent and accessible from the project selector when creating a clone.

Naming Your Accounts

To easily tell multiple accounts apart, you can assign a display name to each connected account:

  1. Go to Dashboard > Connect
  2. Click the Edit button next to the account
  3. Enter a name (e.g., "Personal", "Company", "Client X")
  4. Save

This name appears in the project selector.

Disconnecting an Account

To remove a connected account:

  1. Go to Dashboard > Connect
  2. Click Disconnect next to the account
  3. Confirm

Disconnecting removes the token stored in Twins. Your Supabase projects are not affected.

Note: If you have scheduled clones using this account, they will fail after disconnection. Make sure to disable them first.

Token Renewal

OAuth

OAuth tokens expire automatically. Twins renews them in the background — you don't need to do anything.

If renewal fails (for example, if you revoked access from Supabase), you will see a warning on the dashboard. Simply reconnect the account.

PAT

Personal Access Tokens do not expire unless you delete them from the Supabase settings.

Next Steps

PreviousKey ConceptsNextCreating a Clone