Documentación

Empieza aquí

Supabase paso a paso

Crea tu cuenta, tu proyecto y saca tus keys — todo con clicks, antes de tocar código.

Supabase

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

  1. Entra a supabase.comStart your project.
  2. Haz click en Continue with GitHub (usa la misma cuenta de GitHub del curso — así no acumulas contraseñas).
  3. Autoriza el acceso y listo.

Paso 2 · Crea tu proyecto

  1. En el dashboard (supabase.com/dashboard) → New project.
  2. Si te pide una Organization, crea una con cualquier nombre (es solo una carpeta para tus proyectos).
  3. Project name: el nombre de tu producto.
  4. 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.
  5. Region: elige la más cercana a tus usuarios (South America (São Paulo) o US East).
  6. 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ónIcono/nombrePara qué sirve
Table EditortablaVer y editar los datos de tus tablas, como si fuera Excel. Aquí verificas que todo se guardó.
SQL EditorterminalCorrer consultas directamente en la base. Lo usarás poco — tu IA escribe el SQL.
AuthenticationcandadoTus usuarios registrados y los providers de login (aquí activarás Google en Sem 2).
Project Settingsengrane (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):

  1. Abre tu proyecto y haz click en el engrane Project Settings (abajo-izquierda del menú).
  2. Entra a la sección Data API.
  3. 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):

  1. En el mismo Project Settings, entra a la sección API Keys.
  2. Arriba verás pestañas: cámbiate a la de Legacy API Keys (la de las keys clásicas).
  3. En la fila anon (dice public), haz click en Copy → será tu NEXT_PUBLIC_SUPABASE_ANON_KEY.

3 · SUPABASE_SERVICE_ROLE_KEY (la secreta):

  1. En esa misma pestaña Legacy API Keys, baja a la fila service_role (dice secret).
  2. 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:

Terminal
supabase login
supabase link --project-ref <tu-project-ref>
supabase db push

Aquí 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

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í.