🧬 CoreKit UI — React Library Lab

CoreKit UI es el ecosistema de componentes de PC Soluciones diseñado para aplicaciones de alta carga en epidemiología y salud ocupacional. Enfocado en rendimiento, accesibilidad (A11y) y experiencia de desarrollo (DX).

✨ Características Principales

• ⚡ Next-Gen Tech: Construido sobre Vite 6 y React 19 para máxima velocidad.
• 🧪 Calidad Garantizada: Cobertura de tests unitarios y de integración con Vitest y Testing Library.
• 🎨 Estilado Modular: Uso de CSS Modules para evitar colisiones y asegurar la encapsulación.
• 🧩 Arquitectura Atómica: Diseñado para ser escalable, mantenible y con soporte nativo para Tree-Shaking.
• 📚 Documentación Viva: Storybook interactivo para probar cada estado del componente en tiempo real.
• 🚀 Automation First: CI/CD robusto con GitHub Actions y control de calidad vía Husky.

📦 Instalación

pnpm add corekit-ui
# o bien
npm install corekit-ui

🎨 Configuración de Estilos

Para optimizar el peso de tu bundle, CoreKit UI no inyecta estilos automáticamente. Importa el archivo global en tu entry-point principal:

import 'corekit-ui/styles.css'; // ✅ Requerido una sola vez

🛠️ Desarrollo y Contribución

Si estás trabajando en el laboratorio, estos son los comandos esenciales:

Scripts Disponibles

• pnpm dev – Inicia el entorno de desarrollo con Vite.
• pnpm storybook – Lanza la documentación local en localhost:6006.
• pnpm test – Ejecuta la suite de pruebas unitarias.
• pnpm build – Compila la librería para distribución.
• pnpm run gen – Generador de scaffolding para nuevos componentes (Plop).

Estándares de Código

El proyecto utiliza un stack de linting estricto para asegurar la consistencia:

• ESLint: Lógica y mejores prácticas de React.
• Stylelint: Calidad en archivos CSS Modules.
• Prettier: Formateo automático de código.

📄 Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

Hecho con ❤️ por el equipo de PC Soluciones.