Add the Swift package
In Xcode, choose File → Add Package Dependencies, paste the repository URL, and pin exact version 4.0.0 for reproducible builds. Use a compatible-version rule only when the application accepts compatible updates.
Apple Installation
Check requirements, install the package, and configure your first native screen. Learn how with Lumen for Apple / SwiftUI.
Get started
Install and configure
LumenUI installs through Swift Package Manager; no npm package, CocoaPod, or copied source is required. Add the repository URL, pin exact version 4.0.0 for reproducible builds, and attach the LumenUI product to your application target.
Before you begin
What you need
- macOS with Xcode 16 or newer and the SDK for the Apple platform you target
- An existing SwiftUI application targeting a supported Apple platform
- An Apple Developer account only for physical-device or TestFlight distribution
Link LumenUI to the target
Select the LumenUI library product and attach it to the application target that renders your SwiftUI views.
Import, theme, and run
Import LumenUI, wrap the root surface in lumenTheme, select a simulator, and press Run.
# Xcode → File → Add Package Dependencies…
https://github.com/santi020k/lumen
# Dependency Rule
Exact Version: 4.0.0
# Add this product to your application target
LumenUI// Package.swift
dependencies: [
.package(
url: "https://github.com/santi020k/lumen",
exact: "4.0.0"
)
],
targets: [
.target(
name: "YourApp",
dependencies: [
.product(name: "LumenUI", package: "lumen")
]
)
]import LumenUI
@main
struct ExampleApp: App {
var body: some Scene {
WindowGroup {
LumenSurface {
LumenText("Welcome", variant: .title)
LumenButton("Continue", action: continueFlow)
}
.lumenTheme(.light)
}
}
}