Filosofía
Foundation comparte lo que ya demostró ser común entre proyectos independientes. Su valor está en ser pequeño, predecible y fácil de quitar si algún proyecto deja de necesitarlo.
SmallLa API crece solo cuando una necesidad aparece en varios repos reales.
ComposableLas utilidades se pueden usar solas, sin adoptar una arquitectura completa.
Framework-agnosticNo depende de React ni de un runtime visual.
AccessibleIncluye primitivas para teclado, foco y movimiento reducido cuando el patrón se repite.
PredictableFunciones pequeñas, nombres directos y comportamiento documentado.
No brand assumptionsNo contiene colores finales, logos, copy, rutas ni metadata de proyectos.
Built from productionSe extrae de necesidades reales, no de componentes imaginados.
Pertenece a Foundation
- Tokens base: spacing, radius, z-index, motion y breakpoints.
- Mixins SCSS pequeños.
- Helpers TypeScript sin framework.
- Primitivas DOM/a11y.
- Helpers SEO/build sin datos de marca.
No pertenece a Foundation
- Componentes React visuales.
- Botones, cards, layouts, grids o formularios finales.
- Colores, tipografía o estilos específicos de una marca.
- Metadata, rutas, imágenes OG o dominios de proyectos.
- Reglas de negocio.
- Helpers usados por un solo proyecto.
Criterio de entrada
Una utilidad nueva debe repetirse en varios proyectos, poder documentarse con claridad y no cambiar por decisiones visuales.