Recorrido del Dashboard de Supabase

El dashboard de Supabase es donde vas a pasar buena parte de tu tiempo, sobre todo al principio. Desde ahí puedes crear tablas, escribir queries SQL, ver usuarios, gestionar archivos y monitorear tu proyecto. Esta guía te muestra cada sección para que sepas dónde está todo.

Vista general

Cuando entras a tu proyecto en supabase.com/dashboard, lo primero que ves es el home del proyecto. Acá tienes un resumen rápido:

• Estado del proyecto (activo, pausado, etc.)
• Uso de la base de datos (almacenamiento consumido, conexiones activas)
• Requests a la API en las últimas horas
• Accesos directos a las secciones más usadas

La barra lateral izquierda es tu menú principal. Desde ahí navegas a todas las herramientas.

Table Editor

El Table Editor es una interfaz visual para gestionar tus tablas de PostgreSQL. Piénsalo como una hoja de cálculo conectada directo a tu base de datos.

Crear una tabla

1. Ve a Table Editor en la barra lateral
2. Haz clic en New Table
3. Escribe el nombre de la tabla (usa snake_case: user_profiles, blog_posts)
4. Agrega las columnas que necesites definiendo nombre, tipo y restricciones

Cada tabla que crees viene con una columna id de tipo int8 (bigint) con auto-incremento por defecto. También puedes elegir uuid como tipo de ID si prefieres identificadores únicos universales.

Editar datos

Puedes insertar, editar y eliminar filas directamente desde el Table Editor. Haz clic en una celda para editarla, usa el botón Insert row para agregar filas, o selecciona filas y elimínalas.

Es útil para cargar datos de prueba rápido sin escribir SQL ni hacer requests desde tu app.

Filtros y ordenamiento

Arriba de la tabla tienes botones para filtrar y ordenar. Puedes filtrar por cualquier columna con operadores como equals, contains, greater than, etc. Los filtros no modifican tus datos, solo cambian lo que ves.

SQL Editor

El SQL Editor es donde escribes y ejecutas queries SQL directamente contra tu base de datos PostgreSQL. Si sabes SQL, esta es la herramienta más poderosa del dashboard.

Ejecutar queries

Escribe tu query en el editor y haz clic en Run (o presiona Cmd+Enter / Ctrl+Enter). Los resultados aparecen abajo en formato de tabla.

SELECT id, title, created_at
FROM posts
WHERE published = true
ORDER BY created_at DESC
LIMIT 20;

Queries guardadas

Puedes guardar queries que uses frecuentemente haciendo clic en Save arriba del editor. Le pones un nombre descriptivo y las encuentras en la sección Saved queries del panel lateral del SQL Editor.

Crear tablas con SQL

Si prefieres escribir SQL en vez de usar el Table Editor visual:

CREATE TABLE posts (
  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
  title text NOT NULL,
  content text,
  author_id uuid REFERENCES auth.users(id),
  published boolean DEFAULT false,
  created_at timestamptz DEFAULT now()
);
 
-- Habilitar RLS
ALTER TABLE posts ENABLE ROW LEVEL SECURITY;

El SQL Editor ejecuta lo que le des. No hay restricciones artificiales -- tienes acceso al PostgreSQL completo.

Auth

La sección de Auth te muestra todo lo relacionado con la autenticación de usuarios en tu proyecto.

Users

En Authentication > Users ves la lista completa de usuarios registrados con:

• UID: el identificador único del usuario
• Email: el correo con el que se registró
• Phone: si usas autenticación por teléfono
• Provider: cómo se registró (email, Google, GitHub, etc.)
• Created at: cuándo se creó la cuenta
• Last sign in: la última vez que inició sesión

Puedes buscar usuarios por email, eliminarlos o enviarles un enlace para restablecer su contraseña.

Providers

En Authentication > Providers configuras los métodos de autenticación que tu app soporta:

• Email: registro con email y contraseña (habilitado por defecto)
• Phone: autenticación vía SMS
• OAuth: Google, GitHub, GitLab, Discord, Apple, y varios más

Cada provider de OAuth requiere que configures el Client ID y el Client Secret que te da el servicio externo.

Policies (desde Auth)

Aunque las políticas de RLS se configuran por tabla, desde la sección de Auth puedes tener una vista general de cómo están protegidos tus datos en relación a los usuarios autenticados.

Storage

Storage es el sistema de almacenamiento de archivos de Supabase. Funciona con buckets (contenedores) que agrupan archivos de un tipo o propósito.

Crear un bucket

1. Ve a Storage en la barra lateral
2. Haz clic en New bucket
3. Ponle un nombre (por ejemplo, avatars, documents, images)
4. Define si es público o privado:
   • Público: cualquiera con la URL puede acceder al archivo
   • Privado: requiere autenticación o una URL firmada (signed URL -- una URL temporal con permiso de acceso)

Gestionar archivos

Desde el dashboard puedes:

• Subir archivos arrastrando o haciendo clic
• Crear carpetas dentro de los buckets
• Copiar la URL pública de un archivo
• Eliminar archivos

Edge Functions

Las Edge Functions son funciones serverless que corren en Deno. En el dashboard puedes ver las funciones que tienes deployadas, pero para crearlas y deployarlas necesitas el Supabase CLI.

En la sección de Edge Functions del dashboard ves:

• Lista de funciones deployadas con su nombre y URL
• Logs de ejecución de cada función
• Métricas básicas (invocaciones, errores, latencia)

Cada función tiene su propio endpoint. Por ejemplo, si tu función se llama send-email, su URL es:

https://tu-proyecto.supabase.co/functions/v1/send-email

Logs

La sección de Logs te da acceso al monitoreo de tu proyecto. Hay varios tipos de logs disponibles:

API Logs

Cada request que llega a tu proyecto queda registrado. Puedes ver:

• El endpoint al que se hizo el request
• El método HTTP (GET, POST, PATCH, DELETE)
• El código de respuesta (200, 401, 500, etc.)
• La latencia

Esto es útil para debuggear cuando algo no funciona. Si tu app recibe un error 401, acá puedes confirmar que el request efectivamente llegó y que el problema es de autenticación.

Auth Logs

Registros específicos de autenticación: intentos de login exitosos y fallidos, registros de nuevos usuarios, envío de magic links, etc.

Postgres Logs

Logs directos de PostgreSQL. Acá ves queries lentas, errores de la base de datos y mensajes del motor de PostgreSQL.

Settings

La sección de Settings es donde configuras todo lo que no tiene una sección propia.

General

• Nombre del proyecto: puedes renombrarlo
• Región: dónde está hosteado (no se puede cambiar después de crear el proyecto)
• Pausar/Eliminar proyecto: los proyectos del free tier se pausan automáticamente después de inactividad

API

Acá encuentras las keys que tu app necesita:

• Project URL: la URL de tu proyecto (https://xxxxx.supabase.co)
• anon key: la clave pública para el cliente
• service_role key: la clave secreta para el servidor

También ves la documentación auto-generada de tu API basada en tu esquema actual.

Database

Configuración de la base de datos:

• Connection string: el string de conexión directa a PostgreSQL (lo necesitas si usas un ORM como Prisma o Drizzle)
• Connection pooling: configuración del pooler (PgBouncer) para manejar muchas conexiones concurrentes
• Extensions: habilitar extensiones de PostgreSQL (pgvector, pg_trgm, uuid-ossp, etc.)
• Backups: en el plan Pro, puedes ver y descargar backups

Auth Settings

Configuración global de autenticación:

• Site URL: la URL de tu app en producción
• Redirect URLs: URLs permitidas para redirección después de OAuth
• JWT expiry: cuánto dura un token antes de expirar
• Email templates: personalizar los emails de confirmación, reseteo de contraseña, etc.

Tips para usar el dashboard eficientemente

Usa el SQL Editor como tu herramienta principal

El Table Editor es cómodo para explorar datos, pero para cualquier cosa seria, usa SQL. Es más rápido, más preciso y puedes guardar tus queries para reutilizarlas. Además, las queries que escribas en el SQL Editor las puedes copiar directamente a tus archivos de migración.

Revisa los logs cuando algo falla

Antes de buscar el error en tu código, revisa los logs. Muchas veces el problema es un 401 (token expirado), un 403 (RLS bloqueando la operación) o un 404 (tabla o función que no existe). Los logs te dicen exactamente qué pasó.

Aprende los atajos del SQL Editor

• Cmd+Enter (Mac) o Ctrl+Enter (Windows/Linux): ejecutar query
• Selecciona solo una parte del texto y ejecuta: corre solo esa porción

No dependas del dashboard para todo

El dashboard es genial para explorar y prototipar. Pero para un proyecto real, necesitas el Supabase CLI para manejar migraciones, desarrollar localmente y deployear Edge Functions. El dashboard es tu ventana, el CLI es tu herramienta de trabajo.