🟢 ¿Qué es y que incluye Supabase?

IMPORTANTE - Antes de Comenzar

La versión self-hosted de Supabase tiene diferencias relevantes respecto a Supabase Cloud (versión administrada):

• No es multi-tenant: cada instalación corresponde a un único proyecto.
• No funciona la pantalla Storage → Files → Settings, ya que es exclusiva de Supabase Cloud.
• No funciona la pantalla Databases → Settings → Connection pooling configuration, también exclusiva de Supabase Cloud.
• A diferencia de Supabase Cloud, muchas configuraciones se realizan mediante el archivo .env y no desde la interfaz gráfica.

¿Qué es Supabase?

Supabase es una plataforma open source que provee un conjunto de herramientas backend listas para usar, construidas sobre PostgreSQL. Su objetivo es ofrecer una alternativa moderna a Firebase, manteniendo la flexibilidad y potencia de una base de datos relacional estándar.

En lugar de abstraer la base de datos, Supabase expone PostgreSQL como el núcleo del producto, agregando servicios comunes que suelen necesitar las aplicaciones modernas: autenticación, almacenamiento de archivos, APIs automáticas y funciones serverless.

Documentación oficial de inicio: 👉 https://supabase.com/docs/guides/getting-started

¿Qué incluye Supabase?

Cada proyecto de Supabase incluye, entre otras cosas:

Base de datos PostgreSQL

• PostgreSQL completo y estándar
• Extensiones nativas (uuid, pgcrypto, full-text search, vector, etc.)
• Migraciones y seeds
• Row Level Security (RLS)

API automática

• API REST generada automáticamente a partir del esquema de la base
• API en tiempo real (Realtime) para cambios en tablas
• Soporte para filtros, ordenamientos y paginación

Autenticación (Auth)

• Registro e inicio de sesión de usuarios
• Email / password
• Magic links
• OAuth (Google, GitHub, etc.)
• Gestión de sesiones y tokens JWT

Storage

• Almacenamiento de archivos (imágenes, documentos, videos, etc.)
• Control de acceso integrado con Auth y RLS
• Buckets públicos y privados

Edge Functions

• Funciones serverless
• Escritas en JavaScript / TypeScript
• Ejecución cerca del usuario

Realtime

• Suscripciones a cambios en la base de datos
• Ideal para chats, dashboards en vivo y notificaciones

Arquitectura de Supabase

Supabase está construido sobre una arquitectura modular:

• PostgreSQL como fuente de verdad
• PostgREST para la API REST automática
• GoTrue para autenticación
• Storage API para archivos
• Realtime para eventos en tiempo real
• Edge Functions para lógica personalizada

El principio clave es que todo gira alrededor de PostgreSQL, evitando lock-in propietario.

Casos de uso

Supabase puede utilizarse en múltiples escenarios. Algunos ejemplos comunes:

AI, Vectores y Embeddings

• Uso de PostgreSQL + extensiones vectoriales
• Búsquedas semánticas
• Integración con modelos de IA

📚 Referencia: https://supabase.com/docs/guides/ai#examples

Aplicaciones SaaS con suscripciones

• Manejo de usuarios
• Roles y permisos
• Integración con pagos

📚 Referencia: https://github.com/vercel/nextjs-subscription-payments#nextjs-subscription-payments-starter

Aplicaciones web y móviles

• CRUDs tradicionales
• Dashboards
• Sistemas de gestión
• Apps en tiempo real

📚 Referencia: https://github.com/supabase-community/partner-gallery-example#supabase-partner-gallery-example

Frameworks y Quickstarts

Supabase ofrece guías oficiales para múltiples frameworks:

Web

• React
• Next.js
• Nuxt
• Vue
• Svelte / SvelteKit
• SolidJS
• Angular

Backend / Fullstack

• Hono
• RedwoodJS
• Refine

Mobile

• Flutter
• Expo React Native
• Android (Kotlin)
• iOS (Swift / SwiftUI)
• Ionic (React, Vue, Angular)

Estas guías explican cómo:

• Crear un proyecto
• Agregar datos de ejemplo
• Autenticar usuarios
• Consultar la base desde la aplicación

📚 Referencia general: https://supabase.com/docs/guides/getting-started