Bernt
edf1e6e0d6
- FOUNDATIONS-v1.0.md updated:
- Added Landvex Core Principle and Design Constitution to frozen foundations
- Added Core Principle Rules to invariants (2.4)
- Reordered component priority: Modal, Search, Map Panel, Navigation, Table, Data Grid
- Reflects business value: search and maps are central to Landvex
- EXPERIENCE_AUDIT.md (v1.0, LOCKED):
- Four questions for every screen:
1. Can purpose be understood in 3 seconds?
2. Is 'Reality → Decision' visible?
3. Is it obvious what the user should do?
4. Does everything contribute to the decision?
- Three-second rule levels with verification method
- Audit process: select screens → apply questions → prioritize fixes → verify
- Example audit format
- Core Principle Check for RFCs: 4 questions before approval
- COMPONENT_TEMPLATE.md updated:
- Added Core Principle section to template
- Requires: decision support, cognitive load reduction, 3-second understanding
- RFC_DEFINITION_OF_DONE.md updated:
- Added Core Principle as criterion #2 (was 12 criteria, now 13)
- Exit criteria: must pass all 13
Rationale: Freeze foundation with Core Principle as highest authority.
Experience audit ensures all screens support decision-making.
Core Principle Check prevents components that don't serve the user.
Business-value prioritization: search and maps before tables.
170 lines
4.9 KiB
Markdown
170 lines
4.9 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 |
|
|
|------------|----------|---------|--------|
|
|
| Landvex Core Principle | `LANDVEX_CORE_PRINCIPLE.md` | 1.0 | ✅ Frozen |
|
|
| Design Constitution | `LANDVEX_DESIGN_CONSTITUTION.md` | 1.0 | ✅ Frozen |
|
|
| 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 Core Principle Rules
|
|
|
|
- **MUST** support "From Reality → Decision" flow
|
|
- **MUST** be understandable in 3 seconds (what), 10 seconds (process), 60 seconds (value)
|
|
- **MUST** reduce cognitive load for decision-making
|
|
- **MUST** answer: "What decision does this help the user make?"
|
|
|
|
### 2.5 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 |
|
|
|------------|---------|-------------|
|
|
| Core Principle | 1.0 | 2026-07-02 |
|
|
| Design Constitution | 1.0 | 2026-07-02 |
|
|
| 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 | Search | ⏳ Not started |
|
|
| 3 | Map Panel | ⏳ Not started |
|
|
| 4 | Navigation | ⏳ Not started |
|
|
| 5 | Table | ⏳ Not started |
|
|
| 6 | Data Grid | ⏳ 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: Core Principle, Design Constitution, 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
|