SPB Git

Repository Public License

design-system.md 4.4 KB

# Design System

Source of truth: ORIXAudio/DesignSystem/Tokens/ORIXTokens.swift and ORIXAudio/DesignSystem/Components/ORIXComponents.swift.

# Principles

  1. The plot is the hero. Chrome is quiet so that measured data carries the colour.
  2. Colour means something. The seven band colours are used only for frequency. Status uses a separate small set.
  3. Never colour alone. Every coloured thing has a label, a symbol or a position that says the same thing.
  4. Numbers are set in tabular figures so readouts don't jitter.

# Colour

Neutral tokens are the ORIX family values used by ORIX Scan and ORIX Calc, with one adjustment noted below. They are copied into this app, not imported.

Token Light Dark Use
ink #F4F5FA #0A0D18 screen background
surface #FFFFFF #141828 cards
raised #EEF0F7 #1D2236 tiles, chips, controls inside cards
hairline #DDE0EA #262C42 1-point borders
text #0E1222 #F2F4FB primary text
textSecondary #4F566C #B1B8CE captions, units — the family value (#596078 / #A3AAC2) nudged for contrast at caption sizes
good #12925A #34D399 healthy, lossless
warning #B86A00 #FBBF24 notices, estimates, markers

ORIX Audio's own tokens:

Token Light Dark Use
cyan (accent) #0891B2 #22D3EE tint, selection, primary actions
violet (secondary) #7C3AED #8B5CF6 AI-generated content, gradient end
record #E11D48 #F43F5E record button, clipping
plot #0A0D18 #05070E plot background, dark in both appearances

Plots stay dark in light mode. The band colours and the spectrogram palettes were chosen against a dark ground; keeping it constant keeps their meaning and contrast constant.

# Band colours

Band Colour Short label
Sub-bass #7C3AED SUB
Bass #3B82F6 BASS
Low-mid #06B6D4 LO-MID
Mid #22C55E MID
Upper-mid #EAB308 UP-MID
Presence #F97316 PRES
Brilliance #F43F5E BRIL

The order follows frequency, low to high, and the same seven appear in the waveform, the band strip under the spectrum, the band meters and the analysis bars.

# Gradients

  • Brand: #22D3EE → #8B5CF6, top-leading to bottom-trailing. Used for the record ring, the play button and the brand mark — never for data.
  • Spectrum: the seven band colours left to right, each at its band's position on the frequency axis.

# Type

System fonts throughout, all built from text styles so they scale with Dynamic Type.

Role Style
Recording timer 60 pt (76 pt in regular width), ultra-light, rounded, tabular
Metric values title3, rounded, medium, tabular
Readouts (time, frequency, dB) footnote, monospaced, medium
Section titles subheadline, semibold, uppercase, tracked
Plot axes 9 pt monospaced

# Shape and spacing

Spacing scale 4, 8, 12, 16, 24 pt
Card radius 22 pt, continuous
Control radius 14 pt
Plot radius 16 pt
Borders 1 pt hairline

# Components

Component Purpose
ORIXCard surface with hairline border
PlotFrame the dark rounded container for every plot
SectionTitle uppercase title with an optional symbol; exposed as a header to VoiceOver
MetricTile label, tabular value, unit; one accessibility element
Chip status with a symbol and a word
LevelMeter RMS bar, peak tick, peak-hold tick, −12 and −6 dBFS marks, clip lamp
RecordButton gradient ring; circle becomes a rounded square while recording
CircleIconButton, ProgressRow, EmptyStateView, BandLegend, FlowLayout supporting pieces

# Motion and haptics

Motion is limited to the record button's shape change, the numeric transition of the timer and the plots themselves. With Reduce Motion the live plots update four to five times a second instead of 30–60. Haptics mark start, pause, resume, marker and save.

# Layout

Compact width: one column — plot, transport, a horizontal row of panel chips, scrolling content. Above 900 points: two columns — waveform, transport, spectrogram and spectrum on the left; info, analysis, transcript and notes on the right. The tab bar adapts to a sidebar on iPad.

Files main
Menu

Theme