Un panel desarrollado con ayuda de IA también necesita una revisión antes de publicarse. Antes de su primer lanzamiento en Vercel, alguien debe revisar el código generado, los datos que puede leer o modificar y quién podrá acceder a las páginas desplegadas. Esta guía parte de un panel existente que funciona localmente. Sigue las instrucciones actuales de la interfaz de línea de comandos de Vercel, comprobadas el 20 de octubre de 2026; BIG CHANGE no creó ni desplegó una aplicación de ejemplo.

El gran cambio

  • Qué cambió: Un panel local desarrollado con ayuda de IA puede convertirse en un despliegue de producción público con su primer vercel deploy. La puesta en producción puede llegar antes de que el equipo haya creado una vista previa.
  • Por qué importa: Quien publica la aplicación debe comprobar las dependencias generadas, las consultas de datos, los secretos y los accesos antes de ese comando. Una pantalla local que funciona dice poco sobre quién puede abrir el dominio de producción o qué puede leer el servidor.
  • Qué vigilar: La evidencia decisiva es el despliegue real y sus comprobaciones de acceso: URL de producción, identidad de la compilación, rutas representativas, registros y visitantes autorizados y rechazados. Los cambios posteriores pueden usar vistas previas, pero una compilación de producción utiliza sus propias variables y requiere las mismas comprobaciones.

1. Revisa el panel y decide quién podrá usarlo

Necesitas el código fuente autorizado de un panel que funcione localmente, el comando de compilación reproducible de su framework, acceso a su fuente de datos aprobada y permiso para crear un despliegue de producción en el equipo de Vercel previsto. Instala la interfaz de línea de comandos actual de Vercel y ten acceso a esa cuenta, una cuenta de prueba para un visitante autorizado y una forma independiente de comprobar un visitante rechazado. Comprueba que Vercel admite el framework y la configuración de compilación de la aplicación; esta guía no puede proporcionar comandos para un código desconocido.

Revisa los archivos generados por IA como código destinado a producción. Lee las dependencias y los scripts de los paquetes, la configuración del framework, las rutas del servidor y el código del navegador. Sigue cada solicitud de datos: adónde va, qué credencial usa, qué devuelve y si alguna ruta escribe datos. Comprueba que el código entregado al navegador no contiene claves privadas ni registros no autorizados y que las rutas del servidor aplican los permisos del usuario previsto. Ejecuta la compilación propia de la aplicación y una vista representativa del panel con datos de prueba aprobados. Resuelve las advertencias de dependencias, los fallos de compilación y los datos incorrectos antes de subirlo. Elimina las credenciales incrustadas; si alguna entró en el control de versiones, cámbiala en su proveedor. Un repositorio privado no convierte en privado un panel desplegado.

Decide quién podrá abrir el panel de producción antes de vincularlo a un proyecto. Standard Protection deja públicos los dominios de producción. All Deployments cubre los dominios de producción y las URL generadas; con Vercel Authentication está disponible en todos los planes, pero los visitantes necesitan el acceso apropiado a Vercel. No sirve como inicio de sesión para cualquier cliente. Para clientes u otros usuarios externos, diseña y prueba la autenticación y autorización propias del panel o elige otro método de protección adecuado al público y al plan. La protección del alojamiento no sustituye las comprobaciones de las rutas de datos de la aplicación.

Revisa el plan de la cuenta y su página de uso. El plan Hobby de Vercel es para uso personal no comercial; un panel empresarial necesita un plan de pago adecuado. El alojamiento, las funciones, la transferencia de datos y los servicios externos de modelos o bases de datos pueden tener costes y límites separados. Los precios y límites actuales corresponden a la cuenta prevista: revísalos antes de autorizar el lanzamiento.

2. Vincula el proyecto y configura los accesos y las variables

Desde el directorio local del panel, inicia sesión en la interfaz de línea de comandos actual de Vercel con la cuenta prevista y vincula el directorio:

Terminal
vercel link

El comando interactivo selecciona un equipo y un proyecto, o crea un proyecto si hace falta. Vincularlo no lo despliega. Compara el equipo y el proyecto seleccionados, el ajuste del framework, el directorio raíz, el comando de compilación y la configuración de salida de Vercel con el código revisado. Si algún ajuste es incierto, detente antes de desplegar y resuélvelo en la configuración del proyecto y la compilación local.

Ahora abre en ese proyecto Settings → Deployment Protection. Selecciona el método y el alcance elegidos en el paso 1 y verifica que el ajuste guardado cubra el dominio de producción y las URL generadas como esperabas. Inspecciona las excepciones y los enlaces compartibles. Hazlo antes del primer despliegue; no puedes comprobar la configuración de un proyecto nuevo hasta que exista.

En Settings → Environment Variables, introduce cada nombre, valor, tipo y entorno de destino necesario. Pon las credenciales en Secret, cuyo valor no puede leerse tras guardarlo; usa Config para los valores que los miembros autorizados del proyecto puedan leer después. No pongas credenciales del servidor en variables que el framework exponga al navegador. Asigna a Development, Preview y Production los valores y permisos previstos, con datos de servidor separados cuando corresponda. El comando de listado ayuda a comprobar nombres y destinos sin mostrar valores secretos:

Terminal
vercel env ls

Guardar o cambiar una variable afecta a los nuevos despliegues, no a los anteriores. Un Secret guardado no puede recuperarse después para configurar un portátil; no cuentes con vercel env pull ni con vercel env run para recuperarlo. Obtén del proveedor una credencial de desarrollo independiente y autorizada y sigue la configuración local de tu framework. Ejecuta la aplicación local y repite la consulta de datos permitida y la prueba de usuario rechazado con ese entorno de desarrollo. Si la aplicación o el proveedor tiene un flujo de autenticación especial, sigue su procedimiento documentado antes de continuar.

3. Aprueba y comprueba la primera puesta en producción

Pide al responsable que apruebe este primer lanzamiento concreto tras comprobar código, datos, accesos, variables, plan y compilación. La guía de Vercel indica que el primer vercel deploy de un proyecto nuevo crea un despliegue de producción incluso sin --prod. Trata el siguiente comando como una acción de producción:

Terminal
vercel deploy

Conserva la URL devuelta y busca el identificador del despliegue en el panel de Vercel. Confirma que terminó la compilación, que el entorno de producción y el código fuente son los aprobados y que el dominio asignado es el previsto. Comprueba la raíz y cada ruta real del panel o de la API elegida para revisión, sustituyendo los marcadores entre corchetes angulares por la URL devuelta y tus rutas reales:

Terminal
vercel curl / --deployment <production-url>
vercel curl /your-real-route --deployment <production-url>
vercel logs --environment production --level error --since 5m

La respuesta de la ruta debe corresponder a la página o al comportamiento de datos permitido esperado; investiga los errores en los registros de compilación o ejecución. vercel curl puede superar la protección del despliegue, por lo que su éxito no demuestra que la página sea privada. En un navegador normal, abre el dominio de producción y la URL generada sin iniciar sesión y confirma el rechazo donde se necesite controlar el acceso. Después entra como visitante autorizado y comprueba el panel y su ruta de datos permitida. Prueba también con un visitante que no deba ver esos datos. Registra la URL real, el identificador del despliegue, las respuestas de las rutas, los resultados de los visitantes y el resultado pertinente de los registros de errores. Esta es la comprobación de finalización, no la simple devolución de una URL.

Si el resultado del primer comando es incierto, inspecciona ese despliegue exacto en el panel del proyecto antes de repetirlo. Un fallo de compilación exige consultar su registro y corregir localmente dependencias o ajustes del framework, seguido de un nuevo despliegue aprobado. Una variable ausente exige revisar su destino y tipo, guardar un valor corregido y volver a desplegar. Si el panel aparece vacío o falla una ruta de datos, compara la solicitud del navegador con los registros de ejecución, la dirección del servidor, los orígenes permitidos y los permisos del servidor; después repite las comprobaciones de la ruta y del acceso afectados.

Si se hacen públicos datos sensibles de forma inesperada, el propietario autorizado del proyecto puede elegir de inmediato All Deployments with Vercel Authentication en Deployment Protection y confirmar el rechazo tanto en el dominio de producción como en las URL generadas desde un navegador sin sesión. Revisa excepciones y enlaces compartidos, y revoca en el proveedor las credenciales del servidor expuestas. Esta restricción temporal solo admite usuarios de Vercel adecuados y puede interrumpir accesos previstos. Corrige la aplicación y el diseño de acceso, aprueba un nuevo despliegue y verifica visitantes autorizados y rechazados antes de reabrir. Un primer lanzamiento puede no tener un despliegue anterior al que volver; restringir el acceso no deshace una divulgación ya ocurrida.

4. Usa vistas previas para cambios posteriores

Una vez que el proyecto tiene un despliegue de producción, Vercel documenta vercel deploy como despliegue de vista previa con variables Preview. Revisa el código modificado y la compilación local, despliega la vista previa y registra su URL y su identificador en el panel:

Terminal
vercel deploy
vercel curl / --deployment <preview-url>
vercel logs --deployment <preview-deployment-id> --level error

Comprueba el panel modificado en un navegador con datos de prueba aprobados, sus rutas, los accesos previstos y el rechazo de usuarios. Cuando el responsable apruebe esa revisión para producción, despliégala expresamente y repite las comprobaciones de URL de producción, rutas, registros y visitantes:

Terminal
vercel deploy --prod
vercel curl / --deployment <production-url>
vercel logs --environment production --level error --since 5m

Producción es una compilación nueva con variables Production; una vista previa correcta no demuestra que funcionen esas credenciales o rutas de datos. Si hay un repositorio Git conectado, comprueba la rama de producción configurada antes de depender de despliegues automáticos, que siguen una vía distinta de estos comandos manuales.

Fuentes y lecturas complementarias