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
@@ -0,0 +1,210 @@
|
||||
# RELEASE DEFINITION
|
||||
|
||||
**Landvex Design System v1.0**
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Version** | 1.0 |
|
||||
| **Status** | DRAFT — Under development |
|
||||
| **Target** | Production-ready design system |
|
||||
|
||||
---
|
||||
|
||||
## Release Gate
|
||||
|
||||
This document defines what must be complete before Landvex Design System v1.0 can be declared ready.
|
||||
|
||||
---
|
||||
|
||||
## Foundation
|
||||
|
||||
| Item | Status | Notes |
|
||||
|------|--------|-------|
|
||||
| Governance | ✅ | Constitution, Specification, Token Philosophy, Anti-Patterns |
|
||||
| Token Philosophy | ✅ | Three levels, lifecycle, review gate, DTCG |
|
||||
| Token Lifecycle | ✅ | Draft → Experimental → Stable → Deprecated → Removed |
|
||||
| Design Anti-Patterns | ✅ | 21 anti-patterns across 5 categories |
|
||||
| Document Hierarchy | ✅ | 7 levels, conflict resolution |
|
||||
|
||||
**Gate:** All items must be ✅
|
||||
|
||||
---
|
||||
|
||||
## Tokens
|
||||
|
||||
| Item | Status | Notes |
|
||||
|------|--------|-------|
|
||||
| Primitive Tokens | ✅ | Spacing, radius, z-index, opacity, blur, borders |
|
||||
| Semantic Tokens | ✅ | Neutral + Status (surface/border/text) |
|
||||
| Component Tokens | 🟡 | Button, Data Grid examples |
|
||||
| Export Format | ✅ | DTCG JSON, CSS, Swift, Kotlin |
|
||||
|
||||
**Gate:** All items must be ✅
|
||||
|
||||
---
|
||||
|
||||
## Foundations
|
||||
|
||||
| Item | Status | Notes |
|
||||
|------|--------|-------|
|
||||
| Typography | ✅ | Information levels, Inter + JetBrains Mono |
|
||||
| Colors | 🟡 | Foundation ✅, Semantic ✅, Brand ⏳, Map ✅ |
|
||||
| Motion | ✅ | Intention-based tokens, reduced motion |
|
||||
| Grid | ⏳ | Breakpoints defined, grid system pending |
|
||||
| Elevation | ⏳ | Shadow scale pending |
|
||||
| Radius | ✅ | 5-step scale |
|
||||
|
||||
**Gate:** Typography, Colors, Motion must be ✅
|
||||
|
||||
---
|
||||
|
||||
## Components
|
||||
|
||||
### Tier 1 — Canonical (100% required)
|
||||
|
||||
| Component | Status | Notes |
|
||||
|-----------|--------|-------|
|
||||
| Button | ✅ | Gold standard, full RFC-level spec |
|
||||
| Input | ⏳ | Pending |
|
||||
| Select | ⏳ | Pending |
|
||||
| Card | ⏳ | Pending |
|
||||
| Modal | ⏳ | Pending |
|
||||
| Navigation | ⏳ | Pending |
|
||||
| Table | ⏳ | Pending |
|
||||
| Data Grid | ⏳ | Pending |
|
||||
| Search | ⏳ | Pending |
|
||||
| Map Panel | ⏳ | Pending |
|
||||
|
||||
**Gate:** All Tier 1 components must be ✅
|
||||
|
||||
### Tier 2 — Derived (80% required)
|
||||
|
||||
| Component | Status | Notes |
|
||||
|-----------|--------|-------|
|
||||
| Badge | ⏳ | Pending |
|
||||
| Alert | ⏳ | Pending |
|
||||
| Toast | ⏳ | Pending |
|
||||
| Tooltip | ⏳ | Pending |
|
||||
| Accordion | ⏳ | Pending |
|
||||
| Tabs | ⏳ | Pending |
|
||||
| Breadcrumb | ⏳ | Pending |
|
||||
| Pagination | ⏳ | Pending |
|
||||
| Empty State | ⏳ | Pending |
|
||||
| Skeleton | ⏳ | Pending |
|
||||
|
||||
**Gate:** At least 8 of 10 must be ✅
|
||||
|
||||
### Tier 3 — Domain (production-only)
|
||||
|
||||
| Component | Status | Notes |
|
||||
|-----------|--------|-------|
|
||||
| KPI Card | ⏳ | Pending |
|
||||
| Map Overlay Panel | ⏳ | Pending |
|
||||
| Layer Selector | ⏳ | Pending |
|
||||
| Mission Status | ⏳ | Pending |
|
||||
| Dataset Card | ⏳ | Pending |
|
||||
| Geospatial Inspector | ⏳ | Pending |
|
||||
| Asset Summary | ⏳ | Pending |
|
||||
| Coordinate Picker | ⏳ | Pending |
|
||||
| Timeline Panel | ⏳ | Pending |
|
||||
|
||||
**Gate:** Only components used in production need to be ✅
|
||||
|
||||
---
|
||||
|
||||
## Validation
|
||||
|
||||
| Item | Status | Notes |
|
||||
|------|--------|-------|
|
||||
| Accessibility | 🟡 | WCAG 2.1 AA baseline defined, component specs pending |
|
||||
| Acceptance Criteria | 🟡 | Template defined, per-component criteria pending |
|
||||
| AI Design Principles | ✅ | Full AI governance rules |
|
||||
| Component Decision Tree | ✅ | Decision trees for all categories |
|
||||
| Component Template | ✅ | Standard template for all components |
|
||||
| DDR | ⏳ | Framework defined, records pending |
|
||||
|
||||
**Gate:** AI Design Principles, Component Decision Tree, Component Template must be ✅
|
||||
|
||||
---
|
||||
|
||||
## Production
|
||||
|
||||
| Item | Status | Notes |
|
||||
|------|--------|-------|
|
||||
| Design QA | ⏳ | Manual process defined, automated pipeline pending |
|
||||
| Release Checklist | 🟡 | Structure defined, completion pending |
|
||||
| Version Tag | ⏳ | `design-system-v1.0.0` |
|
||||
|
||||
**Gate:** Release Checklist must be ✅
|
||||
|
||||
---
|
||||
|
||||
## Current Progress
|
||||
|
||||
| Category | Completion | Weight |
|
||||
|----------|-----------|--------|
|
||||
| Foundation | 100% | 20% |
|
||||
| Tokens | 85% | 15% |
|
||||
| Foundations (design) | 70% | 15% |
|
||||
| Components (Tier 1) | 10% | 30% |
|
||||
| Validation | 60% | 10% |
|
||||
| Production | 20% | 10% |
|
||||
|
||||
**Weighted Total:** ~55%
|
||||
|
||||
---
|
||||
|
||||
## Next Milestones
|
||||
|
||||
1. **Grid + Elevation** → Complete foundations
|
||||
2. **Input, Select, Card** → Begin Tier 1 components
|
||||
3. **Brand Palette** → Complete color system
|
||||
4. **Tier 1 completion** → Major milestone
|
||||
5. **Tier 2 (80%)** → Component library usable
|
||||
6. **Design QA pipeline** → Production readiness
|
||||
|
||||
---
|
||||
|
||||
## Release Criteria
|
||||
|
||||
Landvex Design System v1.0 is ready when:
|
||||
|
||||
- [ ] All Foundation items ✅
|
||||
- [ ] All Token items ✅
|
||||
- [ ] Typography, Colors, Motion ✅
|
||||
- [ ] All Tier 1 components ✅
|
||||
- [ ] 80% of Tier 2 components ✅
|
||||
- [ ] AI Design Principles ✅
|
||||
- [ ] Component Decision Tree ✅
|
||||
- [ ] Component Template ✅
|
||||
- [ ] Release Checklist ✅
|
||||
- [ ] Version tag applied
|
||||
|
||||
---
|
||||
|
||||
## Post-v1.0
|
||||
|
||||
Items planned for v1.1 or v2.0:
|
||||
|
||||
- Automated Design QA pipeline
|
||||
- Visual regression testing
|
||||
- Full Tier 3 domain components
|
||||
- Dark mode specification
|
||||
- Additional map layer palettes
|
||||
- Advanced data visualization colors
|
||||
|
||||
---
|
||||
|
||||
## ÄNDRINGSHISTORIA
|
||||
|
||||
| Version | Datum | Beskrivning |
|
||||
|---------|-------|-------------|
|
||||
| 1.0 | 2026-07-02 | Initial release definition with gates and milestones |
|
||||
|
||||
---
|
||||
|
||||
## STATUS
|
||||
|
||||
**DRAFT — Under development**
|
||||
|
||||
Update as items are completed.
|
||||
Reference in New Issue
Block a user