peruanos.dev

Directorio centralizado de eventos, comunidades y proyectos open source de la comunidad tech peruana.

Sobre el proyecto

peruanos.dev es una plataforma que reúne información sobre:

• Eventos: Meetups, conferencias, talleres y charlas de tecnología en Perú
• Comunidades: Grupos y organizaciones tech peruanas
• Proyectos Open Source: Proyectos de código abierto creados por desarrolladores peruanos

Características

• Búsqueda y filtrado por ciudad, categoría y tags
• Información actualizada de eventos próximos
• Directorio de comunidades activas
• Showcase de proyectos open source peruanos
• Modo claro/oscuro
• Diseño responsive
• Sitemap y structured data

APIs Públicas

peruanos.dev expone diferentes endpoints públicos (solo de lectura) para que puedas consumir la información en tus propios proyectos:

• GET /api/events - Obtiene la lista de eventos.
• GET /api/communities - Obtiene el directorio de comunidades.
• GET /api/projects - Obtiene los proyectos open source.

Comenzar

Requisitos previos:

• Node.js 20 o superior
• npm o pnpm

Instala las dependencias:

npm install

Inicia el servidor de desarrollo:

npm run dev

Abre http://localhost:3000 en tu navegador.

Contribuir

Hay dos formas de contribuir al proyecto:

Para todos (sin conocimientos técnicos)

Usa nuestros formularios de GitHub Issues para agregar contenido:

• Agregar un evento
• Agregar una comunidad
• Agregar un proyecto

Para desarrolladores

Si quieres contribuir código, corregir bugs o mejorar el proyecto:

1. Fork el repositorio
2. Crea una rama: git checkout -b feature/nueva-funcionalidad
3. Haz tus cambios y commits
4. Push a tu fork: git push origin feature/nueva-funcionalidad
5. Abre un Pull Request

Lee la guía de contribución completa para más detalles.

Estructura del Proyecto

peruanos.dev/
├── app/               # Código principal (Next.js App Router)
│   ├── api/           # Endpoints públicos de la API
│   ├── community/     # Página de comunidades
│   ├── components/    # Componentes React
│   ├── context/       # Contextos globales (Theme)
│   ├── data/          # Datos estáticos de eventos, comunidades y proyectos
│   ├── events/        # Página de eventos
│   ├── hooks/         # Custom hooks de React
│   ├── lib/           # Funciones de utilidad
│   ├── models/        # Interfaces y tipos de TypeScript
│   └── projects/      # Página de proyectos
├── public/            # Archivos estáticos (imágenes, iconos, etc.)
├── .github/           # Plantillas de contribución (Issues/PRs)
├── CONTRIBUTING.md    # Guía detallada para contribuir
└── next.config.ts     # Configuración de Next.js

Comandos Disponibles

npm run dev          # Inicia servidor de desarrollo
npm run build        # Crea build de producción
npm run start        # Inicia servidor de producción
npm run lint         # Ejecuta ESLint

Licencia

Este proyecto está abierto a la comunidad. Si tienes sugerencias sobre licenciamiento, por favor abre un Issue.

Comunidad

¿Tienes preguntas o sugerencias? Abre un Issue o únete a la conversación.