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.
5.2 KiB
5.2 KiB
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
- Grid + Elevation → Complete foundations
- Input, Select, Card → Begin Tier 1 components
- Brand Palette → Complete color system
- Tier 1 completion → Major milestone
- Tier 2 (80%) → Component library usable
- 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.