Getting Started

Change the App Logo

This is the one place that covers the app icon (the launcher icon on the home screen) and the in-app logo (shown on splash / login) for all three apps — Customer, Seller, Delivery — on both Android & iOS. The workflow is identical for every app; only the folder changes.

🎨

Have your artwork ready before you start: one 1024×1024 PNG app icon per app, and a wide transparent PNG for the in-app logo. The steps below replace the placeholder art that ships with each app.

Two logos, don't confuse them

App icon

The square launcher icon. A 1024×1024 PNG. Generated into every Android mipmap-* density and the iOS AppIcon.appiconset by flutter_launcher_icons.

In-app logo

The wide logo shown on the splash / login screen. A transparent PNG loaded from the app's assets/images/ folder.

Where each app lives

App	Folder	Brand colour (current)
Customer	`customer_app/`	Maroon `#A11D43`
Seller	`seller_app/`	Indigo `#6366F1`
Delivery	`delivery_app/`	Emerald `#10B981`

Each app's real colour is defined in lib/core/theme/app_theme.dart (primary / primaryDark). The bundled logos already match these.

Step 1 — Replace the app-icon source (1024×1024 PNG)

Drop your square icon in place of the existing one. Pick the app you're branding:

# Customer
cp my-icon.png  customer_app/assets/images/app_icon.png
# Seller
cp my-icon.png  seller_app/assets/images/app_icon.png
# Delivery
cp my-icon.png  delivery_app/assets/images/app_icon.png

⚠️

The PNG must be exactly 1024×1024, square, with no transparency for the iOS variant (the config below flattens it for you with remove_alpha_ios). Keep important detail away from the corners — the squircle/adaptive mask clips them.

Step 2 — Generate native icons (Android + iOS)

Each app's pubspec.yaml already contains a flutter_launcher_icons block, so you only run two commands inside that app's folder:

cd customer_app          # or seller_app / delivery_app
flutter pub get
dart run flutter_launcher_icons

This rewrites every Android density under android/app/src/main/res/mipmap-* (including the adaptive ic_launcher_foreground.png) and the iOS ios/Runner/Assets.xcassets/AppIcon.appiconset/. No Xcode or Android Studio needed.

The config block it uses (already present — edit the background colour to your brand's dark shade):

dev_dependencies:
  flutter_launcher_icons: ^0.14.1

flutter_launcher_icons:
  android: true
  ios: true
  remove_alpha_ios: true
  image_path: "assets/images/app_icon.png"
  background_color_ios: "#4338CA"        # your brand's dark shade
  adaptive_icon_background: "#4338CA"    # Android adaptive-icon backdrop
  adaptive_icon_foreground: "assets/images/app_icon.png"

🎯

Set background_color_ios and adaptive_icon_background to your app's primaryDark so the rounded-corner gaps match the icon. Current values: Customer #7A1230 · Seller #4338CA · Delivery #047857.

Step 3 — Replace the in-app logo

The splash / login logo is a wide PNG in the app's assets folder:

Colour logo

<app>/assets/images/logo.png — shown on light backgrounds.

White logo

<app>/assets/images/logo_white.png — shown on the brand-colour / dark splash.

cp my-logo.png        seller_app/assets/images/logo.png
cp my-logo-white.png  seller_app/assets/images/logo_white.png

Both folders are already registered under flutter: assets: in pubspec.yaml, so a hot restart picks them up — no further wiring.

Step 4 — App display name (optional)

The name shown under the icon. Set it per platform:

Android

android/app/src/main/AndroidManifest.xml → android:label="Your Brand"

iOS

ios/Runner/Info.plist → CFBundleDisplayName = Your Brand

In-app title

lib/app.dart → MaterialApp( title: 'Your Brand' )

Step 5 — Verify

# Count the generated icons (Android should be 10, iOS 21)
find <app>/android/app/src/main/res -name 'ic_launcher*.png' | wc -l
find <app>/ios/Runner/Assets.xcassets/AppIcon.appiconset -name '*.png' | wc -l

# Or just run the app and look
flutter run

👉

Per-app details: see Customer, Seller and Delivery rebranding pages for package-name, splash and deep-link changes.