> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoista.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Connect a Supabase organization to watch its projects and create new ones.

Hoista finds the Supabase projects in an organization, with each project's Postgres database, Edge Functions and Storage buckets. Your data stays at Supabase. Hoista shows each project's status, logs and metrics, and can create new projects.

## Connect

Supabase connects with an access token:

1. Open [Access Tokens](https://supabase.com/dashboard/account/tokens): **Account → Access Tokens → Generate new token**. Name it Hoista.
2. Choose all projects in your organization and set **Projects** to read-write, so Hoista can also create new ones.
3. Copy the token before you close the window. It starts with `sbp_`.
4. In Desktop, open **Accounts**, choose Supabase, paste the token and pick the organization.

![Supabase’s Access Tokens page](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/tokens/supabase-token.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=0c91de15f3e4a27d13b5cc53596a8aae)

Supabase’s Access Tokens page, captured November 2026. Personal details are blurred. If yours looks different, the names in the steps still match.

From the CLI:

```bash theme={null}
hoist accounts add supabase
```

Hoista asks for the token in a hidden prompt and finds the organization from it. In scripts, use `hoist accounts add supabase --name NAME --token-stdin`, and add `--account <organization-id>` if the token reaches more than one organization.

If your backend was created by an app builder, the token must belong to a Supabase account that can reach that project.

## What you can do

* Create a new Supabase project.
* Read and change variables on the **Variables** tab.
* See logs on the **Logs** tab and metrics on **Metrics**.
* Use the **Supabase** tab for Supabase's own settings and operations.
* Delete a Supabase project after you confirm it by name.

Supabase's bill isn't shown on **Billing**. See it in the Supabase dashboard. A project on the free plan pauses after a week without use. A paused project shows no other details until you restore it at Supabase.

## Bring in existing resources

Hoista looks for projects when you connect. In Desktop, add them as described in [Bring in an existing project](https://docs.hoista.dev/guides/import-apps.md). From the CLI:

```bash theme={null}
hoist import --list
hoist import <resource-id> --new my-app
```

Projects start in **watching** mode. Run `hoist projects manage my-app` when you want Hoista to make changes. To look again, run `hoist accounts refresh <account>` with the name or ID from `hoist accounts`.

## Related

> [card] [Providers](https://docs.hoista.dev/providers/overview.md)
>
> What Hoista supports on each provider.

> [card] [Connect hosting accounts](https://docs.hoista.dev/guides/accounts.md)
>
> Connect, check and rotate accounts.

> [card] [Bring in a project](https://docs.hoista.dev/guides/import-apps.md)
>
> Add what an account already runs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.