platform-admin/boc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2e62e5fb80536b2c6d96bce717e88b87bea60578
boc/docs/design/RELEASE_DEFINITION.md
T
Bernt 500d9c052b docs: AI Design Principles + Button RFC + Release Definition 
- Motion System v1:
  - Renamed duration tokens from time-based (fast/slow) to intention-based
    (instant, interaction, transition, navigation, layout, context-change,
    attention, background)
  - Updated all component motion tables to use intention-based tokens
  - Rationale: AI reasons about purpose, not milliseconds

- Button gold standard (chapter 8.3.1):
  - Added RFC-level sections: Cognitive Purpose, When to use/NOT use,
    User Expectation, Interaction Contract, Failure Behaviour,
    Accessibility Contract, AI Contract
  - Sets the bar for all future component specifications

- AI_DESIGN_PRINCIPLES.md (v1.0, LOCKED):
  - Core principle: AI must be a design system citizen
  - Before-action rules: read hierarchy, check existing, apply New Component Rule
  - Token rules: no hardcoded values, semantic first, lifecycle, deterministic
  - Component rules: inheritance first, use template, document anti-patterns
  - Motion rules: intention-based duration, reduced motion, no decorative animation
  - Accessibility rules: WCAG 2.1 AA, no ARIA without purpose
  - AI Contract for Button: when to choose Button vs Link vs Icon Button

- RELEASE_DEFINITION.md:
  - Defines Landvex Design System v1.0 release gates
  - Foundation, Tokens, Foundations, Components (Tier 1/2/3),
    Validation, Production
  - Current progress: ~55%
  - Next milestones: Grid+Elevation, Input/Select/Card, Brand Palette

Rationale: AI rules before components (AI will write components).
Intention-based motion tokens for better AI reasoning. Button as RFC
sets the standard. Release definition creates clear target.
2026-07-02 08:58:29 +00:00

5.2 KiB
Raw Blame History

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 View Git Blame Copy Permalink