Clase 02 · Módulo 07
Crear el proyecto y entender las claves
Crear el proyecto y entender las claves
Qué logras en esta clase
Creas tu proyecto de Supabase y sabes exactamente qué dato va en la app y cuál no sale nunca del servidor.
- Eliges nombre, contraseña y región con criterio
- Distingues la clave publicable de la clave secreta
- Dejas la URL y la clave en tu proyecto de Expo
- Sabes qué hacer si una clave se filtra
02
Cuenta, organización y proyecto
- Organización: el grupo donde se factura y se invita gente
- Proyecto: una base Postgres propia con su Auth, su Storage y sus funciones
Cada proyecto está aislado de los demás. El plan gratuito permite 2 proyectos activos: guarda esa cifra, porque en la clase 5 los usarás como «pruebas» y «producción».
03
Crear el proyecto, paso a paso
- Entra a supabase.com y crea tu cuenta o inicia sesión
- Dentro de tu organización, crea un proyecto nuevo
- Ponle nombre
- Define la contraseña de la base de datos
- Elige la región
- Espera a que termine de prepararse: toma unos minutos
No memorices el nombre de cada botón: el panel cambia. Lo que no cambia son las tres decisiones de la lámina siguiente.
04
Tres decisiones al crear
| Decisión | Criterio |
|---|---|
| Nombre | Incluye el entorno: cafeteria-pruebas |
| Contraseña de la base | Generada, larga, guardada en un gestor de contraseñas |
| Región | La más cercana a quienes usarán la app |
El nombre parece un detalle. Cuando tengas dos proyectos casi iguales, es lo que evita que borres datos en el equivocado.
05
La región: cerca de tus usuarios
La región es el lugar físico de los servidores. Mientras más lejos de tus usuarios, más tarda cada consulta.
- Si tu público está en Chile, busca una región de Sudamérica; si no aparece, la más cercana de América
- También define en qué país se alojan los datos, algo que declararás en tu política de privacidad
06
La contraseña de la base no es una clave de la app
La contraseña de la base es la llave maestra de Postgres. No va en la app, ni en el repositorio, ni en un chat.
07
Qué identifica a tu proyecto
Al terminar la creación tienes dos datos que no son secretos:
- URL del proyecto: la dirección a la que tu app le habla, con la forma
https://<ref>.supabase.co - Ref del proyecto: el identificador corto que aparece dentro de esa URL
La URL la usa la app. El ref lo usan las herramientas de terminal para saber a qué proyecto apuntar.
08
El principio que ordena todo
Todo lo que va dentro de la app es público. Cualquier persona con paciencia puede extraerlo del archivo instalado.
09
Dos tipos de clave
| Clave publicable | Clave secreta | |
|---|---|---|
| Empieza con | sb_publishable_ | sb_secret_ |
| Privilegio | Bajo | Elevado |
| Frente a RLS | La respeta | Se la salta por completo |
| Dónde va | En la app | Solo en un servidor |
La publicable identifica a tu proyecto. La secreta abre todo. Confundirlas es el error más caro de este módulo.
10
Por qué la publicable puede ser pública
La clave publicable solo dice «vengo de esta app». Quien decide qué filas se entregan es RLS, dentro de la base.
Por eso la documentación de Supabase es explícita: sin RLS, cualquiera que tenga tu clave publicable puede leer y escribir todas las filas de esa tabla.
11
Dónde vive la clave secreta
Únicamente en código que corre en un servidor:
- Edge Functions de Supabase (módulo 10)
- Un script de administración que ejecutas tú
Nunca en una variable EXPO_PUBLIC_, nunca en el repositorio.
Puedes crear varias claves secretas: una por cada componente de servidor. Si una se filtra, cambias solo esa. Y si tu app todavía no tiene nada de servidor, no necesitas ninguna.
12
Dónde encontrar las claves
- En el panel, el diálogo «Connect» te entrega la URL y la clave publicable ya preparadas para tu framework
- La lista completa de claves, con la opción de crear nuevas, está en «Settings > API Keys»
- Desde la terminal:
supabase projects api-keys
13
Si un tutorial habla de anon y service_role
| Nombre antiguo | Equivale hoy a |
|---|---|
anon | Clave publicable |
service_role | Clave secreta |
Las antiguas son textos muy largos que empiezan con eyJ. Al 18-11-2026 siguen funcionando en paralelo, pero la documentación oficial anuncia su retiro hacia fines de 2026.
En un proyecto nuevo usa solo las claves sb_publishable_ y sb_secret_.
14
Guardar URL y clave en tu proyecto de Expo
Las dos van en un archivo de variables de entorno en la raíz del proyecto:
EXPO_PUBLIC_SUPABASE_URL=https://<ref>.supabase.co
EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_...El prefijo EXPO_PUBLIC_ le dice a Expo «incluye este valor dentro de la app». Es justo lo que quieres para estos dos datos, y justo lo que jamás quieres para una clave secreta.
15
.env, .env.development y Git
- Expo lee los archivos
.env; al ejecutarnpx expo startcarga además.env.development - Mantén los archivos
.envfuera de Git, como viste en el módulo 3 - Cada entorno tendrá sus propios valores: pruebas y producción no comparten URL ni clave
16
Qué no le pegas a Claude
Claude Code necesita la URL y la clave publicable para conectar la app. No necesita:
- la contraseña de la base de datos
- ninguna clave secreta
Si una tarea las requiere, las escribes tú en la terminal o en el panel, como viste en Claude de verdad, módulo 8.
17
Si una clave secreta se filtra
- Crea una clave secreta nueva en el panel
- Cambia tu servidor para que use la nueva
- Comprueba que todo sigue funcionando
- Elimina la clave filtrada
Borrar el archivo del repositorio no arregla nada: el historial de Git la conserva. Lo único que cierra la fuga es invalidar la clave.
18
Regla para no equivocarte
Antes de escribir un valor en la app, pregúntate: ¿me da lo mismo que lo lea un desconocido? Si la respuesta es no, va en el servidor.
19
Errores comunes
- Poner una clave secreta en una variable
EXPO_PUBLIC_ - Usar la contraseña de la base como si fuera una clave de API
- Crear el proyecto sin anotar la contraseña y tener que restablecerla
- Elegir la región por defecto sin mirar dónde están tus usuarios
- Copiar de un tutorial antiguo la clave
service_role«para que funcione»
20
Lo que te llevas
- Un proyecto es una base Postgres aislada, con su URL y su ref
- La contraseña de la base y las claves secretas nunca van en la app
- La clave publicable sí va en la app, y es segura solo con RLS activado
EXPO_PUBLIC_significa «visible para cualquiera»- Una clave filtrada se invalida y se reemplaza, no se esconde
21
Hazlo ahora
Quince minutos:
- Crea un proyecto llamado con tu app y el sufijo
-pruebas - Guarda la contraseña de la base en tu gestor de contraseñas
- Copia la URL y la clave publicable
- Con Claude Code, crea el archivo de variables y verifica que Git lo ignora
- Comprueba que tu clave empieza con
sb_publishable_
No crees ninguna clave secreta todavía: no la necesitas.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Supabase Docs: claves de API (publicable, secreta y antiguas)supabase.com ↗
- Supabase Docs: Expo y React Native, cliente y variables de entornosupabase.com ↗
- Supabase Docs: tablas y datos (qué pasa sin RLS)supabase.com ↗
- Supabase: precios y límites de cada plansupabase.com ↗
- Expo: novedades del SDK 58 (variables de entorno)expo.dev ↗