Are you tired of starting from scratch every time you want to launch a new app? Do you wish there was a way to create multiple apps from a single codebase without having to rewrite code for each one? Look no further than whitelabel app, a game-changing solution that lets you do just that.

What is Whitelabel App?

Whitelabel app is a production-ready React Native white-label app system that empowers you to power multiple completely different apps from a single codebase. This means you can change brands instantly with just an environment variable – no code changes required! With whitelabel app, you can create seven unique brand themes, each with its own set of features and industry-specific configurations.

How Does it Work?

To get started, simply clone the repository, install dependencies, and generate assets for your desired client. Then, start the app with a specific client using an environment variable (e.g., CLIENT=acme npm start). The included web dashboard provides a no-code interface for creating and configuring new white-label apps with live preview.

Features

Whitelabel app offers a range of features to help you create and deploy your branded apps quickly:

  • Zero code changes – switch brands with environment variable
  • Zod validation – all configurations validated before runtime
  • Industry-specific – custom features per client
  • Production-ready – separate App Store/Play Store builds
  • Web-based UI – no coding required to create new clients
  • Live preview – see your branding in real-time
  • Color pickers – visual interface for brand colors
  • One-click export – download ready-to-use config files

Configuring Your App

To configure your app, follow these steps:

  1. Open the dashboard at http://localhost:3001 and enter your app name (e.g., "My Fitness App").
  2. Choose your brand colors using visual color pickers.
  3. Toggle feature flags (e.g., authentication, push notifications, dark mode).
  4. Set API configuration (e.g., API URL, support email, default language).

Live Preview and Export

As you make changes, watch the mobile preview update in real-time:

  • Header shows your app name with primary color
  • Buttons display with your chosen colors
  • Stats and UI elements update instantly
  • Color palette preview at bottom

When you're happy with your configuration, click "Download Configuration File" to export it. Save the file to your main project's configs/ directory.

Deploying Your New App

To deploy your new app, follow these steps:

  1. Generate placeholder assets using npm run generate-assets.
  2. Validate the configuration using npm run validate.
  3. Launch your new app using CLIENT=yourapp npx expo start --clear.

Your branded app is now running with your custom colors and configuration!