Files
boc/docs/design/foundations/FOUNDATIONS-v1.0.md
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

4.3 KiB

FOUNDATIONS v1.0 — FROZEN

Stable Platform for Landvex Design System Components

Version 1.0
Status FROZEN
Date 2026-07-02
Scope All Landvex & quiXzoom products

1. SCOPE

What Is Included

Foundation Document Version Status
Motion System MOTION_SYSTEM.md 1.0 Frozen
AI Design Principles AI_DESIGN_PRINCIPLES.md 1.0 Frozen
Semantic Color System SEMANTIC_COLOR_SYSTEM.md 1.0 Frozen
Grid & Elevation GRID_ELEVATION.md 1.0 Frozen
Typography LANDVEX_DESIGN_SPECIFICATION.md §3 1.0 Frozen
RFC Component Template COMPONENT_TEMPLATE.md 1.0 Frozen
Definition of Done RFC_DEFINITION_OF_DONE.md 1.0 Frozen

Reference Components (v1.0)

Component Document Maturity
Button RFC-001-Button.md 82%
Input RFC-002-Input.md 83%
Select RFC-003-Select.md 83%
Card RFC-004-Card.md 83%

2. INVARIANTS

These rules MUST NOT be violated by any component built on Foundations v1.0.

2.1 Token Rules

  • MUST use semantic color tokens (color.{category}.{role})
  • MUST NOT reference primitive colors (blue-500, gray-900) from components
  • MUST NOT hardcode values
  • MUST use intention-based motion tokens (duration-{intent})

2.2 Component Rules

  • MUST follow COMPONENT_TEMPLATE.md structure
  • MUST include Cognitive Purpose, Interaction Contract, Failure Behaviour
  • MUST include Accessibility Contract and AI Contract
  • MUST pass all 12 Definition of Done criteria

2.3 Accessibility Rules

  • MUST meet WCAG 2.1 AA
  • MUST include keyboard navigation
  • MUST include screen reader support
  • MUST include reduced motion fallback

2.4 AI Rules

  • MUST include AI Contract (when AI chooses this component)
  • MUST document anti-patterns
  • MUST verify against document hierarchy

3. CHANGE POLICY

After Freeze

Change Type Allowed Process
New component RFC + Compliance Matrix update
Component variant RFC update
Component bug fix Patch version
New foundation concept Requires Foundations v2.0 RFC
Foundation modification Requires Foundations v2.0 RFC
Foundation addition Requires Foundations v2.0 RFC

Versioning

Version Meaning
1.0.x Patch: bug fixes, clarifications
1.x.0 Minor: new components, no foundation changes
2.0.0 Major: new foundation concepts, breaking changes

4. COMPATIBILITY

Foundation Versions

Foundation Version Frozen Date
Motion 1.0 2026-07-02
Semantic Colors 1.0 2026-07-02
Grid 1.0 2026-07-02
Elevation 1.0 2026-07-02
Typography 1.0 2026-07-02
RFC Template 1.0 2026-07-02

Component Compatibility

Component Requires Foundations
Button v1.0 Foundations v1.0
Input v1.0 Foundations v1.0
Select v1.0 Foundations v1.0
Card v1.0 Foundations v1.0
Modal v1.0 Foundations v1.0
Navigation v1.0 Foundations v1.0
Table v1.0 Foundations v1.0
Map Panel v1.0 Foundations v1.0

5. NEXT STEPS

Components v1.x (Next Wave)

Priority Component Status
1 Modal Not started
2 Navigation Not started
3 Search Not started
4 Table Not started
5 Data Grid Not started
6 Map Panel Not started

Future Foundations

Version Trigger Estimated
v2.0 New platform (e.g., native mobile), new accessibility standard, major rebrand Unknown

ÄNDRINGSHISTORIA

Version Datum Beskrivning
1.0 2026-07-02 Initial freeze: Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done

STATUS

FROZEN

  • No new foundation concepts without v2.0 RFC
  • No foundation modifications without v2.0 RFC
  • Components can be added freely within v1.x