Try every component on Apple
The Apple gallery runs as an iOS app from Xcode and as a macOS Swift Package executable. Choose an iPhone simulator and press Run; signing is not required for the simulator.
Real package, real runtime
The gallery uses the local Lumen package, so component behavior and tokens match the code in this repository.
Take the Lumen Playground with you
Download Lumen Playground for iPhone, iPad, and Mac. Explore the native SwiftUI component gallery offline, with no account required.
From playground to your app
Try it. Read the source. Build with Lumen.
Search for a component, try its interactive states, and compare light and dark themes. Use the open-source app to see how Lumen components fit together, then follow the component reference to bring them into your own project.
Store releases and the repository can show different versions. Follow the local setup below to explore the workspace version; check the app’s release notes when comparing a store build.
Local gallery
Run the Apple playground
Choose the workflow that matches your development environment.
git clone https://github.com/santi020k/lumen.git
cd lumen
open apps/playground-apple/LumenApplePlayground.xcodeprojpnpm playground:apple:build
swift run --package-path apps/playground-apple LumenApplePlaygroundInstalling locally versus publishing
You can run the gallery locally before configuring any store account.
- Simulator builds do not require an Apple Developer account or signing.
- For a physical device or TestFlight, select your team under Signing & Capabilities.
- Archive the playground in Xcode only after choosing the final bundle identifier and signing team.