# Cómo contribuir

¡Gracias por querer ayudar! El proyecto se mantiene gracias a la comunidad.

## Antes de empezar

1. Mira los [issues abiertos](../../issues), sobre todo los marcados
   `good first issue`.
2. Si tu cambio es grande, abre un issue antes de programar para discutirlo.

## Flujo

1. Haz fork del repositorio.
2. Crea una rama desde `main`: `git checkout -b mi-cambio`.
3. Escribe el código siguiendo las pautas de abajo.
4. Asegúrate de que la app arranca: `npm install && npm run dev`.
5. Abre un Pull Request hacia `main` describiendo el cambio.

## Pautas de código

- **Mantén la app simple.** Si dudas entre dos soluciones, elige la más corta
  y obvia. Este proyecto evita la complejidad a propósito.
- **Sigue la estructura existente.** Componentes en `src/components`, acceso a
  datos en `src/services`.
- **No añadas dependencias sin necesidad.** Cada nueva librería es coste de
  mantenimiento.
- **SOLID y Clean Code aplicados con sentido común.** Nombres claros,
  funciones cortas, una responsabilidad por archivo.
- **Estilo**: 2 espacios de indentación, comillas dobles en JSX y simples en JS.

## Tipos de contribución

- **Código**: bugs, mejoras, nuevas funciones acordadas en issues.
- **Documentación**: cualquier archivo de `docs/` o el README.
- **Diseño**: propuestas en issues con mockups.
- **Reportar negocios**: usa la propia aplicación; no es necesario un PR.

## Revisión

Un mantenedor revisará tu PR. Puede pedir cambios. Una vez aprobado, hará
merge. Sé paciente: somos voluntarios.

## Reconocimiento

Todas las personas que han contribuido aparecen automáticamente en la pestaña
de Contributors del repositorio.