Connect. Inspire. Grow.
Comunidad tech para conectar, inspirarte y crecer.
Chamba Lab es una comunidad tech. Nuestra misión es crear un espacio donde las personas en tecnología se conecten, se inspiren y crezcan juntas en su carrera, para que el contexto en el que cada quien empieza pese menos.
La interacción ocurre en Discord; este repositorio es el sitio público de la comunidad. Más contexto en docs/project.md.
Sitio estático, rápido y bilingüe (ES/EN).
- Frontend: Astro 7.x (SSG).
- UI Library: React 19+ (Utilizado en "Islas" de interacción como el Ecosistema Comunitario y La Ruleta).
- Styling: TailwindCSS 4.x, sistema de diseño Modern Dark Glassmorphism (fondo obsidian
#080D1A, tarjetas conbackdrop-blur, acentos en amarillo#FACC15y Discord#5865F2) — especificación completa en DESIGN.md y arquitectura en AGENTS.md. - CI/CD: GitHub Actions +
release-itpara versionado automático y despliegue a GitHub Pages.
| Ruta | Contenido |
|---|---|
/ |
Landing con hero, widget de Discord, ecosistema (el diagrama de perfiles y etapas), eventos, equipo y recursos recomendados |
/resources |
Biblioteca completa de guías, plantillas y plataformas curadas con filtros |
/events |
Calendario de eventos y sesiones recurrentes con exportación a Google Calendar / iCal |
/activities |
Hub de mini actividades comunitarias (dinámicas) |
/team |
Fundadores, Core team, Contributors y miembros de la comunidad |
/activities/roulette |
La Ruleta: dinámica interactiva con packs temáticos de preguntas y modo libre |
Rutas siempre en inglés, con soporte bilingüe (ES/EN). Detalle técnico en AGENTS.md.
- Node.js: v22.23.4+ (ver
enginesenpackage.json). Astro 7 se niega a compilar con una versión menor. - Gestor de paquetes: npm (recomendado)
-
Clona el repositorio:
git clone https://github.com/Chamba-Lab/home.git cd home -
Instala dependencias:
npm install
-
Inicia el entorno de desarrollo:
npm run dev
Utilizamos un pipeline automatizado para asegurar la calidad y facilitar el crecimiento.
| Comando | Descripción |
|---|---|
npm run dev |
Inicia el servidor de desarrollo local |
npm run build |
Genera la versión de producción (SSG) |
npm run lint |
Valida el código con ESLint y Prettier |
npm run lint:fix |
Corrige automáticamente problemas de estilo y lint |
npm run test |
Ejecuta las pruebas unitarias con Vitest |
npm run brand:optimize |
Optimiza los SVG de marca (src/assets/brand/) con svgo |
npm run team:optimize |
Optimiza los logos SVG del equipo (src/assets/team/logos/) con svgo |
npm run brand:og |
Regenera public/og-image.png (1200×630) desde brand/og.svg con los colores de los tokens |
npm run release |
Proceso de lanzamiento y versionado (Conventional Commits) |
La mascota (mapache/gato con taza de café) es el logo de Chamba Lab. Los SVG maestros viven en src/assets/brand/, la plantilla OG y los avatares de Discord en brand/, y los favicons y el manifest en public/. Reglas de uso (fondos permitidos, tamaños mínimos) en DESIGN.md §6.1.
master está protegida: los cambios entran por Pull Request con checks de lint, tests, build y título. Al fusionar, el pipeline:
- Valida: lint y tests.
- Publica la versión: tag y
CHANGELOG.md. - Despliega en GitHub Pages.
Avanzar por cuenta propia tiene mérito; en comunidad multiplicas tus posibilidades.
- Cómo contribuir: lee CONTRIBUTING.md (flujo de ramas, Conventional Commits, checklist de PR) y nuestro Código de Conducta.
- Ideas y bugs: abre un issue con las plantillas para proponer recursos, eventos o reportar errores.
- Arquitectura, decisiones y diseño: AGENTS.md, docs/decisions.md y DESIGN.md.
- Discord: Escríbenos en la comunidad.
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Hecho con ❤️ por la comunidad de Chamba Lab