deploy
Alguien puso en tu app una comprobación al arrancar: si no están la dirección y la clave de Supabase, para y avisa. Eso es lo que ha pasado. Y es buena noticia, porque este mensaje es mucho más claro que el que saldría sin esa comprobación.
Revisado en agosto de 2026
De paso
Analízala gratis mientras lees. Tarda treinta segundos y no toca nada.
Solo leemos lo que tu app ya le entrega a cualquier visitante.
Diagnóstico
Las credenciales de Supabase viven en un fichero que se queda en tu ordenador y no se sube al publicar, precisamente porque contiene credenciales. El servidor donde corre tu app no lo tiene, así que hay que dárselas a mano en el panel de tu hosting. Si nunca lo hiciste, este es el resultado.
Cuando sí lo hiciste y sigue fallando, casi siempre es una de tres. La primera: el nombre no lleva el prefijo que tu proyecto necesita, VITE_ o NEXT_PUBLIC_ según con qué esté hecho, y sin ese prefijo la variable existe en el servidor pero nunca llega al navegador. La segunda: la diste de alta solo en uno de los entornos, y falla en las previsualizaciones aunque funcione en producción, o al revés. La tercera, la más frustrante: la añadiste bien pero no volviste a desplegar, y las variables se leen al construir la app, no al visitarla.
Un caso aparte: si publicas desde el propio Lovable, Bolt o Replit en vez de desde Vercel, las variables se configuran en el panel de esa herramienta. Tenerlas en Vercel no sirve de nada si quien construye tu app es otro.
Solución
Todo esto se hace en paneles web, sin tocar una línea de código, y por eso el agente que escribió tu app no puede hacerlo por ti. Sigue el orden: cada paso descarta una de las causas.
Truco para no perder tiempo: si en el panel puedes ver el registro del despliegue, busca ahí el nombre de la variable. Si no aparece, no le ha llegado, y no hay nada que arreglar en el código.
Pégaselo tal cual al agente que escribió tu app. Está redactado para que te diga lo que ha hecho, no solo para que lo haga.
Prompt para tu agente
Mi app da el error "Missing Supabase environment variables" al desplegarla, aunque en local funciona. Necesito que hagas esto: 1. Busca en el proyecto la comprobación que lanza ese error y dime exactamente qué nombres de variables está esperando, escritos tal cual. 2. Comprueba que esos nombres llevan el prefijo que necesita este proyecto para llegar al navegador (VITE_ si es Vite, NEXT_PUBLIC_ si es Next.js). Si no lo llevan, corrígelo en el código y en el fichero .env.example. 3. Asegúrate de que el mensaje de error dice qué variable concreta falta, por su nombre, en vez de un mensaje genérico. 4. Comprueba que no hay ningún sitio del código donde la URL o la clave estén escritas directamente en vez de leerse de variables de entorno. Si lo hay, sácalas. Al terminar, dame la lista exacta de variables que tengo que dar de alta en el panel de mi hosting, con el nombre literal de cada una.
Si no sale
O el escáner de arriba ha encontrado algo y prefieres no tocarlo solo. En cualquiera de los dos casos esto ya es de los gordos y merece un humano: no es que no hayas sabido, es que has llegado al punto en que hace falta alguien que entre y lo vea por dentro.
Las 10 primeras apps son gratis. Estoy empezando y necesito casos reales. A cambio te pido permiso para contar después qué me encontré, sin decir de quién era la app ni enseñar tus datos. Sin tarjeta y sin suscripción: cuando se acaben las plazas empezaré a cobrar y lo diré aquí.
Cita a partir de mañana
Gratis
durante el lanzamiento
Elegimos hueco, miro tu app con calma y te digo qué pasa y cómo se arregla.
Hoy, en cola prioritaria
Gratis
durante el lanzamiento
Entras en la cola de hoy. Reservas hueco y lo dejamos resuelto en el día.
Quién
Marc Sala
IT Manager
No es un rating anónimo de un marketplace: es la persona que va a entrar en tu app. Reviso el código, encuentro qué falla y lo arreglo contigo delante, explicándote qué ha pasado sin jerga.
Relacionados