> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Open-source Postgres + storage + realtime. Use as an alternative or supplement to Convex.

[Supabase](https://supabase.com) is an open-source Firebase-style platform — Postgres database, object storage, realtime, and auth.

<Note>
  Most vly apps use Convex as the primary backend. Supabase makes sense as a **secondary** store for cases that benefit from Postgres (existing data, complex SQL, specific extensions).
</Note>

## Common uses

* Connect to an existing Postgres database.
* pgvector for vector search alongside relational queries.
* Row-level security policies you've already authored.

## Setup

`SUPABASE_URL` and `SUPABASE_SERVICE_ROLE_KEY` in vly secrets. Use `@supabase/supabase-js` from a Convex action.

## Related

<CardGroup cols={3}>
  <Card title="Convex overview" icon="database-zap" href="/convex/overview">
    Default backend.
  </Card>

  <Card title="Supabase Auth" icon="key" href="/integrations/supabase-auth">
    The auth half.
  </Card>

  <Card title="MongoDB" icon="database" href="/integrations/mongodb">
    NoSQL alternative.
  </Card>
</CardGroup>


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