Portal de Laboratorios de Física

Este es el repositorio del Portal de Laboratorios de Física, un proyecto construido con Astro, React y Tailwind CSS, diseñado para ser desplegado en GitHub Pages.

Este portal es una iniciativa para rediseñar y modernizar el sitio web actual (fisica.usac.edu.gt/fisica/). El objetivo es ofrecer los mismos recursos, prácticas e información general de los laboratorios, pero con una experiencia de usuario (UX) mucho más intuitiva, accesible y una interfaz (UI) moderna y limpia.

🚀 Tecnologías utilizadas

• Astro: Framework web optimizado para velocidad, ideal para sitios estáticos enfocados en el contenido.
• React: Biblioteca para construir interfaces de usuario e integraciones interactivas.
• Tailwind CSS v4: Framework de CSS utilitario para un estilizado rápido y moderno.
• GitHub Actions / Pages: Despliegue continuo y alojamiento web.

🤝 Cómo colaborar

Si deseas revisar el código o aportar a esta iniciativa, puedes hacerlo preparando tu entorno local de la siguiente manera:

1. Clonar el repositorio:

   git clone https://github.com/ricardious/physics-lab-portal.git

2. Entrar al directorio del proyecto y cambiar a la rama de desarrollo (develop): (Nota: Todo el trabajo y nuevas implementaciones deben partir y apuntar a esta rama).

   cd physics-lab-portal
   git checkout develop

3. Instalar dependencias:

   pnpm install

4. Ejecutar el servidor de desarrollo:

   pnpm dev

   El sitio estará disponible localmente en http://localhost:4321.

5. Actualizar dependencias:

   pnpm run deps:update

   Esto ejecuta ncu -u sobre package.json y luego regenera el lockfile con pnpm.

6. Enviar tus aportes: Crea una rama nueva para tus cambios, realiza los commits y luego abre un Pull Request hacia la rama develop.

📁 Estructura del proyecto

/
├── public/           # Archivos estáticos e imágenes (favicon, assets)
├── src/
│   ├── components/   # Componentes de React y Astro
│   ├── layouts/      # Plantillas de diseño principales
│   └── pages/        # Rutas de las páginas (basado en el sistema de archivos de Astro)
├── astro.config.mjs  # Configuración principal de Astro
└── package.json      # Dependencias y scripts

---

Desarrollado como iniciativa personal por Ricardo (ricardious).