Publicar una app de Google AI Studio: GitHub, hosting y claves API

Google AI Studio puede generar una app web con interfaz React y código de servidor Node. La vista previa o el enlace compartido de AI Studio sirven para probarla, pero no equivalen a desplegar ese código en tu propio alojamiento. Google ofrece su despliegue en Cloud Run; si quieres gestionar el código desde GitHub y publicarlo con otro proveedor, revisa primero qué partes dependen de Google.

Esta guía describe el camino documentado de Google AI Studio → GitHub → Hostbrid Projects. No hemos conectado una cuenta de AI Studio ni publicado una app de cliente para certificar una migración automática; cada proyecto necesita una prueba propia.

1. Confirma que has creado una app web

En Build mode, Google AI Studio puede crear una aplicación web full-stack o una app nativa para Android. Esta ruta es para la app web. Si has elegido Android, un hosting web no genera una aplicación instalable ni la publica en Play Store.

Antes de mover nada, abre el código y comprueba que la aplicación arranca y que entiendes sus dependencias. En AI Studio, vincula el proyecto a GitHub desde Settings → GitHub o descarga el código como ZIP. La sincronización con GitHub es bidireccional: los cambios pueden viajar de AI Studio al repositorio y del repositorio de vuelta a AI Studio. El ZIP es código para revisar localmente; no es una carga directa al panel de Projects.

2. Revisa qué servicios exige la app

No conviertas una app full-stack en un sitio estático solo para que compile. Busca package.json, identifica los scripts de instalación, construcción e inicio, y confirma si hay rutas de servidor, Firebase, autenticación, almacenamiento o integraciones de Google Workspace.

Projects publica proyectos conectados a Git y también ofrece servicios Node o Docker, pero la documentación pública no certifica una receta automática para migrar una app full-stack de AI Studio. Un backend puede requerir desplegar por separado la interfaz y el servicio, además de revisar sus recursos y el plan. Antes de comprometer la migración, confirma cómo encajan sus procesos, rutas y variables en la arquitectura disponible. Esto tampoco configura automáticamente tus cuentas externas: si usas Firebase, OAuth o una base de datos externa, verifica credenciales, dominios autorizados, reglas y callbacks desde el dominio nuevo.

Si solo tienes una salida HTML estática, sigue la guía para publicar una web HTML creada con IA. Si tienes un proceso Node, revisa además cómo publicar una app Node.js.

3. Conecta el repositorio a Projects

Si la interfaz es estática o el proyecto ya tiene una configuración de build compatible, conecta GitHub en Hostbrid Projects y selecciona el repositorio. Configura como rama de producción la misma rama que quieres publicar. Cada push a esa rama puede iniciar un nuevo despliegue; comprueba también el estado de conexión entre GitHub y Projects. Si has descargado un ZIP, primero extráelo, revisa .gitignore y los archivos que subirás —en especial .env—, y crea un repositorio Git; Projects conecta repositorios, no recibe directamente el ZIP.

Deja que Projects detecte el proyecto y revisa los valores antes del primer deploy. Si hace falta, define el comando de instalación, el comando de build, la carpeta de salida o la subcarpeta del monorepo. No copies valores genéricos sin mirar los scripts reales. Para una salida estática, indica la carpeta que realmente genera la build. Si hay procesos de servidor, comprueba qué servicio los ejecuta y cómo se conecta con la interfaz; una build estática por sí sola no publica endpoints Node.

Después de publicar la interfaz y configurar por separado los servicios que la aplicación necesite, comprueba la URL HTTPS, una ruta interna abierta directamente y las llamadas del navegador al backend. Una build correcta no demuestra que OAuth, la base de datos o las llamadas a Gemini funcionen en producción.

4. Configura la clave Gemini como secreto

En AI Studio, la clave GEMINI_API_KEY puede estar configurada como secreto del servidor. Esa configuración no debe darse por trasladada al nuevo proveedor. Añade la clave en las variables de entorno de Projects y lee el valor desde el servidor. No la pongas en el código React, en una variable VITE_*, en un archivo subido a Git o en los logs.

Google indica que, al descargar una app como ZIP para alojarla en otro lugar, debes configurar GEMINI_API_KEY en el entorno de hosting. Las llamadas a Gemini tienen sus límites y posibles costes de API propios; cambiar de alojamiento no los elimina. Revisa también el comportamiento cuando Google devuelve un error o se agota una cuota.

Si la clave ya llegó al JavaScript publicado

Trata cualquier clave de servidor que haya llegado al navegador como comprometida. Crea una clave de reemplazo y actualiza el secreto del servidor; despliega y verifica que funciona, y después desactiva la clave expuesta sin demora. Si detectas abuso activo, desactívala inmediatamente aunque la aplicación deje de funcionar hasta que despliegues el reemplazo. Revisa la actividad, las cuotas y la facturación: borrar el archivo o el commit no invalida una clave copiada. Elimina la clave del código del frontend y de variables públicas; Vite incorpora al bundle los valores con prefijo VITE_, por lo que no sirven para guardar secretos.

Para comprobar el arreglo, crea un build nuevo y revisa los archivos JavaScript y mapas de fuentes que se sirven públicamente, además de las peticiones de red del navegador. Busca la clave antigua localmente sin pegarla en una web de escaneo ni compartirla en una captura. Confirma que la interfaz llama a tu servidor y que este lee el secreto de una variable de entorno de Projects. El backend debe validar la petición y limitar acceso, frecuencia y uso; un proxy abierto solo traslada el abuso a tu cuenta. Si la clave se subió a Git, retírala también del historial y de los logs, pero conserva la rotación como medida que la invalida.

5. Prueba integraciones y publica el dominio

Prueba la app usando el dominio temporal HTTPS antes de cambiar el dominio definitivo. Verifica inicio de sesión, callbacks OAuth, escritura y lectura de datos, permisos, cargas de archivos y cada llamada a Gemini. Si una integración estaba conectada automáticamente en AI Studio, vuelve a comprobarla en el entorno nuevo en vez de suponer que conservará su configuración.

Cuando esas pruebas pasen, conecta el dominio y vuelve a comprobar certificado HTTPS, rutas, APIs y autenticación. Si la aplicación necesita un servicio gestionado, red, disco o carga sostenida que no encaje en Projects, compara los planes y límites actuales antes de migrarla.

El resultado depende del repositorio y de sus servicios. GitHub facilita transportar y revisar el código; no copia automáticamente secretos, usuarios, datos, cuotas de API ni configuraciones OAuth.

Fuentes: Google AI Studio Build · Claves de Gemini · Variables de entorno de Vite · OWASP: gestión de secretos · Guía de Projects de Hostbrid