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.
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
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:cleanSi 5173 está ocupado o tienes port forwarding de VS Code/Remote activo, usa un puerto alternativo local:
npm run dev:local:cleanEso levanta la app en http://127.0.0.1:4173.
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 public/data/, puedes comprobar el dataset manualmente con npm run validate-data. 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
Echa un vistazo a los milestones e issues del proyecto.
- El código fuente está disponible bajo la licencia Apache 2.0.
- Los datos en el directorio
public/data/están bajo la licencia CC BY 4.0.
¿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:
Las instrucciones para añadirte o añadir emojis de contribución a tu nombre están en este issue.