Apple playground

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.

Run the playground Browse components

Real package, real runtime

The gallery uses the local Lumen package, so component behavior and tokens match the code in this repository.

Available on the App Store

Take the Lumen Playground with you

Version 1.0 is available for iPhone, iPad, and Mac. The same listing installs the native gallery for the Apple device you are using.

View on the App Store

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.xcodeproj

pnpm playground:apple:build
swift run --package-path apps/playground-apple LumenApplePlayground

Installing 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.