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

# Supabase

> Leverage Supabase as a comprehensive backend-as-a-service platform

## What is it

Supabase is an open-source backend-as-a-service (BaaS) platform that provides developers with a complete set of backend tools including PostgreSQL database, authentication, real-time subscriptions, storage, and auto-generated APIs.

## Why we use it

The Launchpad can run the self-hosted Supabase services when a project needs them. They are excluded by default so the local stack stays smaller, but you can opt in without changing application code.

## Where we use it

By default the Launchpad starts the core application stack: FastAPI, Celery, Redis, and PostgreSQL. The PostgreSQL service uses the `supabase/postgres` image because it includes useful extensions like pgvector, but Supabase Studio, Auth, Realtime, Storage, and the gateway are not started unless you uncomment `docker-compose.supabase.yml` in `docker/docker-compose.yml`.

When enabled, the self-hosted Supabase services offer:

* **Authentication**: User management, OAuth providers, JWT tokens for secure API access
* **Real-time subscriptions**: Live updates for collaborative features, chat applications, or dashboard monitoring
* **Storage**: File uploads for documents, images, or model artifacts with integrated access control
* **Auto-generated APIs**: Instant REST endpoints based on database schema, this makes it easy to build custom frontends
* **Row Level Security**: Fine-grained access control policies for multi-tenant applications

## Further Reading

For advanced Supabase features, Edge Functions, and deployment strategies, refer to the [official Supabase documentation](https://supabase.com/docs).