Skip to main content

Customization

The Lune SDK is designed to be fully customizable so it blends seamlessly with your app.

Customize the native implementation

  1. Open Terminal and navigate to your project's root directory.
  2. Run Runner.xcworkspace. This opens the project in Xcode.
  3. Modify the project as necessary, following the Lune iOS 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