Framework Documentation

Architecture

Core System Structure

La arquitectura del framework organiza fundamentos, layout, ritmo, utilidades, animación y reglas del sistema en una estructura clara y escalable.

Overview

Qué define esta arquitectura

La arquitectura del framework existe para separar responsabilidades de forma clara. No todos los estilos pertenecen al mismo nivel: unos definen fundamentos, otros resuelven estructura, otros controlan ritmo y otros actúan como utilidades.

Esta separación permite mantener el sistema consistente, más fácil de documentar y más seguro de escalar sin mezclar lógica estructural con ajustes visuales o estilos específicos de un proyecto.

Layers

Capas del sistema

Base

Fundamentos globales

Aquí viven reset, variables base, breakpoints, tipografía y helpers de texto. Es la capa que define el lenguaje inicial del framework.

Layout

Estructura

Reúne containers, grid y proporciones para construir la arquitectura visual horizontal de páginas y secciones.

Rhythm

Ritmo

Define el espacio macro entre secciones y el flujo vertical interno entre bloques.

Helpers

Utilidades

Reúne spacing, align, width, height, radius, visibility y lists para resolver ajustes estructurales concretos.

Animations

Movimiento

Define un sistema mínimo y controlado de animación con enfoque accesible.

Overrides

Proyecto

La última capa del sistema. Aquí viven los estilos específicos del sitio, sin contaminar el núcleo del framework.

Relationships

Cómo se relacionan las capas

  • Base define el lenguaje inicial del sistema.
  • Layout organiza estructura horizontal y jerarquía espacial.
  • Rhythm regula separación macro e interna.
  • Helpers ajustan comportamiento puntual sin romper la lógica general.
  • Animations agrega movimiento de forma controlada y reusable.
  • Overrides adapta el framework a un proyecto concreto sin alterar el núcleo.

Why It Matters

Por qué esta estructura importa

Escalabilidad

Permite agregar nuevos módulos y helpers sin desordenar el sistema ni duplicar lógica.

Mantenibilidad

Hace más fácil identificar dónde debe vivir cada regla, helper o ajuste estructural.

Consistencia

Mantiene una relación estable entre tipografía, layout, ritmo y utilidades.

Documentación clara

Facilita explicar el sistema página por página sin mezclar conceptos ni responsabilidades.

Site Structure

Páginas que representan el framework

Entry

Index

Portada del framework y acceso general al sistema.

Map

Docs

Índice maestro con el recorrido completo de la documentación.

Core

Architecture

Visión estructural del sistema y su organización general.

Imports

Framework Core

Orden de capas, imports y lógica del archivo principal.

Rules

File Responsibilities

Qué le corresponde a cada archivo y qué no debe contener.

Modules

Base, Layout, Helpers, Motion

Las páginas modulares explican cada responsabilidad por separado.

Siguiente paso

Continúa con framework core para ver el orden de importación y las capas reales del sistema.