Investigaciones de zuix
Mis notas de investigación y las decisiones que salieron de ellas. Cada documento cuenta qué me planteé, qué comparé, qué medí, qué decidí y qué descarté. Sirven para entender por qué la suite es como es, y para no repetir una discusión que ya tuve conmigo mismo.
Lectura en orden
| # | Documento | Qué responde |
|---|---|---|
| 00 | Investigación inicial | Cómo se separan tokens, lógica y estilos en un sistema de diseño, y cuánto puede hacer ya el CSS sin JavaScript |
| 01 | Estado de partida y problemática | Qué había antes de zuix y qué problema resuelve la suite |
| 02 | Fuentes de estilo | De dónde sale el estilo: el liquid glass de zutool, un design system anterior y el manual de marca |
| 03 | Zicon: extracción de Dazicon | Qué contiene el archivo de Figma de los iconos y cómo se extrae sin Figma |
| 04 | Componentes de referencia | El Carousel con efecto lente, las bibliotecas que miré como referencia y el código propio que ya existía |
| 05 | Zudocs: Docusaurus y estándar documental | Por qué Docusaurus, qué estándar documental ya usaba sin haberlo escrito y qué copié de Mintlify |
| 06 | Arquitectura de la suite y decisiones | Qué paquetes planeé, en qué orden y cómo acabó cada decisión |
| 07 | Construcción de la 0.1.0 | Qué construí, cómo lo verifiqué y qué fallos encontré por el camino |
| 08 | Primitivas propias | Por qué quité la biblioteca de UI que había debajo del binding de React y qué medí al hacerlo |
| 09 | Accesibilidad medida | Cómo pasé de afirmar WCAG AA a medirlo: contraste, RTL, colores forzados y táctil |
| 10 | Node, dependencias y cadena de suministro | Qué versiones admito, cómo protejo la instalación y cómo publico sin tokens |
| 11 | Lint, pruebas y por qué no Barrits | Por qué Biome y no ESLint, por qué node:test, y por qué no uso aquí mi propio Barrits |
| 12 | El sitio de documentación, medido | Qué encontré al auditar zudocs: seguridad, fuentes, rendimiento, llms.txt y despliegue |
Cómo leerlas
- Los documentos 00 a 06 son anteriores a la construcción: describen el análisis y el plan. Donde la construcción se apartó del plan, lo digo en el propio documento.
- El 07 es el registro de la
0.1.0. Del 08 al 12, lo que investigué y cambié para la0.2.0. - La guía de uso está en
../users/: describe lo que hay, no cómo llegué a ello.
Convención
- Un documento por tema, con prefijo numérico de dos dígitos.
- Las cifras llevan su fecha y cómo las obtuve.
- Las fuentes externas que sostienen una decisión se citan con su URL.
- Lo que no he comprobado se dice.
- De otros proyectos míos (zutool,
ui-glass, analizador-trafico, Barrits) cito la ruta dentro de su repositorio. Los proyectos privados no se nombran: el design system y el carousel que reutilicé salen de un "proyecto de origen" que no identifico.