Crear tu primer proyecto

En esta lección vas a crear tu cuenta de Supabase, lanzar un primer proyecto en el free tier y obtener los dos valores que todas tus apps necesitarán: la URL del proyecto y la clave publishable (o anon key). Al terminar, estarán en tu .env y estarás listo para las siguientes lecciones.

Crear una cuenta y un proyecto

Abre database.new en tu navegador. Esta URL redirige directamente a la interfaz de creación de proyectos en el dashboard de Supabase.

Si todavía no tienes cuenta, puedes registrarte con GitHub, Google o un email: es gratuito y no requiere tarjeta bancaria para el free tier.

Una vez conectado, la interfaz te pedirá:

• Organization: mantén la creada por defecto o crea una nueva.
• Name: el nombre de tu proyecto (por ejemplo, mi-primer-proyecto).
• Database Password: genera una contraseña fuerte y guárdala en algún lugar; la necesitarás si te conectas directamente a PostgreSQL.
• Region: elige la región más cercana a tus usuarios. Para empezar, West EU (Ireland) o EU West (Frankfurt) funcionan bien si estás en Europa.
• Plan: selecciona Free.

Haz clic en Create new project. El aprovisionamiento tarda aproximadamente un minuto. Supabase crea una instancia PostgreSQL dedicada para tu proyecto.

Obtener la URL y la clave API

Esta es la parte más importante de la lección. Tu código necesita dos valores para conectarse a Supabase:

• Project URL: la dirección de tu proyecto (algo como https://xyzabc.supabase.co).
• Publishable key (o anon key): una clave pública, segura para exponer en el lado del cliente. Da acceso a tu base con los permisos del rol anon de PostgreSQL, es decir, únicamente lo que autoricen tus políticas RLS.

En el dashboard, ve a Settings > API Keys. Allí encontrarás:

• La URL de tu proyecto en la sección "Project URL".
• La publishable key (o anon key en legacy) en la sección correspondiente.

Nunca copies la secret key (o service_role) en un archivo del lado del cliente ni en un repositorio público: omite todas las políticas de seguridad.

Poner las claves en tu .env

Crea un archivo .env.local en la raíz de tu proyecto y pega tus valores:

NEXT_PUBLIC_SUPABASE_URL=https://xyzabc.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_xxxx

Si trabajas con la convención antigua (anon key), los nombres de variables habituales son:

NEXT_PUBLIC_SUPABASE_URL=https://xyzabc.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGci...

El prefijo NEXT_PUBLIC_ es específico de Next.js: hace que la variable sea accesible en el código del cliente. Para otros frameworks (React + Vite, SvelteKit, etc.), el prefijo cambia (VITE_, PUBLIC_, etc.) pero los valores son idénticos.

Instalar el cliente de Supabase

Para que tu app pueda comunicarse con Supabase, instala el SDK de JavaScript:

$pnpm add @supabase/supabase-js

Opcional - el CLI de Supabase

El CLI de Supabase permite gestionar tu proyecto en local (migraciones, tipos TypeScript generados desde tu esquema, stack local con Docker). Es opcional por ahora: las siguientes lecciones te irán llevando hasta ahí de forma progresiva. Aquí tienes cómo instalarlo si quieres tenerlo desde ya:

En macOS / Linux con Homebrew:

$brew install supabase/tap/supabase

En Windows con Scoop:

$scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase

Vía npm (dependencia local al proyecto):

$pnpm add -D supabase

También puedes invocarlo sin instalación global con npx supabase <comando>.