主题套件

Requirements

Installation

Swift Package Manager. In Xcode: File ▸ Add Package Dependencies… and enter the repository URL, or add it to your Package.swift:

dependencies: [
    // Core only — a plain install resolves ZERO third-party packages.
    .package(url: "https://github.com/isamercan/ThemeKit.git", from: "1.3.0"),

    // Opt into an add-on's dependency via package traits (Swift 6.1+):
    // .package(url: "https://github.com/isamercan/ThemeKit.git", from: "1.3.0",
    //          traits: ["Lottie", "Calendar"]),
],
targets: [
    .target(
        name: "MyApp",
        dependencies: [
            .product(name: "ThemeKit", package: "ThemeKit"),
            // Or, for just the theme layer (tokens + @Environment(\.theme), no components):
            // .product(name: "ThemeKitCore", package: "ThemeKit"),
            // Only with the matching trait enabled above:
            // .product(name: "ThemeKitLottie", package: "ThemeKit"),
            // .product(name: "ThemeKitCalendar", package: "ThemeKit"),
        ]
    ),
]

Quick start

Install the theme once at the root, then build with token-bound views:

@main
struct MyApp: App {
    init() { Theme.shared.applyPersistedConfig() }   // restore last-used theme (optional)
    var body: some Scene {
        WindowGroup {
            ContentView().themeKit()            // inject + repaint on theme change
        }
    }
}

struct ContentView: View {
    @ThemeContext private var theme
    var body: some View {
        VStack(spacing: theme.spacing(.md)) {
            Text("Welcome").textStyle(.headingBase)
            PrimaryButton("Get started") { await signIn() }
        }
        .padding(theme.spacing(.base))
        .background(theme.background(.bgWhite))
        .cornerRadius(.base)
        .themeShadow(.elevated)
    }
}

Theme.shared.loadTheme(named: "oceanTheme")          // runtime switch

Screenshots

The demo app on device — the component catalog, live theming, the design-token gallery, and a full booking flow built entirely from ThemeKit components.

Component catalog	Live theming · 33 presets	Design-token gallery	Theme Generator
Button · variants	DataTable · sort/paginate	Example · search	Example · detail

Real screens from the bundled Demo app, not mockups — every pixel is a ThemeKit component reading live design tokens.

Demo

Demo/ — a SwiftUI app (local package reference) with Components (gallery), Themes (the ThemePicker + a live preview), Colors (token gallery + live Theme Configurator), Type, Layout (spacing / radius / shadow tokens), and Example (a full flow built from the real components), plus a light/dark switcher.

Theming your app (Configurator export)

The library ships a runtime token generator (ThemeGenerator, a Swift port of tools/gen_tokens.py): from a handful of inputs it regenerates the whole palette, neutral ramp, surfaces, borders, text, and radius / spacing / font / shadow ramps — on device, no Python and no baked palette files.

The Demo's Theme Configurator (Colors tab) lets you dial in an accent color + tint + scale knobs + font + dark and exports a ThemeConfig recipe. To apply one:

// a) one-liner (paste the configurator's "Apply (Swift)" export)
Theme.shared.applyGenerated(primaryHex: "ff0d87", tint: 0.13, radiusScale: 1.0, font: "Montserrat")

// b) ship the Codable recipe as a resource (the configurator's `theme.json`)
let cfg = try ThemeConfig(jsonData: Data(contentsOf: themeJSONURL))
Theme.shared.apply(cfg)
Theme.shared.persistConfig()                            // remember across launches

// c) generator-free: bundle the pre-baked token JSON ("Copy full token JSON")
Theme.shared.setTheme(jsonData: Data(contentsOf: tokensURL))

ThemeConfig is Codable / Sendable / Equatable — persist it, sync it, A/B it.

Components

175 token-bound components, grouped by complexity:

- Atoms (44) — Badge, Chip, Avatar, Icon, Rating, Spinner, StatusDot, ProgressBar, PriceTag, PointsBadge, CountdownTimer, QRCode, Barcode, Aura, TiltCard, CodeBlock… - Molecules (64) — TextInput, OTPInput, Select, Checkbox, RangeSlider, SearchBar, TimeField, GuestSelector, PriceHistogram, InstallmentSelector, CurrencyPicker, Dropdown, ScrubGallery, buttons… - Organisms (67) — Card, Carousel, DataTable, Accordion, Timeline, NavigationBar, Sidebar, FlightCard, FareSummary, ReviewCard, LoyaltyCard, SeatMap, LocationCard, HotelResultCard, BoardingPass, BrowserFrame, WindowFrame, PhoneFrame…

Every component is curated by category in the DocC catalog, and listed with a verified usage snippet on the docs site — Atoms · Molecules · Organisms.

Component gallery

Rendered straight from the library via ImageRenderer (plain <img> so they render everywhere, including the GitHub mobile app) — regenerate with make screenshots. Interactive overlays (Dialog, Drawer, Tour, BottomSheet…) and media components are best seen live in the Demo app.

Loading the file from elsewhere (extensions / frameworks)

Zero-config assumes Bundle.main + table "ThemeKit". If your catalog ships in an app extension (whose .main is the extension) or in a framework that embeds ThemeKit, or you use a different table name, point ThemeKit at it once at launch:

ThemeKitStrings.register(bundle: .myFrameworkBundle, table: "ThemeKit")

Precedence (highest wins): per-call parameter (e.g. ValidationRule.required("…")) → your catalog (forced locale → device language → your English rewording) → ThemeKit's bundled catalog → the English source. Per-call overrides always win; with no consumer catalog the output is byte-identical to stock ThemeKit. Full walkthrough: Localization guide · design rationale: ADR-0003.

Note: .xcstrings resolves only when compiled — Xcode/xcodebuild do this for app targets automatically (a bare swift build of the library copies it verbatim). Your catalog lives in the app target, so real apps are always fine.