fix: android + browser run

.gitignore

@@ -39,6 +39,9 @@ app.*.symbols
 # Obfuscation related
 app.*.map.json
 
+# Google Services
+google-services.json
+
 # Android Studio will place build artifacts here
 /android/app/debug
 /android/app/profile

README.md

@@ -159,8 +159,8 @@ lib/
 
 ### Prerequisites
 
-- Flutter SDK (>=3.0.0)
-- Dart SDK (>=3.0.0)
+- Flutter SDK (>=3.27.0)
+- Dart SDK (>=3.8.0)
 - Android Studio / VS Code with Flutter extensions
 - Xcode (for iOS development on macOS)
 
@@ -219,7 +219,8 @@ lib/
 1. **Rename the project** (if needed) - Update package name from `flutter_starter` to your project name
 2. **Configure your environment** - See [Configuration System](#-configuration-system) below
 3. **Set up Firebase** (optional) - For remote feature flags and performance monitoring
-   - Add `google-services.json` (Android) and `GoogleService-Info.plist` (iOS)
+   - **Setup Firebase Config**: Add `google-services.json` (Android) and `GoogleService-Info.plist` (iOS).
+     > **Note**: These files are gitignored for security. You must add them manually for local development. For CI/CD, use environment variables to generate them.
    - Initialize Firebase in your app
 4. **Customize the theme** - Edit `lib/shared/theme/app_theme.dart`
 5. **Explore example features** - Check out `lib/features/` for examples:

android/app/build.gradle.kts

@@ -42,3 +42,5 @@ android {
 flutter {
     source = "../.."
 }
+
+apply(plugin = "com.google.gms.google-services")

android/build.gradle.kts

@@ -1,22 +1,36 @@
+plugins {
+    id("com.android.application") version "8.11.1" apply false
+    id("org.jetbrains.kotlin.android") version "2.2.20" apply false
+    id("com.google.gms.google-services") version "4.3.15" apply false
+}
+
 allprojects {
     repositories {
         google()
         mavenCentral()
     }
 }
 
-val newBuildDir: Directory =
-    rootProject.layout.buildDirectory
-        .dir("../../build")
-        .get()
+val newBuildDir: Directory = rootProject.layout.buildDirectory.dir("../../build").get()
 rootProject.layout.buildDirectory.value(newBuildDir)
 
 subprojects {
     val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name)
     project.layout.buildDirectory.value(newSubprojectBuildDir)
+
+    afterEvaluate {
+        if (project.plugins.hasPlugin("java") || project.plugins.hasPlugin("com.android.library")) {
+            project.extensions.findByType<JavaPluginExtension>()?.apply {
+                toolchain { languageVersion.set(JavaLanguageVersion.of(17)) }
+            }
+        }
+    }
 }
+
 subprojects {
-    project.evaluationDependsOn(":app")
+    if (project.name != "app") {
+        project.evaluationDependsOn(":app")
+    }
 }
 
 tasks.register<Delete>("clean") {

android/gradle.properties

@@ -1,2 +1,6 @@
 org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
 android.useAndroidX=true
+# Enable toolchain auto-provisioning
+org.gradle.java.installations.auto-download=true
+# Use Java 21 from Android Studio for Gradle daemon (to compile build scripts)
+org.gradle.java.home=C:\\Program Files\\Android\\Android Studio\\jbr

android/gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-all.zip

android/settings.gradle.kts

@@ -21,6 +21,8 @@ plugins {
     id("dev.flutter.flutter-plugin-loader") version "1.0.0"
     id("com.android.application") version "8.11.1" apply false
     id("org.jetbrains.kotlin.android") version "2.2.20" apply false
+    id("com.google.gms.google-services") version "4.3.15" apply false
+    id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0"
 }
 
 include(":app")

docs/deployment/deployment.md

@@ -448,7 +448,7 @@ firebase deploy --only hosting
 1. **Add Dependencies** to `pubspec.yaml`:
 ```yaml
 dependencies:
-  firebase_core: ^3.0.0
+  firebase_core: ^2.24.2
   firebase_crashlytics: ^4.0.0
 ```
 
@@ -477,6 +477,7 @@ void main() async {
 3. **Configure Firebase Projects**:
    - Create Firebase projects for each environment
    - Add `google-services.json` (Android) and `GoogleService-Info.plist` (iOS)
+   - **Note:** These files are gitignored. For CI/CD (e.g., GitHub Actions), store them as Base64 secrets (`ANDROID_GOOGLE_SERVICES_JSON`, `IOS_GOOGLE_SERVICE_INFO`) and decode them during the build process.
    - Place in appropriate flavor directories
 
 ### Analytics Integration

docs/deployment/monitoring-analytics.md

@@ -23,7 +23,7 @@ Update `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  firebase_core: ^3.0.0
+  firebase_core: ^2.24.2
   firebase_crashlytics: ^4.0.0
 ```
 

docs/guides/onboarding/getting-started.md

@@ -2,21 +2,6 @@
 
 This guide will help you set up your development environment and get the Flutter Starter project running.
 
-## Prerequisites
-
-Before you begin, ensure you have the following installed:
-
-- **Flutter SDK**: Version 3.0.0 or higher
-  - Check your version: `flutter --version`
-  - Install/update: [Flutter Installation Guide](https://docs.flutter.dev/get-started/install)
-
-- **Dart SDK**: Version 3.0.0 or higher (included with Flutter)
-
-- **IDE**: Choose one of the following:
-  - **VS Code** (recommended): Install Flutter and Dart extensions
-  - **Android Studio**: Install Flutter and Dart plugins
-  - **IntelliJ IDEA**: Install Flutter and Dart plugins
-
 - **Platform-specific tools** (for your target platforms):
   - **Android**: Android Studio with Android SDK
   - **iOS**: Xcode (macOS only)

lib/core/config/env_config.dart

@@ -2,8 +2,11 @@ import 'package:flutter_dotenv/flutter_dotenv.dart';
 
 /// Environment configuration loader with fallback chain:
 /// 1. .env file (for local development)
-/// 2. --dart-define flags (for CI/CD)
-/// 3. Default values
+/// 2. Default values
+///
+/// Note: --dart-define flags are compile-time only and cannot be accessed
+/// dynamically at runtime. They must be accessed via const
+/// String.fromEnvironment() for specific known keys if needed.
 ///
 /// Usage:
 /// ```dart
@@ -20,7 +23,7 @@ class EnvConfig {
   /// This should be called before runApp() in main.dart
   ///
   /// The .env file is optional. If it doesn't exist, the system will fall back
-  /// to --dart-define flags or default values.
+  /// to default values.
   ///
   /// Note: For .env to be loaded, it must be added to pubspec.yaml assets
   /// after creating it from .env.example
@@ -50,13 +53,11 @@ class EnvConfig {
 
   /// Get environment variable with fallback chain:
   /// 1. .env file value (if loaded)
-  /// 2. --dart-define flag value
-  /// 3. Default value (if provided)
+  /// 2. Default value (if provided)
   ///
   /// Parameters:
   /// - [key]: The environment variable key
-  /// - [defaultValue]: Optional default value if not found in .env or
-  ///   --dart-define
+  /// - [defaultValue]: Optional default value if not found in .env
   ///
   /// Returns:
   /// The environment variable value, or [defaultValue] if not found
@@ -78,17 +79,14 @@ class EnvConfig {
           return value;
         }
       } on Exception {
-        // Variable not found in .env, continue to next priority
+        // Variable not found in .env, continue to default
       }
     }
 
-    // Priority 2: Check --dart-define flags
-    final dartDefineValue = String.fromEnvironment(key);
-    if (dartDefineValue.isNotEmpty) {
-      return dartDefineValue;
-    }
-
-    // Priority 3: Return default value
+    // Return default value
+    // Note: --dart-define flags are compile-time only and cannot be
+    // accessed dynamically at runtime. They must be accessed via
+    // const String.fromEnvironment() for specific known keys.
     return defaultValue;
   }
 
@@ -102,21 +100,11 @@ class EnvConfig {
       try {
         return dotenv.getBool(key, fallback: defaultValue);
       } on Exception {
-        // Variable not found in .env, continue to next priority
+        // Variable not found in .env, continue to default
       }
     }
 
-    // Priority 2: Check --dart-define flags
-    final dartDefineValue = String.fromEnvironment(key);
-    if (dartDefineValue.isNotEmpty) {
-      final lowerValue = dartDefineValue.toLowerCase().trim();
-      return lowerValue == 'true' ||
-          lowerValue == '1' ||
-          lowerValue == 'yes' ||
-          lowerValue == 'on';
-    }
-
-    // Priority 3: Return default value
+    // Return default value
     return defaultValue;
   }
 
@@ -129,17 +117,11 @@ class EnvConfig {
       try {
         return dotenv.getInt(key, fallback: defaultValue);
       } on Exception {
-        // Variable not found in .env, continue to next priority
+        // Variable not found in .env, continue to default
       }
     }
 
-    // Priority 2: Check --dart-define flags
-    final dartDefineValue = String.fromEnvironment(key);
-    if (dartDefineValue.isNotEmpty) {
-      return int.tryParse(dartDefineValue) ?? defaultValue;
-    }
-
-    // Priority 3: Return default value
+    // Return default value
     return defaultValue;
   }
 
@@ -152,23 +134,17 @@ class EnvConfig {
       try {
         return dotenv.getDouble(key, fallback: defaultValue);
       } on Exception {
-        // Variable not found in .env, continue to next priority
+        // Variable not found in .env, continue to default
       }
     }
 
-    // Priority 2: Check --dart-define flags
-    final dartDefineValue = String.fromEnvironment(key);
-    if (dartDefineValue.isNotEmpty) {
-      return double.tryParse(dartDefineValue) ?? defaultValue;
-    }
-
-    // Priority 3: Return default value
+    // Return default value
     return defaultValue;
   }
 
   /// Check if an environment variable exists
   ///
-  /// Returns true if the variable exists in .env file or --dart-define
+  /// Returns true if the variable exists in .env file
   static bool has(String key) {
     // Check .env file (if loaded)
     if (_isInitialized) {
@@ -181,8 +157,8 @@ class EnvConfig {
         // Variable not found in .env
       }
     }
-    // Check --dart-define flags
-    return String.fromEnvironment(key).isNotEmpty;
+    // Note: --dart-define values cannot be checked dynamically at runtime
+    return false;
   }
 
   /// Get all environment variables as a map

macos/Flutter/GeneratedPluginRegistrant.swift

@@ -13,7 +13,7 @@ import shared_preferences_foundation
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
   FLTFirebaseCorePlugin.register(with: registry.registrar(forPlugin: "FLTFirebaseCorePlugin"))
-  FirebaseRemoteConfigPlugin.register(with: registry.registrar(forPlugin: "FirebaseRemoteConfigPlugin"))
+  FLTFirebaseRemoteConfigPlugin.register(with: registry.registrar(forPlugin: "FLTFirebaseRemoteConfigPlugin"))
   FlutterSecureStoragePlugin.register(with: registry.registrar(forPlugin: "FlutterSecureStoragePlugin"))
   PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin"))
   SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))