Customization
The Lune SDK is designed to be fully customizable so it blends seamlessly with your app.
Customize the native implementation
- iOS
- Android
- Open Terminal and navigate to your project's root directory.
- Run
Runner.xcworkspace. This opens the project in Xcode. - Modify the project as necessary, following the Lune iOS SDK Documentation.
- Open Android Studio.
- Open your project's
androiddirectory in Android Studio. You can do this from the context menu by right-clicking theandroiddirectory. - Modify the project as necessary, following the Lune Android SDK Documentation.
Customization Options
1. lune-config.json
All SDK UI theming is controlled by a single JSON file. It's just a configuration file where you change values to instantly adjust the SDK's appearance.
You can customize directly from lune-config.json:
- Colors (with support for light/dark modes)
- Sizes, spacing, and arrangements
- Corner radius of components
- others
This means you don't need to touch the SDK's code — you simply edit the JSON and the SDK adapts.
2. Assets & Wording (Extra Customization)
Beyond the config file, you can also customize:
- Icons & Assets → replace SDK's default icons with your own app's assets
- Wording & Labels → override default texts with your own copy or translations