Repository navigation
Home
qrgenerator es una librería moderna para Java enfocada en la creación de códigos QR altamente personalizados y robustos.
A diferencia de otras soluciones tradicionales que se limitan a generar cuadrados negros y blancos, este proyecto adopta el enfoque de Diseño Guiado por Especificaciones (Spec-Driven Design). Esto significa que separas por completo la lógica de qué aspecto debe tener tu QR de la lógica que lo renderiza, permitiéndote crear códigos únicos, dinámicos y adaptados a tu marca sin ensuciar tu código base.
- 🎨 Personalización Absoluta: Controla el color, los degradados, la forma de los módulos (puntos, cuadrados, líneas redondeadas) y el diseño de los ojos (esquinas).
- 🖼️ Incrustación de Logos: Añade tu logo en el centro del QR con gestión automática del margen de error para asegurar que siga siendo 100% legible.
- 🏗️ Arquitectura Limpia: Construido bajo principios SOLID, lo que facilita extender la librería para soportar nuevos formatos de salida o reglas de diseño.
- ⚡ Fluent API: Un diseño basado en builders que hace que el código sea legible y fácil de escribir.
Para ayudarte a empezar lo más rápido posible, hemos dividido la documentación en secciones clave:
Aprende a integrar la librería en tu proyecto usando Maven o Gradle y genera tu primer código QR en menos de 5 minutos.
Descubre cómo funciona el motor por dentro, qué es el Spec-Driven Design y cómo se estructuran las especificaciones del QR.
La sección práctica. Encuentra snippets de código listos para copiar con configuraciones de colores, logos, formas personalizadas y formatos de exportación.
Explora las interfaces principales, paquetes y el sistema de manejo de excepciones de la librería.
¿Quieres reportar un bug, sugerir una característica o enviar un Pull Request? Aquí encontrarás las pautas para trabajar en el entorno local.
💡 ¿Tienes alguna duda o encontraste un problema? Revisa nuestra sección de Issues o contribuye abriendo una discusión. ¡La comunidad la hacemos todos!
🏠 Inicio • 🚀 Instalación • 🏗️ Arquitectura • 💻 Guía de Uso • 📚 Referencia API • 🛠️ Contribución
qrgenerator — Diseñado bajo la filosofía KISS y principios SOLID.
¿Encontraste un error o tienes una sugerencia? Abre un Issue o visita el Repositorio Principal.