Principles

UI Foundations is guided by a small set of principles that inform every pattern, component, and token decision.

Canonical design foundation knowledge is maintained in the UI Foundations Vault. This repository only documents implementation-specific usage.

Vault reference: configured vault design principles

Local implementation usage

UI Foundations applies vault principles through implementation surfaces:

• pattern and component documentation
• token-driven state, color, spacing, and typography decisions
• semantic HTML and accessibility expectations
• rule-pipeline traceability
• validation and CI checks

Pattern rules should cite local principle IDs where the rule pipeline requires traceability. Long-form principle definitions live in the vault, not in this runtime repository.