Crea y publica una web con IA
Publicar una web React creada con IA en Vercel (2026): Vite, variables y pantalla en blanco
Publica el frontend React + Vite que te ha entregado una IA con GitHub y Vercel. Revisa la compilación, las variables, los errores 404 al recargar y las imágenes antes de compartir la web.

Has creado una web con IA y la descarga trae archivos .tsx, una carpeta src y package.json. Para publicarla, hay que compilar el proyecto y desplegar el resultado. Esta guía utiliza React + Vite como aplicación de una sola página del lado del cliente, con GitHub y Vercel.
El resultado esperado es una dirección HTTPS donde funcionen la portada, las páginas internas y las imágenes. Es un procedimiento basado en documentación oficial, revisada el 20 de noviembre de 2026; no representa una prueba de tu proyecto concreto.
Abre package.json. En un proyecto básico de Vite puedes encontrar estos scripts:
{
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
}
}
Conserva los scripts válidos que ya tenga el proyecto, incluidas las comprobaciones de TypeScript anteriores a la compilación.
| Archivos o configuración | Cómo continuar |
|---|---|
Vite, src, index.html y package.json | Sigue este despliegue de frontend |
| Solo HTML, CSS e imágenes | Consulta la guía para publicar HTML |
next, next build y configuración de Next.js | Utiliza la configuración del framework Next.js |
| Un componente React aislado | Pide a la IA un proyecto completo que se pueda compilar |
| Backend, base de datos o renderizado de servidor | Prepara también el despliegue de esos servicios |
Tener index.html entre los archivos fuente no elimina el paso de compilación. La documentación de despliegue estático de Vite explica qué archivos genera.
Crea un repositorio. Puede ser privado si autorizas su acceso mediante la integración de GitHub de Vercel. Si el creador con IA permite sincronizar con GitHub, utiliza esa opción. Si tienes un ZIP, extráelo y sube su contenido desde GitHub o con un cliente Git.
Incluye el código, las imágenes utilizadas, la configuración y el archivo de bloqueo del gestor de paquetes. Mantén npm, pnpm o Yarn según el proyecto original. Excluye node_modules y los archivos que contengan credenciales. Subir el ZIP sin extraerlo no prepara el proyecto para su compilación.
Comprueba los archivos después del commit. Si están dentro de mi-web/, esa carpeta será el directorio de la aplicación al importarla.
Si ya tienes las dependencias instaladas y el proyecto usa npm, puedes comprobarlo localmente:
npm run build
npm run preview
Revisa la portada y las imágenes en la vista previa. vite preview sirve para verificar la compilación local, no para mantener el sitio en producción. También puedes continuar sin entorno local y revisar los registros de compilación de Vercel.
En Vercel, crea un proyecto, conecta GitHub y selecciona el repositorio. Comprueba estos campos antes de pulsar Deploy. La guía de inicio permite localizar las opciones actuales.
| Campo | Qué comprobar en React + Vite |
|---|---|
| Framework Preset | Vite |
| Root Directory | Carpeta de la aplicación que contiene package.json |
| Build Command | Habitualmente npm run build, según scripts y gestor de paquetes |
| Output Directory | dist, salvo que build.outDir indique otro destino |
Normalmente src y public no son el directorio final de salida. Tampoco uses npm run dev como comando de compilación: inicia un servidor de desarrollo. Consulta la configuración de compilaciones de Vercel antes de cambiar los valores detectados.
Si falla el despliegue, abre Build Logs y localiza el primer error relacionado con el fallo. Si falta el script build, revisa el directorio y package.json; si falta un módulo, comprueba la dependencia y su importación; si no existe el directorio de salida, compáralo con el resultado de la compilación. Corrige el código en el mismo repositorio y sigue el nuevo despliegue.
Una web de presentación puede no necesitar variables. Si utiliza un backend, añádelas en Environment Variables del proyecto y selecciona el entorno correspondiente. Para la primera importación, comprueba los valores de Production; las futuras vistas previas de otras ramas necesitan su configuración de Preview. Consulta los entornos de Vercel.
Un ejemplo de dirección pública del backend:
VITE_API_BASE_URL=https://api.example.com
El código debe utilizar exactamente el mismo nombre:
const apiBaseUrl = import.meta.env.VITE_API_BASE_URL;
Sustituye el dominio de ejemplo por tu API HTTPS real. Vite incorpora los valores VITE_ al código que recibe el navegador. Las claves privadas de modelos, las contraseñas de bases de datos y los tokens de administrador deben permanecer en un backend o una función de servidor con controles de acceso. Cambiar el nombre de una variable no crea ese servicio. Véase la documentación de variables de Vite.
Después de cambiar variables, genera un nuevo despliegue. Las versiones anteriores conservan sus valores, como indica la documentación de Vercel.
Si Network muestra peticiones a localhost:8000, el navegador intenta conectar con el ordenador del visitante. Utiliza la dirección del backend desplegado y comprueba que permita el origen de producción. Valida también el guardado real y la autenticación con la guía de formularios y acceso.
Puedes entrar en /about desde el menú, pero al pegar la URL en otra pestaña aparece un 404. El router del navegador gestiona la navegación interna, mientras que el alojamiento necesita saber qué archivo entregar al recibir esa ruta directamente.
Para una SPA de Vite que solo sirve el frontend, añade vercel.json junto al package.json de la aplicación:
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"rewrites": [
{ "source": "/(.*)", "destination": "/index.html" }
]
}
Haz commit, despliega otra vez y comprueba la visita directa y la recarga de /about. La regla sigue las instrucciones de Vercel para Vite SPA.
El ejemplo presupone que cleanUrls no está activado y que no hay rutas API personalizadas. Si ya existe configuración, integra la regla sin borrar las anteriores. Los proyectos con API, proxy, SSR o rutas propias del framework necesitan una revisión específica. Esta regla tampoco recupera archivos JavaScript que falten.
Abre las herramientas de desarrollo, entra en Console y Network y recarga. Guarda el primer error y la URL, estado y Content-Type de la petición que falla.
| Síntoma | Comprobación |
|---|---|
Un .js devuelve 404 o HTML | Archivos compilados, rutas de recursos, base y reglas de reescritura |
| Falta una imagen | Archivo subido, ruta y coincidencia de mayúsculas |
| La portada devuelve 200 pero está vacía | Error de ejecución y componente afectado |
| El formulario dice «enviado» pero no hay registro | Respuesta de la API y sistema receptor |
| El visitante ve un acceso de Vercel | URL compartida y protección del despliegue |
Normalmente public/cover.png se referencia como /cover.png; los recursos de src se pueden importar para que Vite los procese. Revisa también si quedó un base de un despliegue anterior en subcarpeta. Véase la gestión de recursos de Vite.
Antes de compartir la dirección de producción, ábrela sin sesión iniciada. Comprueba portada, página interna, recarga, móvil y acción principal. Confirma un envío en el destino y el dominio de retorno del acceso. Revisa las condiciones y cuotas del plan según el uso previsto.
Para futuras actualizaciones, haz commit en la rama de producción configurada y revisa ese despliegue. Si una versión rompe la web, sigue la guía de publicación y reversión.