With whitelabel mode you run any number of brand variants from one shared app codebase – e.g. the same app for several customers, each with its own name, logo, colors, and store listing.
Note
Whitelabel projects are created in the project editor’s pro mode (deployment mode “whitelabel”). For getting started we recommend building a regular project first.
The concept
- Define the variant schema: you specify which properties differ per variant – as fields with a type (text, number, URL, color, file, dropdown, yes/no, JSON). Examples: app name, primary color, logo, feature toggles.
- Create variants: one variant per brand with ID, name, and values for all schema fields. Each variant also gets its own domains (web, backend) and bundle IDs (iOS/Android).
- Bind fields to the app: whitelabel components connect the schema fields with your app – the codebase reads the values and renders the respective branding.
What the platform does with it
- Each variant gets its own builds and Docker images – every brand is deployed separately.
- Each variant runs under its own domains; without a custom domain, the platform automatically assigns
<variant>.<project>.<organization-domain>. - Apps can be brought to the stores per variant with their own bundle ID.
- Components not marked as whitelabel (e.g. a shared backend) continue to run once for all variants.