Supabase paso a paso: primera tabla y conexión con tu app
Supabase te da backend listo: base de datos, login, archivos y API automática. Tu primera tabla funcionando en 15 minutos, con el paso que no puedes saltarte.
👁 115 lecturas
Supabase te da backend listo para tu aplicación: base de datos, login de usuarios, archivos y API automática, y tu primera tabla funcionando en un cuarto de hora. En este tutorial vamos paso a paso desde un proyecto vacío hasta datos mostrados en tu aplicación, con un paso que no puedes saltarte: la seguridad de la tabla.
Los pasos se basan en las guías oficiales de Supabase. Qué es la plataforma y por qué la eligen tan a menudo quienes construyen con IA lo expliqué en la guía de Supabase.
Antes de empezar: planifica los datos
Antes de crear tu primera tabla, anota en un papel qué datos guarda la aplicación y quién puede verlos. Por ejemplo: las clases las ven todos, la reserva solo la ve quien la hizo y el instructor. De esa nota salen directamente las reglas de acceso que luego escribirás en Row Level Security. Planificar las reglas después de construir la aplicación suele terminar con tablas sin protección.
Paso 1. Proyecto
Después de crear tu cuenta, creas un nuevo proyecto en el panel de tu organización. Introduces el nombre, la contraseña de la base de datos y la región. Guarda la contraseña inmediatamente en tu gestor de contraseñas, porque la necesitarás al conectarte directamente a la base, y elige la región más cercana a tus usuarios, para Europa la más próxima disponible.
En unos minutos el proyecto está listo, y por debajo funciona un PostgreSQL normal que podrás llevarte donde quieras si migras.
Paso 2. Primera tabla
Puedes crear la tabla en el editor de tablas, haciendo clic como en una hoja de cálculo, o en el editor SQL. La guía oficial muestra la versión con SQL Editor: creas una tabla sencilla, por ejemplo una lista de instrumentos con identificador y nombre, y añades algunas filas de ejemplo. Aunque no conozcas SQL, basta con copiar los comandos de la guía y ejecutarlos.
Paso 3. Seguridad de la tabla: Row Level Security
Este es el paso del que depende que tus datos estén seguros. Row Level Security son las reglas que determinan quién puede leer y modificar qué filas. La guía oficial la activa para la tabla y añade una regla que permite a todos solo leer la lista de instrumentos. Para una lista pública está bien. Para datos de clientes la regla debe permitir a cada uno ver únicamente sus propias filas.
Una tabla sin estas reglas, expuesta por la API, es la causa más frecuente de filtraciones en aplicaciones construidas rápido. Lo expliqué más a fondo en la guía. La regla es simple: ninguna tabla con datos de usuarios sale a la aplicación sin reglas de acceso activadas.
Paso 4. URL del proyecto y clave pública
La aplicación necesita dos cosas que encontrarás en el panel Connect de tu proyecto: la URL del proyecto y la clave pública. Las pegas en el archivo de configuración de la aplicación. La clave pública puede ir al navegador, porque el acceso a los datos lo deciden las reglas del paso anterior.
Si la aplicación no ve los datos, comprueba que en la configuración de integración esté activada la Data API.
Paso 5. Conexión con la aplicación
Supabase tiene guías listas para más de una docena de tecnologías, desde Next.js, React y Vue hasta Flutter, Python y Laravel. En el caso de Next.js todo el arranque se reduce a un comando que crea la aplicación con la conexión lista, pegar la URL y la clave, y luego escribir la página que obtiene datos de la tabla. Al ejecutar la aplicación ves en la página las filas añadidas en el paso dos.
Si construyes en Lovable o herramienta similar, la mayoría de estos pasos los hace ella por ti, pero comprobar las reglas de acceso sigue siendo tu responsabilidad.
Paso 6. Login y archivos
Cuando la tabla funciona, los siguientes elementos los añades igual. El login de usuarios lo activas en la sección de autenticación, eligiendo métodos, por ejemplo email o cuenta de Google. Los archivos, como fotos de perfil o adjuntos, los guardas en el almacenamiento de archivos, que también tiene sus propias reglas de acceso. Para lógica más compleja están las funciones que se ejecutan en el servidor.
Errores más frecuentes al empezar
- Tabla sin reglas de acceso expuesta en la aplicación.
- Clave de servicio en el código del navegador en lugar de la clave pública.
- Región al otro lado del mundo, por lo que cada consulta tarda más.
- Falta de copia de seguridad antes de cambios grandes en la estructura de la base.
Cuándo pasar al plan Pro
El plan gratuito basta para aprender y prototipos, pero los proyectos sin uso se pausan en él. Cuando la aplicación tiene usuarios reales, el proyecto no puede dormirse, y entonces el plan Pro deja de ser opcional.
Google · Tus fuentesBrilla más alto en tu Google - con un solo clicAñadir a fuentes preferidas →Cómo comprobar que los datos están seguros
Después de conectar la aplicación inicia sesión como dos personas distintas y comprueba que cada una ve solo sus datos. Es la prueba más simple que detecta los errores más graves. Revisa también en el panel la lista de tablas y asegúrate de que cada una expuesta en la API tiene las reglas de acceso activadas. Supabase avisa en el panel de tablas sin estas reglas, así que conviene no ignorar esos avisos.
More on this from FULGOR
guías·Generador de canciones con IA: cómo crear música y qué no dicenLos generadores de canciones con IA crean temas completos a partir de una descripción. Cuatro cosas que descubrí generando docenas de canciones.