Saltar al contenido principal

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​

#DocumentoQué responde
00Investigación inicialCómo se separan tokens, lógica y estilos en un sistema de diseño, y cuánto puede hacer ya el CSS sin JavaScript
01Estado de partida y problemáticaQué había antes de zuix y qué problema resuelve la suite
02Fuentes de estiloDe dónde sale el estilo: el liquid glass de zutool, un design system anterior y el manual de marca
03Zicon: extracción de DaziconQué contiene el archivo de Figma de los iconos y cómo se extrae sin Figma
04Componentes de referenciaEl Carousel con efecto lente, las bibliotecas que miré como referencia y el código propio que ya existía
05Zudocs: Docusaurus y estándar documentalPor qué Docusaurus, qué estándar documental ya usaba sin haberlo escrito y qué copié de Mintlify
06Arquitectura de la suite y decisionesQué paquetes planeé, en qué orden y cómo acabó cada decisión
07Construcción de la 0.1.0Qué construí, cómo lo verifiqué y qué fallos encontré por el camino
08Primitivas propiasPor qué quité la biblioteca de UI que había debajo del binding de React y qué medí al hacerlo
09Accesibilidad medidaCómo pasé de afirmar WCAG AA a medirlo: contraste, RTL, colores forzados y táctil
10Node, dependencias y cadena de suministroQué versiones admito, cómo protejo la instalación y cómo publico sin tokens
11Lint, pruebas y por qué no BarritsPor qué Biome y no ESLint, por qué node:test, y por qué no uso aquí mi propio Barrits
12El sitio de documentación, medidoQué 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 la 0.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.