Changelog

Every release, summarised. Breaking changes are marked explicitly.

v1.8.0

2026-07-09

Latest

Progress Bar, KPI Tile, Gauge, and Context Menu components with new design tokens for progress tracking and typography.

Added

  • →Progress Bar component — non-interactive progress indicator with 4 variants, 3 sizes, indeterminate shimmer mode, and specular top-edge highlight
  • →KPI Tile component — dashboard metric card with icon well, bold value, trend delta, and optional progress bar; 5 semantic variants
  • →Gauge component — 270° arc ring for utilization metrics with automatic color thresholds based on percentage
  • →Context Menu component — glass-backed right-click/long-press menu with actions, separators, keyboard shortcuts, and destructive styling
  • →New tokens: --progress-track, --progress-success, --progress-warning, --progress-danger, --brand-user
  • →New typography tokens: --text-micro (10px), --text-nano (9px), --text-display (48px)
  • →New motion presets: sheetEntry, cardAppear, dropSpring, progressFill, alluvial, arcRing

v1.7.0

2026-07-02

Latest

Source alignment: typed TypeScript token layer, design-system umbrella, site/library separation, and a vitest test suite — bringing the web codebase into structural parity with the Swift SitkaTokens convention.

Added

  • →Typed token layer — src/design-system/tokens/ with typed TS constants (colors, spacing, typography, motion, radius) mirroring the Swift SitkaTokens namespace
  • →Glass abstraction — glassSurface() className factory centralising blur/opacity values; Button and Card now consume it instead of inline Tailwind strings
  • →Motion presets — src/design-system/motion/ with spring(), fadeIn(), scaleIn() constants mirroring SFMotion.press / SFMotion.cardAppear
  • →Platform hooks — useReducedMotion and usePlatform in src/design-system/hooks/
  • →Design-system umbrella — src/design-system/index.ts barrel re-exporting tokens, glass, motion, and hooks
  • →Component barrel — src/components/ui/index.ts named-export barrel for all 43 UI components
  • →Vitest test suite — 11 tests covering token values, Button rendering, and Card variants; vitest.config.ts with @/ path alias

Changed

  • →Website chrome isolated to src/site/ (layout, docs, search, navigation) — no longer co-mingled with the component library under src/components/
  • →37 *.figma.tsx Figma Code Connect sidecars relocated from src/components/ui/ to .figma/src/ — eliminating IDE noise and Git conflict risk on every Figma sync
  • →src/lib/ scoped to library utilities only; navigation.ts moved to src/site/navigation.ts

v1.6.0

2026-06-12

watchOS habit-tracking patterns, Quick Log, Barcode Scanner, GTD Task Inbox, new components (KPI Tile, Arc Gauge, Streak Ring, Payment Progress, Snackbar, Segmented Button Simple) — sourced from habitflo, workflo, scanflo, orgflo, invoiceflo, and JobFlo.

Added

  • →New Component: WatchOS Components — GlowProgressBar, PhaseStripHeader, PhaseBadge for watchOS interfaces (workflo)
  • →New Component: KPI Tile / StatTile — SFStatTile with icon, value, label, and trend indicator (JobFlo/Warren)
  • →New Component: Arc Gauge — SFArcGauge 270° arc ring with automatic color thresholds (JobFlo)
  • →New Component: Snackbar — SitkaSnackbar with icon and error state support (invoiceflo)
  • →New Component: Segmented Button (Simple) — SitkaSegmentedButtonSimple for horizontal segmented controls (invoiceflo)
  • →New Component: Payment Progress — PaymentProgressView milestone-based indicator with status dots (invoiceflo)
  • →New Component: Streak Ring — StreakRingView circular progress with streak count (habitflo)
  • →New Pattern: WatchOS Habit Tracking — WatchHabitRow, WatchComplicationView with WCSession integration (habitflo)
  • →New Pattern: Quick Log — Sentiment-based quick logging with radial gradient accent and haptic feedback (workflo)
  • →New Pattern: Davros Connectivity Monitor — Network health monitoring pill with diagnostic sheet (JobFlo)
  • →New Pattern: Barcode Scanner — ScanReticleOverlay (animated sweep line, corner brackets, cutout backdrop) + CaptureCardView bottom-sheet with loading/resolved/failed states (scanflo)
  • →New Pattern: GTD Task Inbox — InboxView / TodayView / UpcomingView with OFTask / OFProject / OFArea hierarchy and SyncService (orgflo)
  • →Token: phase colors (phase30, phase60, phase90), subtle status variants, new motion presets, progress track token

v1.5.0

2026-06-03

Interview Prep Hub, Ghost Employer Tracking, multi-provider Timesheet Sync, and QR local-network pairing — all sourced from JobFlo v1.5 and Warren's May sprint.

Added

  • →New Pattern: Interview Prep Hub — on-device AI streaming via Foundation Models (iOS 26+), five round types, streaming content card with live cursor
  • →New Pattern: Ghost Employer Tracking — Skaro suspected/confirmed ghost classifications with badge, expandable banner, 14-day follow-up CTA, and contribution toggle
  • →Integration Settings: Multi-provider Timesheet Sync section — TimesheetProvider protocol, TimesheetSyncEngine, Clockify / Toggl Track / Timely providers with delete-window sync algorithm
  • →Mobile Time Logging: Local-network Pairing section — PairingView, QRScannerSheet (VisionKit DataScannerViewController), MobilePairingStore with Bonjour handshake
  • →Navigation: Interview Prep Hub and Ghost Employer Tracking added to the Mobile patterns group

v1.4.0

2026-06-02

Voice Memo & Dictation, Interview Email Parser, Document Assembler, and Compensation Take-Home Calculator.

Added

  • →New Pattern: Voice Memo & Dictation — VoiceMicButton dual-gesture (tap for live dictation, hold for audio memo), AudioMemoListView, VoiceDictationService (SFSpeechRecognizer), AudioRecorderService (AVAudioRecorder)
  • →New Pattern: Interview Email Parser — InterviewParser regex + NSDataDetector engine, InterviewConfirmationSheet with EKEventStore, Share Extension, and ParseInterviewTextIntent Siri shortcut
  • →New Pattern: Document Assembler & PDF Export — block checklist, ResumeExporter cross-platform PDFKit renderer, A4 layout, ShareLink / NSSavePanel
  • →Compensation Breakdown: Take-Home Calculator — TaxBreakdownView + TaxCalculatorService with 2026 progressive brackets for CA, AU, GB, SG, and 10 EU countries

v1.3.0

2026-05-09

New components, expanded CLI registry, sitka-ui npm package, and Figma library documentation.

Added

  • →New Components: Box, Stack (layout primitives), Navigation Menu, Menubar, Data Grid
  • →New Foundation Pages: Density System, Responsive Grid, RTL & i18n, Forced Colors, Component Lifecycle, Gestures, Haptics, Spatial Computing
  • →New Patterns: Activity Feed, Multi-select & Bulk Actions, Kanban Board, Gantt / Timeline, Analytics Dashboard, Chat & Conversation
  • →Figma library documentation — variables, Code Connect mappings, component reference, and workflow guide
  • →sitka-ui npm package — dual CJS/ESM build with full TypeScript types and a separate tokens entry point
  • →CLI registry expanded to 35 components with aliases (npx @sitka/cli add <component>)
  • →iOS SwiftUI ThemeManager how-to guide
  • →macOS SwiftUI library guide
  • →React Native and Android Compose library guides

v1.2.0

2026-05-08

Eight new components and full documentation for eight previously undocumented components.

Added

  • →New Components: Collapsible, Pagination, Spinner, Divider, Label, Toggle / Toggle Group, File Upload / Drop Zone, Drawer
  • →New Component Pages: Checkbox, Radio, Select, Switch, Tabs, Textarea, Command Palette, Sidebar
  • →New Pattern: Multi-step Wizard with step indicator and validation gating
  • →ARIA roles tables and keyboard interaction model tables across all interactive component pages
  • →New Foundation Pages: Accessibility (WCAG 2.1 AA), Contrast, Icons, Gestures, Haptics, Keyboard Shortcuts

v1.1.0

2026-05-08

New components, patterns, and accessibility improvements.

Added

  • →New Components: Slider (single/range), Date-Time Pickers, Date Range Picker, Carousel, Snackbar
  • →New Patterns: Collaboration & Sharing, Drag and Drop, Data Entry
  • →New Foundation: Accessibility page documenting WCAG 2.1 Level AA compliance

Improved

  • →Enhanced text contrast ratios for secondary and tertiary text tokens across light and dark modes
  • →Replaced hardcoded colour values with semantic tokens for consistent accessibility

v1.0.0

2026-05-05

Initial public release of Sitka Design System.

Added

  • →21 component pages: Button, Input, Modal, Navigation, Card, Badge, Avatar, Tooltip, Table, Split Button, Segmented Button, Breadcrumb, Combobox, Bottom Tab Bar, Bottom Sheet, Chip, OTP / PIN, Prompt Input, Code Block, Chat Message, Streaming Text
  • →17 foundation pages: Color, Typography, Spacing, Motion, Interaction, Writing, Data Visualisation, Charting, Glass, Shadows, Border Radius, Empty States, Loading States, AI Agent Standards, Desktop Layout, Keyboard Shortcuts, Spatial Computing
  • →Multi-platform: SwiftUI · iOS and SwiftUI · macOS code samples across all component pages
  • →Design token pipeline — CSS variables, Swift constants, and JSON export (W3C DTCG format)
  • →Library guides: React · Next.js, React · Vite, Tokens Only, iOS · SwiftUI, macOS · SwiftUI
  • →Figma token integration via the Figma Variables API
  • →Dark-first colour system with CSS custom properties and semantic token naming