Files

T

Bernt 78436cecc2 docs: Foundation Freeze v1.0 + directory reorganization

- FOUNDATIONS-v1.0.md:
  - Freeze contract for Landvex Design System
  - Scope: Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done
  - Reference components: Button, Input, Select, Card (all ~83%)
  - Invariants: token rules, component rules, accessibility rules, AI rules
  - Change policy: no new foundation concepts without v2.0 RFC
  - Versioning: 1.0.x patches, 1.x.0 new components, 2.0.0 new foundations
  - Compatibility matrix for all foundations and components

- Directory reorganization:
  - docs/design/foundations/ → frozen foundation documents
  - docs/design/components/ → component RFCs
  - docs/design/README.md → navigation and structure

- Foundation documents moved:
  - TOKEN_PHILOSOPHY, SEMANTIC_COLOR_SYSTEM, GRID_ELEVATION
  - AI_DESIGN_PRINCIPLES, COMPONENT_TEMPLATE, RFC_DEFINITION_OF_DONE
  - DESIGN_ANTI_PATTERNS, COMPONENT_DECISION_TREE, GLOSSARY
  - BRAND_PALETTE, RELEASE_DEFINITION, SEMANTIC_COLOR_SYSTEM_REVIEW

- Component RFCs moved:
  - RFC-002-Input, RFC-003-Select, RFC-004-Card

Rationale: Clear separation between foundations (stable platform) and
components (built on top). Foundations v1.0 frozen — components can be
added freely within v1.x, but foundations require v2.0 RFC to change.
This prevents gradual erosion of the design system architecture.

2026-07-02 11:23:10 +00:00

1.7 KiB

Raw Blame History

Landvex Design System

Documentation Structure

docs/design/
├── README.md                    # This file
├── COMPLIANCE_MATRIX.md         # Component readiness tracking
├── LANDVEX_DESIGN_CONSTITUTION.md  # UX principles (Level 3)
├── LANDVEX_DESIGN_SPECIFICATION.md # Technical contract (Level 5)
├── foundations/                 # Frozen foundations
│   ├── FOUNDATIONS-v1.0.md      # Freeze contract
│   ├── TOKEN_PHILOSOPHY.md      # Token rules
│   ├── SEMANTIC_COLOR_SYSTEM.md # Color tokens
│   ├── GRID_ELEVATION.md        # Layout & depth
│   ├── AI_DESIGN_PRINCIPLES.md  # AI governance
│   ├── COMPONENT_TEMPLATE.md    # RFC template
│   ├── RFC_DEFINITION_OF_DONE.md # Quality gate
│   ├── DESIGN_ANTI_PATTERNS.md  # Forbidden patterns
│   ├── COMPONENT_DECISION_TREE.md # Selection guide
│   ├── GLOSSARY.md              # Common language
│   ├── BRAND_PALETTE.md         # Brand colors
│   └── RELEASE_DEFINITION.md    # Release gates
├── components/                  # Component RFCs
│   ├── RFC-002-Input.md
│   ├── RFC-003-Select.md
│   └── RFC-004-Card.md
└── platform/                    # Cross-cutting governance
    └── README.md

Status

Foundations v1.0 — FROZEN

Components build on foundations. Foundations do not change without v2.0 RFC.

1.7 KiB Raw Blame History

Landvex Design System

Status

Quick Links

1.7 KiB

Raw Blame History