Flutter Version: 3.41.1 Stable

Mobile App Installation Setup

This documentation explains the complete mobile application installation, setup, customization, and build process for the Eventiq Flutter mobile app. Every step must be followed carefully.

Prerequisite

  • Android studio
  • Flutter SDK setup (version 3.41.1 Stable)
  • JDK with path setup (only for vs code)
  • Xcode for IPA file build

Environment Setup

Flutter SDK
You have to download and set up flutter from flutter.dev. You can follow documentation with your own device.

https://docs.flutter.dev/install/quick

Now run a command:

flutter doctor

Then check that every setup is okay. If not then check the documentation again and set up flutter sdk properly.

Mandatory setup

Run an existing flutter project on IDE.

🎥

Video Tutorial

Run an existing flutter project on IDE

Watch on YouTube

Change App Logo​

You can generate an app icon from this website https://appicon.co.

  1. Go to <project>/assets/image/ and replace logo.png with your own logo.
  2. Then go to /android/app/src/main/res and replace all Mipmap folders with your <generated icon>/android folder.
  3. Again go to /ios/Runner and replace Assets.xcassets with your generated Assets.xcassets folder.
🎥

Video Tutorial

How to change app logo

Watch on YouTube

Change App Name​

This guide explains how to rename your Flutter application using the rename CLI tool. The tool allows you to change your app's name and bundle identifier across multiple platforms including iOS, Android, macOS, Linux, Web, and Windows.

First, install the rename package globally using the following command:

dart pub global activate rename

Then, run the following command to change app name of the application:

rename setAppName --targets ios,android --value "<your_name>"
🎥

Video Tutorial

How to change app name

Watch on YouTube

Change App Package/applicationId

This guide explains how to change your Flutter application's package name using the change_app_package_name tool. This package automates the process of updating package names across Android and iOS platforms with a single command.

Run the following command to change the package name:

dart run change_app_package_name:main <your_package_name>

Change Base URL

Must remember that don't put slash(/) at the end of your base URL. Use your admin URL as the base URL. First, you have to install your admin panel. For example: If your admin url is https://your_domain.com/admin then the base URL will be https://your_domain.com.

This project uses an EnvConfig object to define environment-specific values such as the API baseUrl. To point the app to your own backend server, follow the steps below.

Open lib/main.dart and replace baseUrl variable value with your own URL. 

baseUrl: "https://your_domain.com",

Customization

Add New Local Language

Step 1: Create a New ARB File

Navigate to the following directory:

lib/l10n

Create a new .arb file and name it using the correct language code.

Example for Bengali:

App_bn.arb

The file name must use a valid language code. Using an invalid language code will cause the application to fail. You can verify valid language and country codes from the following reference:https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html

Copy all contents from app_en.arb. Paste the copied content into the newly created file. Translate only the values in the key-value pairs. Do not modify the keys, as this will break localization.

Example:

"home": "Home"

"home": "বাড়ি"

Step 2: Register the Locale in l10n.dart

Open the following file:

lib/l10n/l10n.dart

Add the new locale to the locals list.

static const locals = [
	Locale('en', 'US'),
	Locale('hi', 'IN'),
	Locale('es', 'ES'),
	Locale('bn', 'BD'), // Bengali
];

Important:

languageCode (bn) and countryCode (BD) must be valid. Invalid codes will cause localization to fail.

Step 3: Add a Language Checker Method (Optional)

For consistency with existing languages, add a helper method to identify the new locale.

static bool isBengali(Locale locale) {
  		return locale.languageCode == "bn";
}

Step 4: Update Language Display Name

Update the getLocalString method so the language name appears correctly in the UI (e.g., language picker).

static String getLocalString(Locale locale) {
  		final language = locale.languageCode;
  switch (language) {
    case "en":
      return "English";
    case "hi":
      return "हिंदी";
    case "es":
      return "Español";
    case "bn":
      return "বাংলা";
    default:
      return "";
  }}

Step 5: Build and Run the Application

Build the application. The build process will automatically generate the file: app_localizations_<code>.dart

Run the application to verify that the new language appears and works correctly.

Change App Color​

This application uses a centralized theming system based on AppColors and AppTheme. All UI colors (Light & Dark mode) are controlled from a single source of truth, ensuring consistency across the app.

Open lib/src/core/theme/app_colors.dart and update the color values (primary, text, background, button, stroke, etc.) to change the application's branding colors.

Light theme colors are defined under Light Theme Colors, and dark theme colors are defined under Dark Theme Colors. After updating the colors, the changes will automatically reflect across the app through AppTheme.lightTheme and AppTheme.darkTheme.

Change App Font

Download your preferred font from the internet. Google has many free fonts you can check them: https://fonts.google.com/

Unzip fonts and paste them to <project>/assets/fonts/ folder

Mentioned them in <project>/pubspec.yaml file like:


fonts:
    - family: YOUR_FONT_FAMILY_NAME
      fonts:
        - asset: assets/fonts/<YOUR_FONT_FILE_NAME>
          weight: <YOUR_FONT_WEIGHT>

Replace the font family name: open lib/src/core/theme/app_textstyles.dart file and change the code below:

static const String fontFamily = '<YOUR_FONT_FAMILY_NAME>';

App build & release

Build for Android

Firstly, clean the flutter project using the command below:

flutter clean

For debug build you can run the command:

flutter build apk

You will get a larger merged apk with this. But you can split them with this command:

flutter build apk --target-platform android-arm,android-arm64,android-x64 --split-per-abi
🎥

Video Tutorial

How to build APK for Android

Watch on YouTube

Build for iOS

There are no general ways to generate apps for iOS. Apple doesn't allow you to install apps like this debug way. If you want to install it on your iOS device then you have to deploy it on TestFlight or AppStore. For deploying it please follow this documentation: https://docs.flutter.dev/deployment/ios