Changelog
Version history for the Bumi Design System.
v1.0.0 — March 2026
Initial Release
The first complete version of the Bumi Design System, establishing the visual language for all RetailOS applications.
Foundation
- Design Principles — Five pillars: Warmth, Restraint, Clarity, Indonesian Character, Consistency
- Colors — Warm neutral palette with Forest Green brand color, semantic colors, dark mode mapping
- Typography — Three-font system: Plus Jakarta Sans (body), Lora (display), JetBrains Mono (data)
- Spacing — 4px base unit, spacing scale from 4px to 64px
- Elevation — Warm-tinted shadow system with 6 levels
- Motion — Duration and easing tokens, hover/transition patterns
- Iconography — Lucide icon library, size/stroke guidelines
- Illustration — Isometric illustration style guide, warm color palette
Layout
- Floating Shell — Signature desktop layout with 12px viewport inset
- Sidebar — Navigation component with collapsed/expanded states
- Bottom Tabs — Mobile tab navigation pattern
- Page Header — Title, breadcrumb, and action bar system
- Responsive — Breakpoint system and adaptive rules
Patterns (14)
- Stat Cards — 4-card metric strip with change indicators
- Data Table — Sortable/filterable table with column type conventions
- Alert Card — Severity-based warning cards
- Approval Flow — Multi-step approval workflow
- Settings Page — Horizontal tabs with key-value form layout
- Checklist — Progress tracking with numbered steps
- Activity Feed — Timeline event log
- Device Card — Hardware device status display
- Scan Input — Barcode/RFID/manual input pattern
- Photo Capture — Camera interface with guide frame
- Shift Flow — POS shift open/close with denomination helper
- Member Card — 3D animated membership card
- PIN Pad — Secure PIN entry with haptic feedback
- Date Navigation — Previous/next day browser
Tokens
- Web CSS — Complete CSS custom properties for all web portals
- Mobile Tokens — React Native / NativeWind token mapping
- Dark Mode — Full dark mode token set with testing checklist
- Per-App Themes — Accent color overrides for 11 applications
Guidelines
- Accessibility — WCAG 2.1 AA compliance targets, contrast ratios, keyboard navigation
- Bahasa Indonesia — UI writing conventions, number/date/currency formatting
- Dos and Don'ts — Visual rules and anti-patterns
- Changelog — This document
Contributing
To propose changes to the design system, open a pull request against the docs/design-system/ directory. Include before/after screenshots and the rationale for the change.
Versioning
Bumi follows semantic versioning:
- Major (2.0.0) — Breaking changes to tokens or component APIs
- Minor (1.1.0) — New patterns, components, or tokens (backward-compatible)
- Patch (1.0.1) — Documentation fixes, typo corrections, clarifications