Skip to content

About

Web que reúne +500 comunidades tech de España y otras hispanohablantes (online)

Topics

Resources

Code of conduct

Contributing

Stars

19 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

All Contributors

Communities directory

Este proyecto identifica y visibiliza comunidades tecnológicas en España (activas e inactivas) para que cualquier persona interesada descubra fácilmente las opciones disponibles y encuentre las que se ajustan a sus intereses.

También actúa como punto de encuentro para quienes desean dinamizar comunidades, facilitando el contacto con aquellas que buscan nuevas personas en sus equipos organizadores.

Además, muestra qué comunidades ya están representadas en Community Builders.

Pantallazo de la app

📖 Índice

Por qué este proyecto

Este directorio puede ser útil en muchos escenarios:

Si quieres crear o ayudar en una comunidad:

  • Te puede interesar unirte a una red con branding más fuerte o con un ecosistema más amplio.
  • Puede ayudar a coordinar fechas y evitar solapes en grandes eventos del ecosistema.
  • Puedes ver qué organizaciones paraguas existen (como GDG, PyLadies, Cloud Native, ...) que ofrecen red de contactos, recursos, apoyo económico o simplemente know-how.
  • Podrás encontrar comunidades con las que hacer sinergias o cocrear eventos.
  • También te permite detectar comunidades que podrían reactivarse.

Si estás buscando una comunidad en la que participar:

  • Es una forma rápida de descubrir comunidades (locales u online) que podrías haber pasado por alto.
  • Útil si estás de viaje o te has mudado a otra ciudad y quieres encontrar comunidades allí.
  • Pudiendo filtrar por ubicación y también por temática o tipo de actividad.

Para quienes impulsamos comunidad:

  • Nos ayuda a tener una visión más global del ecosistema a nivel nacional.
  • Nos permite conectar con comunidades actuales o antiguas, aprender de su experiencia.
  • Podemos identificar personas interesadas en participar en encuentros presenciales de Community Builders.

Nota: Puedes ver el hilo de correos donde explicamos el por qué del proyecto oficialmente por primera vez: Listado de comunidades

Datos abiertos

Todos los datos del directorio son abiertos (CC BY 4.0) y se pueden descargar directamente:

La fuente de verdad es data/communities/: un fichero JSON por comunidad. Los tres ficheros anteriores son artefactos generados y están gitignorados, así que no se editan a mano.

Úsalos con IA o con un agente

Te animamos a hacerlo, y el directorio te lo pone fácil:

El botón Datos abiertos + IA de la cabecera del directorio trae prompts listos para pegar en ChatGPT o Claude, ejemplos de código e instrucciones para el contexto de tu agente. No hace falta servidor MCP: son ficheros estáticos con CORS abierto.

📄 docs/DATA.md documenta todos los datasets, el esquema campo a campo y cómo regenerarlos en local.

Instalación y uso en local

Tan solo ejecuta:

git clone https://github.com/ComBuildersES/communities-directory.git
cd communities-directory
npm install

Y una vez hecho esto, puede arrancar el entorno de desarrollo con:

npm run dev

Esto iniciará la app en http://localhost:5173 por defecto, donde podrás explorar el directorio interactivo.

Si quieres limpiar la caché local de Vite antes de arrancar:

npm run dev:clean

Si 5173 está ocupado o tienes port forwarding de VS Code/Remote activo, usa un puerto alternativo local:

npm run dev:local:clean

Eso levanta la app en http://127.0.0.1:4173.

Problemas típicos con localhost:5173

Si el navegador muestra una versión del código que no coincide con lo que tienes en disco, es posible que 5173 esté siendo interceptado por otro proceso local o por un túnel de VS Code.

Puedes comprobar qué está sirviendo realmente ese puerto con:

lsof -nP -iTCP:5173 -sTCP:LISTEN
curl -s http://127.0.0.1:5173/src/lib/communitySubmission.js | rg "normalizeTaxonomySelection|buildCommunityPayload"

Si no aparece la firma esperada del código actual, cambia temporalmente a 4173 con npm run dev:local:clean.

Si vas a tocar los datos (data/communities/ o las taxonomías de public/data/), puedes comprobar el dataset manualmente con npm run validate-data, y recompilar los artefactos publicados con npm run compile-communities. Además, npm install configura un hook local para validar las contribuciones antes de cada commit.

Para sanear URLs rotas o caídas:

npm run check-urls -- --report report.txt  # audita todas las URLs
npm run archive-broken-urls -- --dry-run   # busca snapshots en Wayback Machine
npm run archive-broken-urls                # aplica las URLs archivadas

## Contribuir ¿Te gustaría añadir una comunidad, mejorar datos existentes o proponer ideas?

Consulta la guía de colaboración → CONTRIBUTING.md

Roadmap

Echa un vistazo a los milestones e issues del proyecto.

Licencias

  • El código fuente está disponible bajo la licencia Apache 2.0.
  • Los datos del directorio (data/communities/, data/deleted-communities/ y las taxonomías de public/data/, junto con los ficheros publicados que se generan a partir de ellos) están bajo la licencia CC BY 4.0. Ver docs/DATA.md.

Contribuir

¿Quieres unirte? -> CONTRIBUTING.md

Los issues y PRs automáticos de comunidades se asignan por provincia usando .github/community-owners.yml. Si quieres ayudar a revisar una zona concreta, puedes ofrecerte en el issue #53.

Echa un vistazo a algunas de las tareas por las que podrías empezar a ayudar:

GitHub issues by-label

Contributors

Manuel Saez Carmona
Manuel Saez Carmona

💻 🔬 🚧 🎨
Álvaro Gutiérrez
Álvaro Gutiérrez

💻 🔬 🚧 🎨
Aleix Batlle
Aleix Batlle

💻 🔬 🚧 🎨
Raul Jimenez Ortega
Raul Jimenez Ortega

🔣 🚧 📆 🤔
Andrea Magán Rey
Andrea Magán Rey

💻
Jesús Ángel Pérez-Roca Fernández
Jesús Ángel Pérez-Roca Fernández

🔣
Daniel
Daniel

👀
Luis Sánchez de Ybargüen
Luis Sánchez de Ybargüen

🔣
Manuel Martín
Manuel Martín

🔣
Mario
Mario

🔣
Jorge Hidalgo
Jorge Hidalgo

🔣
Jorge Teixeira
Jorge Teixeira

🔣
David Bonilla
David Bonilla

🔣
Juan Luis Cano Rodríguez
Juan Luis Cano Rodríguez

🔣
Mánu Fosela
Mánu Fosela

🔣
Isabel Vigil Morán
Isabel Vigil Morán

🔣
Joan León
Joan León

🔣
AbrahamOtero
AbrahamOtero

🔣
Álvaro Saugar
Álvaro Saugar

🔣
Sergio Conejero Vicente
Sergio Conejero Vicente

🔣
Adrián
Adrián

🔣
Eun Young Cho (Plata)
Eun Young Cho (Plata)

🔣
Julieta Zalduendo
Julieta Zalduendo

🔣
Ignacio Espósito
Ignacio Espósito

🔣
Ivan Fraixedes
Ivan Fraixedes

🔣
Iván López
Iván López

🔣
César Alberca
César Alberca

🔣
Nadia Ujovich
Nadia Ujovich

🔣
Andrea
Andrea

🔣
Crystian
Crystian

🔣
Dachi Gogotchuri
Dachi Gogotchuri

🔣
Fran Martin Rivas
Fran Martin Rivas

🔣
Antonio Jimenez
Antonio Jimenez

🔣
Ismael Olea
Ismael Olea

🔣
lauravignali
lauravignali

🔣
Alvaro Lozano
Alvaro Lozano

🔣
Sergio Márquez
Sergio Márquez

🔣
Ana Jimenez Santamaria
Ana Jimenez Santamaria

🔣
marotorod
marotorod

🔣
Nacho Cougil
Nacho Cougil

🔣
José Nicolás Castellano
José Nicolás Castellano

🔣
David Acacio
David Acacio

🔣
Gabriel Bustillo del Cuvillo
Gabriel Bustillo del Cuvillo

🔣
josep sitjar
josep sitjar

🔣
Daniel Castañera Garrido
Daniel Castañera Garrido

🔣

Las instrucciones para añadirte o añadir emojis de contribución a tu nombre están en este issue.

About

Web que reúne +500 comunidades tech de España y otras hispanohablantes (online)

Topics

Resources

Code of conduct

Contributing

Stars

19 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages