🚀 Instalación y Arranque

Requisitos

Software necesario

• Node.js 16+ — Descargar
• npm 8+ — Se instala con Node.js
• Git — Descargar
• Opcional: Docker + Docker Compose — Para entorno containerizado

Docker no es obligatorio. No se instala automáticamente desde este proyecto. Si eliges usarlo, debes instalarlo tú previamente.

Verificar instalación

node --version     # v16 o superior
npm --version      # 8 o superior
git --version      # cualquier versión reciente

Instalación

# 1. Clonar el repositorio
git clone URL_DEL_REPOSITORIO
cd EduPress

# 2. Instalar dependencias (~500MB, 2-5 minutos)
npm install

# 3. Verificar estructura
ls -la src/
# Debe mostrar: index.md  .vitepress/  general/  public/

Arrancar el servidor

Opción A: Scripts automáticos (recomendado)

./start-project.sh          # Inicia servidor de desarrollo
./status-project.sh         # Ver URL de acceso y estado
./stop-project.sh           # Detener servidor

./start-project.sh preview  # Preview de producción (opcional)

Los scripts gestionan puertos automáticamente y evitan conflictos.

Opción B: npm directo

npm run docs:dev      # Desarrollo con hot reload → http://localhost:5173/EduPress/
npm run docs:preview  # Preview producción → http://localhost:4173/EduPress/
npm run docs:build    # Construir para despliegue

Opción C: Docker

Requiere Docker y Docker Compose instalados previamente.

docker compose up vitepress
# → http://localhost:5173/EduPress/

Si no tienes Docker instalado, usa la Opción A o B.

Primera verificación

Tras ./start-project.sh debería aparecer una URL similar a:

  ➜  Local:   http://localhost:5173/EduPress/

Abre esa URL en el navegador. Si ves la pantalla de inicio, la instalación es correcta.

Siguiente paso: Estructura del Proyecto