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.
This commit is contained in:
Bernt
2026-07-02 11:23:10 +00:00
parent 325a872fdb
commit 78436cecc2
17 changed files with 201 additions and 0 deletions
+43
View File
@@ -0,0 +1,43 @@
# 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.
## Quick Links
- [Foundations v1.0](foundations/FOUNDATIONS-v1.0.md)
- [Compliance Matrix](COMPLIANCE_MATRIX.md)
- [Component Template](foundations/COMPONENT_TEMPLATE.md)
- [Semantic Color System](foundations/SEMANTIC_COLOR_SYSTEM.md)
+158
View File
@@ -0,0 +1,158 @@
# 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