SPB Git

Repository Public MIT

design-system.md 4.0 KB

# ORIX design system (as implemented in Packages/ORIXUI)

The design system is code, not a mock-up: tokens and components live in ORIXUI and every environment is built from them.

# Tokens (Tokens/Tokens.swift)

Group API Notes
Colour ORIXColor.background / surface / surfaceRaised / hairline / textPrimary / textSecondary / textTertiary Adaptive light / dark; shared with ORIX Scan
Keys ORIXColor.keyDigit / keyFunction / keyPressed Digit keys are the lightest surface, function keys one step darker
Brand ORIXColor.brandViolet / brandIndigo / brandCyan / brandGradient Icon, primary emphasis
Semantic success / warning / failure / finance Each has a light and a dark value chosen for text contrast on its background
Series ORIXColor.series (8) Graph and chart palette, distinguishable in both appearances
Spacing ORIXSpacing.xxs…xxl = 2, 4, 8, 12, 16, 24, 32
Radius ORIXRadius.key 20 / card 22 / chip 12 / field 12 Continuous corners
Motion ORIXMotion.press / mode / value Springs of 0.22 s and 0.38 s; value changes ease out in 0.18 s
Type ORIXFont.display(size) / expression / key / value / valueEmphasis / mono System fonts only; every numeric style uses monospaced digits so values do not jitter

# Environment identity (Core/CalcMode.swift)

Environment Symbol Tint (light / dark)
Standard plus.forwardslash.minus #4F46E5 / #818CF8
Scientific function #7C3AED / #A78BFA
Financial chart.line.uptrend.xyaxis #B45309 / #F59E0B
Graph point.topleft.down.to.point.bottomright.curvepath #0E7490 / #22D3EE
Math x.squareroot #BE185D / #F472B6
Statistics chart.bar.xaxis #15803D / #34D399
Convert arrow.left.arrow.right #0F766E / #2DD4BF
Workspace square.grid.3x1.below.line.grid.1x2 #C2410C / #FB923C

The tint is the only thing that changes between environments: layout grammar, typography and neutrals stay constant.

# Components

Component Purpose
KeyButton, Keypad, KeySpec Calculator keys with roles (digit, function, operation, accent, destructive), long-press alternates, haptics, VoiceOver labels, and a grid whose rows align to both edges even with different key counts
ORIXCard, ORIXPage Card surface with an optional uppercase section header; a scrolling page with readable width
ResultRow Label + value; tap to select, long-press for Quick Actions (copy, use in calculator, save to workspace, convert, explain, share)
NumberField Numeric input that accepts either a number in the device locale or any expression (1200*12), evaluated by the shared engine
PillPicker Horizontal single-selection pills
MessageBanner Error / warning / information with an icon, never colour alone
PrimaryButton The one main action of a form
VerifiedBadge Renders only when a verification report contains checks
ResultDetailView ORIX Explain sheet: formula, inputs, steps, result, assumptions, executed checks

# Layout rules

  • iPhone: one column. The mode strip is always on screen; the active environment's chip expands to show its name.
  • iPad: a sidebar that collapses to an icon rail but never disappears, an optional companion calculator pane, and environment layouts with two or three zones. The Standard and Scientific calculators keep a hand-sized keypad (maximum width 520 pt) next to the history instead of stretching across the screen.
  • Touch targets are at least 44 × 44 pt, except keys in the densest scientific rows, which keep at least 28 pt of height on the smallest supported phone and scale up with the screen.

# Haptics

Light impact on key press, rigid impact on "=", selection feedback on mode and picker changes, notification feedback on errors and on successful store / copy. All haptics follow the user's setting.

Files main
Menu

Theme