Flutter Configuration

🕒 Estimated Reading Time: 2 minutes
📂 Location: Configurations & Customization →Flutter Configuration

What is this file for?

This document helps you configure the Flutter-based mobile application for your KiviCare Laravel setup. These steps include changing app name, domain, colors, fonts, default language, notification icon, and Firebase settings.

1. Change App Name

To change your app’s name:

📁 Path: lib → configs.dart

Update the following line:

const APP_NAME = 'YOUR APP NAME';

2. Reconfigure Server URL

📁 Path: lib → configs.dart

Update:

const DOMAIN_URL = "ADD YOUR DOMAIN URL";

Replace this with your actual domain like:

https://yourdomain.com/

3. Change Default Language

📁 Path: lib → configs.dart

Edit:

const DEFAULT_LANGUAGE = "LANGUAGE CODE";  // e.g., "en", "ar", "de", "pt", "es"

💡 Tip: Use only supported language codes (“en”, “ar”, “de”, “pt”, “es”). For other languages, additional customization will be required.

• Use only the language code, not the entire language name. You can find the language codes here.

4. Change App Font

📁 Path: lib → app_theme.dart

Update both DarkTheme and LightTheme like this:

fontFamily: GoogleFonts.FONT_NAME().fontFamily,
textTheme: GoogleFonts.FONT_NAMETextTheme(),

Be sure to apply to both themes to ensure UI consistency.

5. Change Primary & Secondary Color

📁 Path: lib → utils → colors.dart

Edit color constants:

const appColorPrimary = Color(0xFF5670CC);
const appColorSecondary = Color(0xFFF67E7D);

💡 Tip: Always use full 8-digit hex code (0xFFxxxxxx) to avoid color issues across devices.

6. Update Notification Icon

📁 Path: lib → utils → push_notification_service.dart

In the showNotification() method, update:

const AndroidInitializationSettings initializationSettingsAndroid = AndroidInitializationSettings('@drawable/YOUR NOTIFICATION ICON NAME');

var androidPlatformChannelSpecifics = AndroidNotificationDetails(
    'notification',
    'Notification',
    importance: Importance.high,
    visibility: NotificationVisibility.public,
    autoCancel: true,
    //color: primaryColor,
    playSound: true,
    priority: Priority.high,
    icon: '@drawable/YOUR NOTIFICATION ICON NAME',
  );

Replace YOUR NOTIFICATION ICON NAME with your actual icon file name in drawable folder.

7. Add FirebaseOptions

After completing Firebase setup, update the Firebase configuration as follows:

📁 Path: lib → firebase_options.dart

Replace the values for both Android and iOS:

static const FirebaseOptions android = FirebaseOptions(
  appId: "FIREBASE ANDROID APP ID",
  apiKey: 'FIREBASE API KEY',
  projectId: 'FIREBASE PROJECT ID',
  messagingSenderId: 'FIREBASE SENDER ID',
  storageBucket: 'FIREBASE STORAGE BUCKET',
);

static const FirebaseOptions ios = FirebaseOptions(
  appId: "FIREBASE iOS APP ID",
  apiKey: 'FIREBASE API KEY',
  projectId: 'FIREBASE PROJECT ID',
  messagingSenderId: 'FIREBASE SENDER ID',
  storageBucket: 'FIREBASE STORAGE BUCKET',
  iosBundleId: 'FIREBASE iOS',
);

How to get these values:

• Open your Firebase Console.

For apiKey

Key	Where to find
apiKey, projectId	Firebase Console → Project Settings → General tab

• Go to Project Settings and click on General tab you’ll find Web API Key and Project ID and paste it all blocks in dart file mentioned above.

For Android App ID and iOS App Id

Key	Where to find
appId	Firebase Console → General tab → Your Apps section
iosBundleId	Firebase Console → General tab → Your iOS App section

• Scroll Down and in Your Apps section you’ll find App Id in Android and iOS section. Copy respective App ID and paste it to appId.
  Copy Bundle ID and paste it to iosBundleId.

For messagingSenderId

Key	Where to find
messagingSenderId	Firebase Console → Cloud Messaging tab

• Click on Cloud Messaging you will see Sender ID. Copy that paste it to messagingSenderId.

For storageBucket

Key	Where to find
storageBucket	Navigate to android/app/google-services.json Under “project_info” find “storage_bucket” and copy value and paste it into storageBucket.

8. Assign Firebase Initialization

📁 Path: main.dart

Ensure this line exists in main() method:

verify DefaultFirebaseOptions is assigned to options.

 await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);

✅ After completing all these settings, your app will be properly customized when you run the project.