Desplegar tu primer proyecto

Tienes un repo Git y quieres verlo funcionando en una URL real. Esta lección te guía por los dos caminos posibles: el dashboard de Vercel (rápido, visual) y el CLI (práctico desde el terminal). Los dos llevan al mismo resultado: una URL en .vercel.app funcionando en cuestión de minutos.

Desde el dashboard de Vercel (importar Git)

Es el camino más rápido para un primer despliegue. Todo ocurre en el navegador.

1. Crear una cuenta y conectar tu Git

Ve a vercel.com/signup y regístrate con GitHub, GitLab o Bitbucket. Vercel usará esta cuenta para acceder a tus repos.

2. Importar un repo

En el dashboard, haz clic en Add New... > Project (botón en la parte superior derecha) y luego en Import Git Repository. Vercel lista todos los repos a los que tiene acceso tu cuenta Git. Selecciona el que quieras desplegar.

3. Configurar y desplegar

En la página de configuración, Vercel detecta automáticamente tu framework (Next.js, Vite, SvelteKit, etc.) y rellena los comandos de build. En la mayoría de los casos no tienes que cambiar nada.

Haz clic en Deploy. Vercel hace el build y despliega tu proyecto. El primer build tarda entre 1 y 3 minutos según el tamaño del proyecto.

Desde el CLI de Vercel

El CLI es útil cuando quieres desplegar sin salir de tu terminal, o automatizar despliegues en un pipeline.

1. Instalar el CLI

$npm i -g vercel

El paquete se llama vercel (sin prefijo). Una vez instalado, el comando vercel (o su alias vc) está disponible de forma global.

2. Iniciar sesión

$vercel login

El CLI abre un enlace en tu navegador. Autentícate con la misma cuenta que usas en el dashboard. De vuelta en el terminal, verás una confirmación.

3. Desplegar en preview

Desde la carpeta de tu proyecto:

$vercel

La primera vez, el CLI te hace algunas preguntas: cuenta de destino, nombre del proyecto, carpeta raíz. Detecta tu framework y configura el build automáticamente. Al final muestra una URL de preview única.

4. Desplegar en producción

$vercel --prod

Este comando despliega en la rama de producción y actualiza la URL estable de tu proyecto (por ejemplo: https://mi-proyecto.vercel.app).

Preview deployments: cada PR tiene su propia URL

Una vez que tu repo está conectado a Vercel desde el dashboard, cada pull request (o merge request) lanza automáticamente un despliegue de preview. Vercel publica la URL directamente como comentario en la PR de GitHub, GitLab o Bitbucket.

La lógica es sencilla:

• Rama main (o master) - despliegue de producción, sirve tu URL real.
• Cualquier otra rama - despliegue de preview, URL única del tipo <proyecto>-git-<rama>.vercel.app.

Puedes cambiar la rama de producción en Project Settings > Environments > Production > Branch Tracking.

Encontrar la URL de producción

Tres formas de encontrarla:

1. En el dashboard de Vercel, tarjeta del proyecto arriba: la URL clicable bajo el nombre del proyecto.
2. En la pestaña Deployments del proyecto: el último despliegue etiquetado como "Production".
3. Desde el CLI con vercel inspect seguido de la URL del deployment, o simplemente vercel list para ver los últimos despliegues.