Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danitocsc/transporte-unrc-web-public/llms.txt

Use this file to discover all available pages before exploring further.

Transporte Tijuana está desplegado en Vercel mediante la integración nativa con GitHub, lo que habilita un pipeline de CI/CD completamente automático: cada push a la rama principal genera una nueva build de producción sin intervención manual. El sitio oficial se puede visitar en transporte-unrc.vercel.app.

Estructura del repositorio y Root Directory

El repositorio tiene la siguiente organización de alto nivel:
.
├── web/          ← proyecto Next.js (este es el Root Directory)
│   ├── app/
│   ├── components/
│   ├── public/
│   └── next.config.ts
└── README.md
Dado que el código Next.js vive en el subdirectorio web/ y no en la raíz del repositorio, es obligatorio configurar el Root Directory en Vercel. Si se omite este paso, Vercel no detecta el framework correctamente y el despliegue falla.

Output standalone

El archivo next.config.ts incluye la opción output: "standalone":
const nextConfig: NextConfig = {
  output: "standalone",
  // ...
};
Esta opción le indica a Next.js que genere un directorio .next/standalone con un servidor Node.js autocontenido y todas sus dependencias copiadas. Aunque esta configuración es especialmente relevante para el despliegue con Docker, Vercel la respeta sin problemas y la ignora en favor de su propia infraestructura serverless.

Variables de entorno

No se requiere definir ninguna variable de entorno en el panel de Vercel. Todos los datos del sitio (paradas, rutas, resumen estadístico) son archivos JSON estáticos incluidos en web/public/data/ y se sirven junto con el build. No existe ningún backend ni base de datos externa.

Cabeceras de seguridad

El archivo next.config.ts aplica las siguientes cabeceras HTTP a todas las rutas (/(.*)):
CabeceraValorPropósito
X-Frame-OptionsDENYPreviene ataques de clickjacking
X-Content-Type-OptionsnosniffEvita el MIME-type sniffing
Referrer-Policystrict-origin-when-cross-originLimita la información del referrer
Permissions-Policygeolocation=(self)Restringe la API de geolocalización al mismo origen
Vercel inyecta estas cabeceras en cada respuesta HTTP sin configuración adicional en el dashboard.

Redirección de raíz

La ruta / redirige automáticamente a /mapa-demanda con una redirección no permanente (HTTP 302), definida en next.config.ts:
async redirects() {
  return [
    { source: "/", destination: "/mapa-demanda", permanent: false },
  ];
},

Pasos para desplegar

1

Hacer fork o clonar el repositorio

Haz fork de danitocsc/transporte-unrc-web-public en tu cuenta de GitHub, o clónalo directamente si ya tienes acceso de escritura. Vercel necesita leer el repositorio a través de la integración de GitHub.
2

Importar el proyecto en el dashboard de Vercel

Inicia sesión en vercel.com, haz clic en Add New → Project y selecciona el repositorio recién bifurcado o conectado.
3

Configurar el Root Directory como web/

En la pantalla de configuración del proyecto, despliega la sección Root Directory y escribe web. Este paso es crítico: sin él, Vercel apunta a la raíz del repositorio donde no hay ningún proyecto Next.js.
Si omites este paso, el build fallará con un error de framework no detectado. Siempre verifica que el Root Directory sea web/ antes de hacer clic en Deploy.
4

Desplegar

Haz clic en Deploy. Vercel detecta Next.js automáticamente, ejecuta next build y publica el resultado. No es necesario modificar el Build Command ni el Output Directory — Vercel los infiere del framework.
5

Visitar el sitio desplegado

Una vez finalizado el build, Vercel proporciona una URL única del tipo *.vercel.app. El dominio oficial del proyecto es transporte-unrc.vercel.app. Cada nuevo push a la rama principal actualizará el despliegue automáticamente.
Las ramas distintas a la principal generan Preview Deployments con URLs temporales, lo que permite revisar cambios antes de que lleguen a producción.

Build docs developers (and LLMs) love