Bernt
78436cecc2
- 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.
159 lines
4.3 KiB
Markdown
159 lines
4.3 KiB
Markdown
# 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
|