Deploy en Vercel

Este sitio está pensado para desplegarse en Vercel como un sitio estático de Next.js. No requiere base de datos ni variables de entorno.

Primer despliegue

Sube el repositorio a GitHub (o GitLab/Bitbucket)


git init
git add .
git commit -m "chore: documentación inicial"
git remote add origin git@github.com:tu-org/dev-docs.git
git push -u origin main

Importa el proyecto en Vercel

En vercel.com/new , selecciona el repositorio. Vercel detecta Next.js automáticamente; no necesitas cambiar nada:

Ajuste	Valor (autodetectado)
Framework Preset	Next.js
Build Command	`npm run build`
Output Directory	`.next`
Install Command	`npm install`

Despliega

Pulsa Deploy. En cada push a main, Vercel reconstruye y publica automáticamente. Los Pull Requests generan Preview Deployments con su propia URL.

Asociar un dominio

Añade el dominio en Vercel

En el proyecto → Settings → Domains, escribe tu dominio (por ejemplo docs.tudominio.com) y pulsa Add.

Configura el DNS

Vercel te indicará qué registro crear en tu proveedor de DNS:

Tipo de dominio	Registro	Valor
Subdominio (`docs.`)	`CNAME`	`cname.vercel-dns.com`
Dominio raíz (`apex`)	`A`	`76.76.21.21`

Espera la propagación

Vercel emite el certificado HTTPS automáticamente una vez que el DNS apunta correctamente (suele tardar de minutos a un par de horas).

La búsqueda funciona en producción gracias al script postbuild de package.json, que ejecuta Pagefind tras el build e indexa el sitio en public/_pagefind. No tienes que configurar nada extra en Vercel.

Si la búsqueda no aparece tras el deploy, borra la caché de build en Vercel (Settings → … → Clear Build Cache) y vuelve a desplegar.