Backend de Supabase (conéctalo una sola vez)

1Qué te da conectar Supabase#

De forma predeterminada, una app generada con IA guarda sus datos en el único teléfono donde está instalada: modo «Sin conexión». Conecta Supabase y la misma app tendrá una base de datos real en la nube (Postgres), cuentas de usuario y almacenamiento de archivos, para que los datos se compartan entre dispositivos y usuarios.

Es CON TU PROPIA CUENTA: la app se comunica con TU proyecto gratuito de Supabase. AppMint no aloja nada por ti ni cobra nada extra por ello.

No diseñas tablas ni escribes SQL. AppMint deduce el esquema a partir de la descripción de tu app, lo aplica y lo mantiene sincronizado en cada compilación.

2Lo que necesitas primero#

Una cuenta gratuita de Supabase, y nada más. NO necesitas crear un proyecto antes; AppMint puede crear uno por ti durante el inicio de sesión.

Cosas que conviene saber del plan gratuito:

• 2 proyectos por organización.
• Los proyectos se pausan tras una semana sin tráfico y se reactivan con la siguiente solicitud.

Si ya tienes un proyecto que quieres reutilizar, también funciona: AppMint pone cada app en su propio esquema dentro de él, así que varias apps pueden compartir un proyecto.

3Conéctalo (un toque, recomendado)#

En AI Studio, bajo «DONDE VIVEN LOS DATOS DE TU APP», toca la tarjeta «Supabase» (dice «Toca para conectar»). Elige «Iniciar sesión con OAuth».

Tu navegador abre Supabase, inicias sesión y apruebas AppMint, y vuelves a la app automáticamente: no hay ningún token que copiar.

Lo mismo está disponible desde el engranaje ⚙ Ajustes → «BACKEND - SUPABASE» → «🔗 Conectar Supabase (OAuth)».

Crear una cuenta gratuita de Supabase →

4Elige o crea el proyecto#

Justo después de aprobar, AppMint muestra «Elige un proyecto de Supabase»:

• Elige un proyecto existente, o
• Toca «➕ Crear proyecto nuevo…» → elige la organización → ponle nombre (p. ej., appmint-prod) → elige una región cercana a tus usuarios (no se puede cambiar después) → «Crear». La creación tarda 1-2 minutos.

Cuando AppMint crea el proyecto, muestra la contraseña de la base de datos UNA sola vez, porque Supabase solo guarda un hash de ella. Cópiala en un lugar seguro antes de cerrar ese cuadro de diálogo: no la necesitas para AppMint, pero sí para conectar cualquier otra herramienta.

¿Llegaste al límite del plan gratuito («El plan gratuito permite 2 proyectos por organización»)? Elige un proyecto existente o mejora el plan en el panel de Supabase.

5O conecta manualmente (autoalojado / sin OAuth)#

Ajustes → «BACKEND - SUPABASE» → «MANUAL / AUTOALOJADO»:

1. URL del proyecto: desde tu panel de Supabase, Project Settings → API. Se ve así: https://YOUR-PROJECT-REF.supabase.co
2. Clave anon: la clave publicable de la misma página; empieza con «eyJ». Esta clave está pensada para ser pública: lo que protege tus datos es la seguridad a nivel de fila, no ocultar la clave.
3. Activa «Habilitar el backend de Supabase para las apps generadas» y toca «Guardar configuración de Supabase».

Marca «Instancia autoalojada» si ejecutas Supabase tú mismo. El modo manual no puede desplegar el esquema automáticamente en Cloud: añade un token de acceso personal (siguiente paso) si lo quieres.

Project URL   https://abcdefghijkl.supabase.co
anon key      eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

6Lo que hace AppMint en cada compilación#

Una vez conectado, cada generación hace el trabajo del backend por ti:

• Aplica el esquema que escribió la IA (tablas, índices, políticas de seguridad a nivel de fila).
• Ejecuta los datos iniciales, si la app los necesita.
• Crea buckets de Storage para subidas e imágenes.
• Despliega funciones Edge (pagos, correo, webhooks) y omite las que no han cambiado.
• Configura los proveedores de autenticación y la Site URL.
• Ejecuta una verificación de seguridad y otra de migración, y luego trae los tipos de TypeScript de vuelta al proyecto.

Las tablas de tu app viven en su propio esquema llamado appmint_<tu app>. Las cuentas de usuario se comparten entre todas las apps del proyecto, así que un solo registro sirve en todas.

7Comprueba que funcionó#

Dos comprobaciones rápidas:

• La tarjeta «Supabase» en AI Studio ahora dice «Conectado», y Ajustes muestra la referencia del proyecto.
• Ajustes → «DIAGNÓSTICO» → «⚡ Probar conexión con Supabase»: informa del éxito o del error exacto.

Después de generar una app, abre tu panel de Supabase → Table Editor y cambia el selector de esquema de «public» a appmint_<tu app> para ver las tablas que creó AppMint.

8Qué claves son seguras y dónde#

• Clave anon: es segura dentro de las apps generadas. La seguridad a nivel de fila decide qué puede leer o escribir cada usuario con sesión iniciada.
• Clave service_role: NUNCA va dentro de una app. AppMint la guarda cifrada solo en este dispositivo y la usa para los buckets de Storage y para aplicar el esquema en instancias autoalojadas.
• Token de acceso personal (sbp_…): también solo en el dispositivo; permite a AppMint desplegar el esquema y las funciones Edge en Supabase Cloud automáticamente. Crea uno en supabase.com/dashboard/account/tokens con alcance de lectura y escritura del proyecto.

Las dos claves opcionales están en Ajustes → «AVANZADO - CREDENCIALES DE DESPLIEGUE».

Crear un token de acceso personal →

9Desbloquea: Google Sign-In, Stripe, Actualización remota#

Varias funciones necesitan Supabase conectado primero y te enviarán aquí hasta que lo esté:

• «Continuar con Google» en las apps generadas.
• Pagos con Stripe (el pago se ejecuta en una función Edge de tu proyecto).
• Actualización remota: las actualizaciones que envías a las apps instaladas se guardan en tu propio proyecto de Supabase.

Conecta una vez y las tres quedan disponibles; no tienes que repetirlo en cada app.

10Eliminar el backend de una app#

Ajustes → «ZONA DE PELIGRO» (visible cuando estás conectado):

• «📋 Ver y eliminar tablas del proyecto»: explora todas las tablas que creó AppMint y elimina las que ya no necesites.
• «🗑 Eliminar todo el backend de esta app»: elimina el esquema de esa app y, opcionalmente, sus buckets de Storage y sus funciones Edge. Escribes DELETE para confirmar.

Elige «Solo datos» si tienes dudas: los buckets y las funciones Edge se comparten en todo el proyecto, no por app. Tus cuentas de usuario nunca se tocan.

Para desconectar por completo: Ajustes → «OAUTH CON UN TOQUE» → «🔒 Desconectar OAuth de Supabase».

11Si algo no funciona#

• «No conectado» después de iniciar sesión → el OAuth terminó pero aún no hay ningún proyecto vinculado. Ajustes → «Elegir proyecto».
• Una advertencia de que la clave anon no se obtuvo automáticamente → a tu aprobación de OAuth de Supabase le falta el permiso Secrets:Read. Copia la clave anon desde Project Settings → API y pégala en Ajustes (paso 5).
• «No se pudieron listar tus organizaciones de Supabase» al crear un proyecto → crea el proyecto en el panel de Supabase, vuelve y elígelo.
• «Conecta Supabase primero» en Actualización remota o en Stripe → este capítulo, paso 3.
• Las lecturas o escrituras de datos fallan en una app generada → ejecuta primero «⚡ Probar conexión con Supabase»; si pasa, pide a la IA que corrija la política de seguridad a nivel de fila de la tabla que nombre.