Empieza aquí
Supabase paso a paso
Crea tu cuenta, tu proyecto y saca tus keys — todo con clicks, antes de tocar código.
Supabase es donde vive tu base de datos y el login de tus usuarios, en la nube. Antes de correr el proyecto necesitas tener esto listo — y todo se hace con clicks en su página, sin código.
Al final de esta página vas a tener:
- ✅ Tu cuenta de Supabase creada.
- ✅ Un proyecto creado y encendido (tu base de datos viva en la nube).
- ✅ Tus 3 keys copiadas y a la mano.
- ✅ Ubicación básica en el dashboard (qué es cada sección).
Tiempo estimado: 10 minutos.
Paso 1 · Crea tu cuenta
- Entra a supabase.com → Start your project.
- Haz click en Continue with GitHub (usa la misma cuenta de GitHub del curso — así no acumulas contraseñas).
- Autoriza el acceso y listo.
Paso 2 · Crea tu proyecto
- En el dashboard (supabase.com/dashboard) → New project.
- Si te pide una Organization, crea una con cualquier nombre (es solo una carpeta para tus proyectos).
- Project name: el nombre de tu producto.
- Database Password: Supabase te pide definir una contraseña para tu base de datos. Usa el botón Generate a password y guárdala en un lugar seguro (un gestor de contraseñas o una nota) — la terminal te la puede pedir más adelante y no se puede ver después, solo resetear.
- Region: elige la más cercana a tus usuarios (
South America (São Paulo)oUS East). - Create new project. Tarda 1–2 minutos en quedar listo (a esto le llaman provisionar) — la pantalla te avisa.
La contraseña de la base de datos NO es tu contraseña de Supabase
Son dos cosas distintas: con GitHub entras al dashboard; la Database Password es la llave de la base de datos en sí, y te la pedirá el comando supabase link cuando conectes el proyecto desde tu compu. Si la pierdes: Project Settings → Database → Reset database password.
Paso 3 · Ubícate en el dashboard
No necesitas dominarlo hoy, pero estas 4 secciones (menú izquierdo) son las que vas a usar durante el curso:
| Sección | Icono/nombre | Para qué sirve |
|---|---|---|
| Table Editor | tabla | Ver y editar los datos de tus tablas, como si fuera Excel. Aquí verificas que todo se guardó. |
| SQL Editor | terminal | Correr consultas directamente en la base. Lo usarás poco — tu IA escribe el SQL. |
| Authentication | candado | Tus usuarios registrados y los providers de login (aquí activarás Google en Sem 2). |
| Project Settings | engrane (abajo) | Las keys, la contraseña de la base y la configuración general. |
Paso 4 · Saca tus 3 keys
Tu app necesita 3 valores para hablar con Supabase. Cópialos a un bloc de notas — los vas a pegar en web/.env.local durante el Quick start. Uno por uno:
1 · NEXT_PUBLIC_SUPABASE_URL (la dirección de tu proyecto):
- Abre tu proyecto y haz click en el engrane Project Settings (abajo-izquierda del menú).
- Entra a la sección Data API.
- Copia el campo Project URL → será tu
NEXT_PUBLIC_SUPABASE_URL. (También la ves en el botón verde Connect, arriba junto al nombre del proyecto.)
2 · NEXT_PUBLIC_SUPABASE_ANON_KEY (la key pública):
- En el mismo Project Settings, entra a la sección API Keys.
- Arriba verás pestañas: cámbiate a la de Legacy API Keys (la de las keys clásicas).
- En la fila
anon(dice public), haz click en Copy → será tuNEXT_PUBLIC_SUPABASE_ANON_KEY.
3 · SUPABASE_SERVICE_ROLE_KEY (la secreta):
- En esa misma pestaña Legacy API Keys, baja a la fila
service_role(dice secret). - Haz click en Reveal para mostrarla y cópiala → será tu
SUPABASE_SERVICE_ROLE_KEY.
¿Ves keys que empiezan con sb_publishable_ o sb_secret_?
Estás en la pestaña de las keys nuevas de Supabase. Este proyecto usa las clásicas: cámbiate a la pestaña Legacy API Keys — las correctas son cadenas largas que empiezan con eyJ....
¿Cómo se ve cada valor?
La URL termina en .supabase.co (ej. https://abcd1234.supabase.co). Las dos keys son cadenas largas que empiezan con eyJ....
La service_role es secreta
Es la llave maestra de tu base de datos. Nunca la subas a git, nunca la pegues en el navegador ni la compartas. La anon sí es pública (por eso lleva NEXT_PUBLIC_).
Paso 5 · Sube las tablas (esto se hace después, con el repo)
El schema (las tablas pre-armadas del boilerplate) se sube desde tu computadora cuando ya clonaste el repo — es el Paso 6 del Quick start. Los comandos son:
supabase login
supabase link --project-ref <tu-project-ref>
supabase db pushAquí tienes que cambiar <tu-project-ref>
Es el identificador de tu proyecto: está en la URL del dashboard (https://supabase.com/dashboard/project/TU-REF — esa parte final) o en Project Settings → General → Reference ID. Si supabase link te pide contraseña, es la Database Password del Paso 2.
Cómo verificar que funcionó: abre Table Editor en el dashboard. Deberías ver las tablas del boilerplate: profiles, waitlist, core_items, ai_conversations, ai_messages, tool_calls, events. Si aparecen, tu base está lista.
Checkpoint
✅ Entras a supabase.com/dashboard y ves tu proyecto con estado activo (verde). ✅ Tienes tus 3 keys copiadas en un lugar a la mano. ✅ Guardaste la Database Password en un lugar seguro.
Con eso estás listo para el Quick start. El Paso 5 (subir tablas) lo harás desde ahí.