Getting Started/Overview
v2.0 — Stable

What is SwiftDS?

SwiftDS is a production-ready SwiftUI design system with 60+ components, centralised design tokens, spring-physics micro-interactions, and native dark mode support — covering iOS, macOS, watchOS, and visionOS.

Core Principles

Token-first

Every colour, spacing value, shadow, and animation references a named token. Never hardcoded values.

Composable

Product components are built from base components. Token updates propagate automatically.

Accessible

All components meet Apple HIG minimum tap target sizes and support Dynamic Type out of the box.

Animated

Spring physics animations on every interactive element. No linear durations — always natural.

Package Structure

DesignSystem/
DesignSystem/
├── Package.swift                    // Swift Package Manager manifest
└── Sources/DesignSystem/
    ├── Foundations/
    │   ├── DSTokens.swift           // Colours, spacing, radius, shadows, animations
    │   └── DSTypography.swift       // Text styles and DSText component
    ├── Components/
    │   ├── Buttons/DSButton.swift
    │   ├── Inputs/DSInputs.swift
    │   ├── Navigation/DSNavigation.swift
    │   ├── Feedback/DSFeedback.swift
    │   ├── DataDisplay/DSDataDisplay.swift
    │   ├── Layout/DSLayout.swift
    │   ├── CommandPalette/DSCommandPalette.swift
    │   ├── Analytics/DSAnalytics.swift
    │   ├── Activity/DSActivityFeed.swift
    │   ├── UserProfile/DSUserProfile.swift
    │   ├── Settings/DSSettings.swift
    │   ├── Onboarding/DSOnboarding.swift
    │   └── Marketing/DSMarketing.swift
    └── Showcase/
        ├── DSShowcaseApp.swift       // Interactive preview of all base components
        └── DSAdvancedShowcase.swift  // Interactive preview of all product components

Platform Support

iOS

17+

macOS

14+

watchOS

10+

visionOS

1+

Next Steps