Instalación y Primeros Pasos
Esta guía te ayudará a levantar BuscaRamos en tu máquina local y a entender los pasos básicos para contribuir o probar el proyecto.
1. Instalar dependencias
Usa pnpm (o npm/yarn si lo prefieres) para instalar todas las dependencias:
pnpm install
2. Configurar variables de entorno
Copia el archivo de ejemplo y edítalo con tus valores locales:
cp .env.local.example .env.local
# Edita .env.local según tu entorno
Variables importantes:
MODE_ENV: "development" o "production".API_SECRET: Un valor único y seguro.USER_TOKEN: Este token es solo para simular un usuario autenticado en desarrollo. Debes obtenerlo desde auth.osuc.dev con tu cuenta. No lo expongas ni lo uses en producción.
3. Ejecutar migraciones y poblar la base de datos
Desde la raíz del proyecto:
cd migration
bash setup-DANGER.sh # Inicializa la base de datos de las reviews.
bash setup-articles.sh # Inicializa la base de datos de los blogs y recomendaciónes.
cd ..
Cuando el script lo solicite, selecciona la opción 1) Local.
4. Iniciar el servidor de desarrollo
pnpm dev
La aplicación estará disponible en http://localhost:4321.
5. Comandos útiles
| Comando | Acción |
|---|---|
pnpm install | Instala las dependencias. |
pnpm dev | Inicia el servidor de desarrollo en localhost:4321. |
pnpm build | Compila el sitio para producción en la carpeta ./dist/. |
pnpm preview | Previsualiza la build de producción localmente. |
¿Dudas? Consulta la documentación interna o el README principal del repositorio.