Branding & White-label Options

Perfect — thank you for the detailed breakdown. Based on your answers, here's the complete Branding & White-Label Options section for your documentation, structured clearly and professionally.

---

Configuration & Customization

🎨 Branding & White-Label Options

Ridy is designed as a white-label platform, enabling clients to customize the look, feel, and identity of their apps. While driver and customer apps are fully brandable, certain core elements like BetterSuite references in the admin panel must remain intact due to licensing restrictions.

---

🖼️ App Logos, Icons & Splash Screens

All Flutter apps come with:

• Empty logo placeholders
• Integrated support for launch icon and splash screen generation

✅ Tools Included

Tool	Purpose
flutter_launcher_icons	Generates app launcher icons
flutter_native_splash	Creates platform splash screens

🔧 How to Customize

1. Place a 1024x1024 non-transparent icon in your project (e.g., assets/logo/icon.png)

2. Edit the config file located at each app's root:

   • flutter_launcher_icons.yaml
   • flutter_native_splash.yaml

3. Run the generation commands:

   dart run flutter_launcher_icons
   dart run flutter_native_splash:create

4. Update the splash screen background color and logo path as needed.

---

🌈 Theming Options

Ridy apps include 8 pre-built themes, switchable using the BetterThemes enum via:

theme: BetterTheme.fromBetterTheme(BetterThemes.cobalt, context.isDesktop, false),
darkTheme: BetterTheme.fromBetterTheme(BetterThemes.cobalt, context.isDesktop, true),

Available Themes

Theme	Description	Recommended Use
electricIndigo	Bold purple accent, vibrant feel	BetterShop, modern brands
cobalt	Sleek deep blue with yellow highlights	✅ Taxi (default)
coralRed	High-contrast red tone, energetic	Delivery, food
earthyGreen	Organic, nature-oriented green	Eco fleets, logistics
noir	Dark mode, minimalist UI	✅ Taxi (dark UI)
hyperPink	Neon-style vibrant pink	BetterShop, Fashion, cosmetics
sunburstYellow	Bright, optimistic yellow-orange	✅ Taxi (sunny cities)
automnOrange	Earthy, burnt-orange look	Utility/logistics

For taxi businesses, we recommend cobalt, noir, and sunburstYellow.

🧪 Custom Themes

You can create your own themes by extending the ColorSystem class in the design system:

final myTheme = ColorSystem(primary: Color(0xFF123456), ...);

---

📃 Admin Panel Branding

During the Admin Installation Wizard, you’ll be prompted to:

• Upload logos
• Set brand name

⚠️ Note: The BetterSuite branding and logo cannot be removed from the admin panel UI due to licensing terms.

---

✉️ SMS Template Customization

Ridy allows SMS customization per provider:

• Go to Settings → SMS Providers in the Admin Panel
• Each provider has its own templating rules
• Templates can be personalized with placeholders and formatting

---

🌐 Web & Package Identity

• Web apps (Admin, Rider Web) can be deployed under custom domains like admin.mycompany.com
• Flutter apps support changing:
  • applicationId (Android)
  • bundleIdentifier (iOS)

These must be set before Firebase setup to ensure matching app registrations.

---

🚫 What You Cannot Change

Restricted Area	Reason
BetterSuite logo in Admin Panel	Licensing requirement
Powered-by references (admin)	Must remain visible