@micazoyolli/foundation

Fundamentos frontend no visuales para construir repos independientes con una base técnica consistente.

Foundation centraliza mecánicas pequeñas que se repiten entre proyectos: tokens SCSS base, mixins responsive, helpers TypeScript, primitivas DOM de accesibilidad y utilidades SEO/build. No incluye React, componentes visuales, tokens de marca, layouts ni metadata específica.

Documentation

La documentación principal vive en foundation.nadia.dev. Ahí está la guía completa, arquitectura, ejemplos, compatibilidad y referencia de la API.

Features

• Tokens SCSS base: spacing, radius, z-index, motion y breakpoints.
• Mixins SCSS para responsive y reduced motion.
• cx y guards TypeScript pequeños.
• Helpers DOM para metadata client-side.
• Primitivas de accesibilidad para focus, Escape, scroll lock y media protegida.
• Helpers SEO/build para canonical, sitemap, HTML estático y escaping.
• CLI de build para publicar dist en GitHub Pages sin crear commits en la rama fuente.
• Sin dependencias runtime pesadas y sin React.

Instalación

yarn add @micazoyolli/foundation

TypeScript

import { cx, getCanonicalUrl } from '@micazoyolli/foundation';

const className = cx('card', isActive && 'card--active');
const canonical = getCanonicalUrl('https://example.com', '/contacto');

SCSS

@use '@micazoyolli/foundation/scss' as foundation;

.section {
  padding-block: foundation.$space-6;

  @include foundation.down(foundation.$breakpoint-md) {
    padding-block: foundation.$space-4;
  }
}

Compatibilidad

Foundation es framework agnostic y puede usarse con React, Next.js, Vue, Angular, Astro, Vite y Node según el helper utilizado.

Resources

• Documentation: foundation.nadia.dev
• GitHub: github.com/micazoyolli/foundation
• npm: npmjs.com/package/@micazoyolli/foundation

Ecosistema

Foundation forma parte del ecosistema técnico de <micazoyolli />. La librería sostiene las piezas repetibles para que cada proyecto pueda conservar su propia identidad visual, contenido y experiencia.

Scripts

yarn build
yarn test
yarn docs:build

CLI

micazoyolli-gh-pages-deploy

El CLI publica dist en origin/gh-pages desde un worktree temporal. Es tooling de build/deploy, no un export runtime.

Autoría

Una creación de <micazoyolli />

Licencia

MIT