SPB Git

Repository Public License

DESIGN_SYSTEM.md 2.8 KB

# Design system

The identity is a night sky turning into a sunrise. Dark only.

# Palette (App/Design/Theme.swift)

Role Token sRGB
Night background midnight 7, 9, 22
deepIndigo 18, 16, 50
indigo 46, 41, 115
Atmosphere violet 122, 92, 250
azure 84, 143, 255
Sunrise ember 250, 92, 74
sunrise (accent) 255, 143, 66
gold 255, 201, 107
peach 255, 222, 194
Semantic success 92, 224, 163
danger 255, 102, 115

Theme.sky(progress) blends night to day and drives the mission runner background and the Nightstand sunrise. sunriseGradient (ember → sunrise → gold) marks the primary action; nightGradient (violet → azure) marks secondary emphasis.

# Typography

SF Rounded throughout. Clock digits use Font.clock(size): rounded, light, monospaced digits. Titles are semibold rounded; captions medium; section labels are small uppercase with tracking (Overline).

# Components

Component Use
AuroraBackground(warmth:) animated sky behind every screen; paused with Reduce Motion
.glassCard() layered translucent surface with a light edge
.orixScreen() standard screen chrome
PrimaryButtonStyle, SecondaryButtonStyle 54 pt capsule buttons
Chip selectable capsule (weekdays, options)
ClockFaceView(style:date:nextAlarm:) analog, digital, hybrid, minimal, chronograph
TimeDial circular hour and minute selector with haptic ticks and ± buttons
ScenarioTimelineView the morning as a timeline, shared by the editor and Studio
MissionScaffold instruction line, round counter, content
AlarmStatusBadge verified system status with colour, symbol and text

# Rules

  • A status is never carried by colour alone: every badge has a symbol and a label; mission panels have shapes; "on" wires are thicker.
  • Touch targets are at least 44 pt, larger in missions.
  • Custom controls expose VoiceOver labels, values and adjustable actions; gesture-only interactions have a tap alternative.
  • An alarm that is not confirmed by the system never looks scheduled.

# Sound

Eighteen files, all synthesised by Scripts/make-sounds.py (additive and FM synthesis, filtered noise, envelopes): nine alarm loops (.caf, 8 to 20 s, for AlarmKit), five soundscapes (.m4a, 72 s seamless loops), four interface effects. No third-party sample. The app only changes its own gain; the device volume sets the ceiling.

# Haptics

Core Haptics patterns per event (tick, selection, success, failure, warning, mission complete, wake confirmation, alarm set) behind Haptics.play(_:), with UIKit feedback as a fallback and a global setting.

Files main
Menu

Theme