create-flutterinit 0.1.0

package/templates/base/SETUP.md.hbs

@@ -0,0 +1,253 @@
+# 🎉 Welcome to {{appName}}!
+
+This project was generated dynamically based on your specific requirements. Before running your app for the first time, follow this brief setup guide to configure the required environment variables, permissions, and dependencies locally.
+
+---
+
+## 1. 📦 Initial Dependencies & Generation
+
+First, fetch all pub packages:
+```bash
+flutter pub get
+```
+
+### Code Generation
+{{#if (or flags.isMobX (eq flags.routerPackage "auto_route") flags.usesFirebase flags.usesHive)}}
+Your stack relies on code generation ({{#if flags.usesHive}}Hive Adapters, {{/if}}{{#if flags.isMobX}}MobX, {{/if}}{{#if (eq flags.routerPackage "auto_route")}}Auto Route, {{/if}}{{#if flags.usesFirebase}}Firebase, {{/if}}etc.). Run the following command right away to generate the necessary files:
+```bash
+dart run build_runner build --delete-conflicting-outputs
+```
+{{else}}
+*(No initial code generation required for your main stack)*
+{{/if}}
+
+### Localization
+{{#if flags.supportsLocalization}}
+Since you chose to include `easy_localization`, run these commands whenever you add or modify string translations to generate your keys correctly:
+```bash
+flutter pub run easy_localization:generate -S assets/translations -O lib/src/core/i18n -o locale_keys.g.dart
+```
+{{else}}
+*(Localization is not enabled for this project)*
+{{/if}}
+
+---
+
+## 2. 🎨 Native Splash Screen Setup
+
+{{#if flags.usesFlutterNativeSplash}}
+This project uses `flutter_native_splash`.
+
+**To apply your custom app launch screen:**
+1. Place your transparent splash logo at [`assets/images/splash.png`](assets/images/splash.png).
+2. Open [`flutter_native_splash.yaml`](flutter_native_splash.yaml) in the root of your project.
+3. Uncomment the `image:` paths so it looks like:
+   ```yaml
+   flutter_native_splash:
+     color: "#{{theme.primaryColor}}"
+     image: assets/images/splash.png
+     android_12:
+       image: assets/images/splash.png
+       icon_background_color: "#{{theme.primaryColor}}"
+   ```
+4. Apply the native configuration natively by running:
+```bash
+dart run flutter_native_splash:create --path=flutter_native_splash.yaml
+```
+*Note: Run this command every time you change your splash image or background color.*
+{{else}}
+*(Native splash screen generation is disabled for this project)*
+{{/if}}
+
+---
+
+## 3. 🔐 App Permissions (Android & iOS)
+
+Based on your chosen flags (e.g. {{#if flags.usesImagePicker}}Image Picker{{/if}} {{#if flags.usesGeolocator}}, Geolocator{{/if}} {{#if flags.usesFilePicker}}, File Picker{{/if}}), you must configure Native permissions before testing these features.
+
+### Android Setup
+Open [`android/app/src/main/AndroidManifest.xml`](android/app/src/main/AndroidManifest.xml) and add the following required permissions inside the `<manifest>` tag, directly above the `<application>` block:
+
+```xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- Internet is standard and required -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    
+{{#if flags.usesImagePicker}}
+    <!-- Required for image_picker -->
+    <uses-permission android:name="android.permission.CAMERA" />
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
+    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <!-- Android 13+ -->
+{{/if}}
+{{#if flags.usesFilePicker}}
+    <!-- Required for file_picker -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+{{/if}}
+{{#if flags.usesGeolocator}}
+    <!-- Required for geolocator -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+{{/if}}
+```
+
+### iOS Setup 
+First, describe why you need permissions. Open [`ios/Runner/Info.plist`](ios/Runner/Info.plist) and add the following inside the main `<dict>` block:
+
+```xml
+<dict>
+    ...
+{{#if flags.usesImagePicker}}
+    <!-- Required for image_picker -->
+    <key>NSCameraUsageDescription</key>
+    <string>This app requires access to the camera to take profile photos.</string>
+    <key>NSPhotoLibraryUsageDescription</key>
+    <string>This app requires access to the photo library to upload images.</string>
+{{/if}}
+{{#if flags.usesFilePicker}}
+    <!-- Required for file_picker -->
+    <key>NSAppleMusicUsageDescription</key>
+    <string>This app requires access to media to upload files.</string>
+{{/if}}
+{{#if flags.usesGeolocator}}
+    <!-- Required for geolocator -->
+    <key>NSLocationWhenInUseUsageDescription</key>
+    <string>This app requires access to location to provide localized content.</string>
+    <key>NSLocationAlwaysUsageDescription</key>
+    <string>This app requires access to location in the background.</string>
+{{/if}}
+</dict>
+```
+
+{{#if flags.usesPermissionHandler}}
+**IMPORTANT: Podfile Configuration**
+Since you've enabled `permission_handler`, you **MUST** configure your requested iOS permissions using Podfile macros to comply with App Store rules. 
+
+Open [`ios/Podfile`](ios/Podfile), find the `post_install` block at the bottom, and replace it completely with this snippet:
+
+```ruby
+post_install do |installer|
+  installer.pods_project.targets.each do |target|
+    flutter_additional_ios_build_settings(target)
+
+    target.build_configurations.each do |config|
+      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
+        '$(inherited)',
+
+        ## dart: PermissionGroup.camera
+        'PERMISSION_CAMERA={{#if flags.usesImagePicker}}1{{else}}0{{/if}}',
+
+        ## dart: PermissionGroup.photos
+        'PERMISSION_PHOTOS={{#if flags.usesImagePicker}}1{{else}}0{{/if}}',
+
+        ## dart: PermissionGroup.location
+        'PERMISSION_LOCATION={{#if flags.usesGeolocator}}1{{else}}0{{/if}}',
+        'PERMISSION_LOCATION_WHENINUSE={{#if flags.usesGeolocator}}1{{else}}0{{/if}}',
+
+        ## dart: PermissionGroup.mediaLibrary
+        'PERMISSION_MEDIA_LIBRARY={{#if flags.usesFilePicker}}1{{else}}0{{/if}}',
+
+        ## dart: PermissionGroup.microphone (Usually 1 if video recording is active with image_picker)
+        'PERMISSION_MICROPHONE={{#if flags.usesImagePicker}}1{{else}}0{{/if}}',
+
+        ## Unused permissions forcefully disabled to avoid App Store Rejection
+        'PERMISSION_EVENTS=0',
+        'PERMISSION_EVENTS_FULL_ACCESS=0',
+        'PERMISSION_REMINDERS=0',
+        'PERMISSION_CONTACTS=0',
+        'PERMISSION_SPEECH_RECOGNIZER=0',
+        'PERMISSION_NOTIFICATIONS=0',
+        'PERMISSION_SENSORS=0',
+        'PERMISSION_BLUETOOTH=0',
+        'PERMISSION_APP_TRACKING_TRANSPARENCY=0',
+        'PERMISSION_CRITICAL_ALERTS=0',
+        'PERMISSION_ASSISTANT=0',
+      ]
+    end
+  end
+end
+```
+{{/if}}
+
+---
+
+## 4. 🌍 Environment Variables
+
+Your project relies on `flutter_dotenv` to load secrets. 
+
+1. Create a [`.env`](.env) file in the project root folder.
+2. Insert your required variables (e.g. `API_URL=https://api.example.com`).
+3. These keys are now accessible in Dart via `dotenv.env['API_URL']`.
+
+---
+
+## 5. 💾 Local Storage (Hive)
+
+{{#if flags.usesHive}}
+Your project uses **Hive CE** (Community Edition) for high-performance local NoSQL storage.
+
+- **Automatic Init:** Hive is automatically initialized at startup in `lib/main.dart`.
+- **Adapters:** When creating custom data models, use `@HiveType` and `@HiveField` annotations.
+- **Generation:** Whenever you add a new Hive adapter, run the [Code Generation](#code-generation) command:
+  ```bash
+  dart run build_runner build --delete-conflicting-outputs
+  ```
+{{else}}
+*(No local storage (Hive) selected for this project)*
+{{/if}}
+
+---
+
+## 6. ☁️ Backend Connections
+
+{{#if (eq backend.provider "firebase")}}
+You chose **Firebase** as your backend architecture.
+
+**Initialize Firebase natively:**
+1. Ensure the [Firebase CLI](https://firebase.google.com/docs/cli) is installed and logged in (`firebase login`).
+2. Run the secure configuration tool:
+```bash
+dart pub global activate flutterfire_cli
+flutterfire configure
+```
+3. This generates `lib/firebase_options.dart`. Your integration is already set up in `lib/src/app.dart` or `lib/main.dart` to securely initialize using this file!
+{{else if (eq backend.provider "supabase")}}
+You chose **Supabase** as your backend architecture.
+
+1. Create an empty project at [supabase.com](https://supabase.com/).
+2. Grab your `SUPABASE_URL` and `SUPABASE_ANON_KEY` from your Project API Settings.
+3. Locate the Supabase initialization inside `lib/main.dart` and bind these keys.
+   *(Tip: You can securely point these to `dotenv.env['SUPABASE_URL']` from your newly created `.env` file!)*
+{{else if (eq backend.provider "appwrite")}}
+You chose **Appwrite** as your backend architecture.
+
+1. Locate the `Appwrite` Initialization code inside `lib/main.dart`.
+2. Ensure you apply your Project ID and Endpoint values to the client configuration.
+   *(Tip: You can securely point these to `dotenv.env['APPWRITE_ENDPOINT']`!)*
+{{else if (eq backend.provider "custom")}}
+You chose to structure your APIs using **Custom Backend**.
+
+Verify that your Base URL pointing to staging/production is correctly initialized inside your globally injected network class.
+   *(Tip: Read this via `dotenv.env['BASE_API_URL']` inside your network initializer!)*
+{{else}}
+*(No remote backend provider selected. The application defaults to managing state via Mock services locally).*
+{{/if}}
+
+---
+
+## 7. 🚀 Running the App
+
+Once everything above is verified:
+
+1. **For iOS Simulators/Devices**, map your native pods locally:
+```bash
+cd ios
+pod install
+cd ..
+```
+
+2. Run your app via VS Code, Android Studio, or CLI:
+```bash
+flutter run
+```
+
+Congratulations, and happy coding!

package/templates/base/analysis_options.yaml

@@ -0,0 +1,88 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  errors:
+    inference_failure_on_untyped_parameter: ignore
+  plugins:
+    - custom_lint
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+    - "**/*.gr.dart"
+    - "**/*.config.dart"
+    - "**/generated/**"
+    - "**/build/**"
+    - "**/.dart_tool/**"
+    - "**/ios/Pods/**"
+    - "**/android/.gradle/**"
+    - "**/android/app/build/**"
+    - "**/android/build/**"
+    - "**/web/**"
+    - "**/test/**"
+    - "**/integration_test/**"
+  strong-mode:
+    implicit-casts: true
+    implicit-dynamic: false
+  language:
+    strict-casts: false
+    strict-inference: true
+    strict-raw-types: true
+
+linter:
+  rules:
+    prefer_const_constructors: true
+    prefer_const_declarations: true
+    prefer_const_literals_to_create_immutables: true
+    avoid_print: true
+    prefer_single_quotes: true
+    avoid_unnecessary_containers: true
+    avoid_web_libraries_in_flutter: true
+    prefer_const_constructors_in_immutables: true
+    prefer_final_fields: true
+    prefer_final_locals: true
+    prefer_final_in_for_each: true
+    prefer_for_elements_to_map_fromIterable: true
+    prefer_function_declarations_over_variables: true
+    prefer_if_elements_to_conditional_expressions: true
+    prefer_if_null_operators: true
+    prefer_initializing_formals: true
+    prefer_inlined_adds: true
+    prefer_int_literals: true
+    prefer_interpolation_to_compose_strings: true
+    prefer_is_empty: true
+    prefer_is_not_empty: true
+    prefer_is_not_operator: true
+    prefer_iterable_whereType: true
+    prefer_null_aware_operators: true
+    prefer_relative_imports: false
+    prefer_typing_uninitialized_variables: true
+    sort_child_properties_last: true
+    use_build_context_synchronously: true
+    use_colored_box: true
+    use_decorated_box: true
+    use_enums: true
+    use_full_hex_values_for_flutter_colors: true
+    use_function_type_syntax_for_parameters: true
+    use_if_null_to_convert_nulls_to_bools: true
+    use_is_even_rather_than_modulo: true
+    use_key_in_widget_constructors: true
+    use_late_for_private_fields_and_variables: true
+    use_named_constants: true
+    use_raw_strings: true
+    use_rethrow_when_possible: true
+    use_setters_to_change_properties: true
+    use_string_buffers: true
+    use_super_parameters: true
+    use_test_throws_matchers: true
+    use_to_and_as_if_applicable: true
+    valid_regexps: true
+    void_checks: true

package/templates/base/assets/.keep

@@ -0,0 +1 @@
+

package/templates/base/assets/icons/apple.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none"><path fill="#ffffff" fill-rule="evenodd" d="M19.1 19.16c.59-.9.81-1.36 1.26-2.37-3.32-1.26-3.85-5.99-.57-7.8-1-1.26-2.41-1.99-3.74-1.99-.96 0-1.62.25-2.21.48-.5.19-.95.36-1.51.36-.6 0-1.13-.19-1.69-.39C10.03 7.23 9.39 7 8.59 7 7.1 7 5.51 7.91 4.5 9.47c-1.42 2.2-1.17 6.32 1.12 9.84.82 1.26 1.92 2.67 3.35 2.69.6.01.99-.17 1.42-.36.49-.22 1.02-.46 1.95-.46.93-.01 1.45.24 1.94.46.42.19.8.37 1.39.36 1.45-.02 2.61-1.58 3.43-2.84zM15.84 2c.16 1.1-.29 2.19-.88 2.95-.63.82-1.73 1.46-2.79 1.42-.19-1.06.3-2.15.9-2.88.67-.8 1.8-1.42 2.77-1.49z" clip-rule="evenodd"></path></svg>

package/templates/base/assets/icons/facebook.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none"><path fill="#ffffff" d="M22 16.19c0 3.64-2.17 5.81-5.81 5.81H15c-.55 0-1-.45-1-1v-5.77c0-.27.22-.5.49-.5l1.76-.03c.14-.01.26-.11.29-.25l.35-1.91a.303.303 0 00-.3-.35l-2.13.03c-.28 0-.5-.22-.51-.49l-.04-2.45c0-.16.13-.3.3-.3l2.4-.04c.17 0 .3-.13.3-.3l-.04-2.4c0-.17-.13-.3-.3-.3l-2.7.04a2.996 2.996 0 00-2.95 3.05l.05 2.75c.01.28-.21.5-.49.51l-1.2.02c-.17 0-.3.13-.3.3l.03 1.9c0 .17.13.3.3.3l1.2-.02c.28 0 .5.22.51.49l.09 5.7c.01.56-.44 1.02-1 1.02h-2.3C4.17 22 2 19.83 2 16.18V7.81C2 4.17 4.17 2 7.81 2h8.38C19.83 2 22 4.17 22 7.81v8.38z"></path></svg>

package/templates/base/assets/icons/google.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none"><path fill="#ffffff" d="M21.74 11.07a.989.989 0 00-.99-.89H13.2c-.55 0-1 .45-1 1v1.71c0 .55.45 1 1 1h4.51c-.11.92-.71 2.31-2.04 3.24-.85.59-1.98 1-3.47 1-.07 0-.13 0-.2-.01-2.55-.08-4.71-1.79-5.49-4.14A6.23 6.23 0 016.18 12c0-.69.12-1.36.32-1.98.06-.18.13-.36.21-.54.92-2.07 2.93-3.53 5.29-3.6.06-.01.13-.01.2-.01 1.43 0 2.5.47 3.25.99.39.27.91.21 1.25-.12l1.39-1.36c.44-.43.4-1.16-.1-1.52C16.4 2.69 14.46 2 12.2 2c-.07 0-.13 0-.2.01a9.96 9.96 0 00-8.73 5.5C2.59 8.87 2.2 10.39 2.2 12c0 1.61.39 3.13 1.07 4.49h.01a9.956 9.956 0 008.72 5.5c.07.01.13.01.2.01 2.7 0 4.97-.89 6.62-2.42 1.89-1.75 2.98-4.31 2.98-7.36 0-.43-.02-.8-.06-1.15z"></path></svg>

package/templates/base/flutter_native_splash.yaml.hbs

@@ -0,0 +1,8 @@
+{{#if flags.usesFlutterNativeSplash}}
+flutter_native_splash:
+  color: "#{{theme.primaryColor}}"
+  # image: assets/images/splash.png
+  # android_12:
+  #   image: assets/images/splash.png
+  #   icon_background_color: "#{{theme.primaryColor}}"
+{{/if}}

package/templates/base/lib/main.dart.hbs

@@ -0,0 +1,43 @@
+import 'src/imports/core_imports.dart';
+import 'src/imports/packages_imports.dart';
+{{#if extras.flavors}}
+import 'src/flavors.dart';
+{{/if}}
+import 'src/app.dart';
+
+
+Future<void> main() async {
+  {{#if flags.usesFlutterNativeSplash}}
+  final widgetsBinding = WidgetsFlutterBinding.ensureInitialized();
+  FlutterNativeSplash.preserve(widgetsBinding: widgetsBinding);
+  {{else}}
+  WidgetsFlutterBinding.ensureInitialized();
+  {{/if}}
+  
+  {{#if flags.supportsLocalization}}
+  await EasyLocalization.ensureInitialized();
+  {{/if}}
+  await dotenv.load(fileName: '.env');
+  {{#if extras.flavors}}
+  FlavorConfig.load(Flavor.dev);
+  {{/if}}
+  
+  await AppConfig.init();
+  {{#if flags.usesHive}}
+  await HiveService.instance.init();
+  {{/if}}
+
+  runApp(
+    {{#if flags.supportsLocalization}}
+    const LocalizationWrapper(
+      child: {{#if (eq stateManagement "none")}}App(){{else}}StateWrapper(
+        child: App(),
+      ){{/if}},
+    ),
+    {{else}}
+    {{#if (eq stateManagement "none")}}const App(){{else}}const StateWrapper(
+      child: App(),
+    ){{/if}},
+    {{/if}}
+  );
+}

package/templates/base/lib/src/app.dart.hbs

@@ -0,0 +1,105 @@
+import 'package:{{flags.appSnake}}/src/imports/core_imports.dart';
+
+class App extends StatelessWidget {
+  const App({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final current = {{#if flags.isCupertino}}_buildCupertinoApp(context){{else}}_buildMaterialApp(context){{/if}};
+    {{#if flags.usesScreenutil}}
+    return ScreenUtilWrapper(child: current);
+    {{else}}
+    return current;
+    {{/if}}
+  }
+
+  {{#if flags.isCupertino}}
+  Widget _buildCupertinoApp(BuildContext context) {
+    return {{#if flags.isGetX}}GetCupertinoApp{{else}}CupertinoApp{{/if}}{{#if (and flags.routerPackage (not flags.isGetX))}}.router{{/if}}(
+      {{#if flags.isGetX}}
+      initialBinding: AppBindings(),
+      {{/if}}
+      {{#unless flags.routerPackage}}
+      navigatorKey: rootNavigatorKey,
+      {{/unless}}
+      title: '{{appName}}',
+      debugShowCheckedModeBanner: false,
+      theme: buildCupertinoTheme(primaryColorHex: '{{theme.primaryColor}}'),
+      {{#if (eq flags.routerPackage "getx")}}
+      initialRoute: AppRoutes.onboarding,
+      getPages: AppRouter.getPages,
+      {{else if flags.routerPackage}}
+      routerConfig: {{#if (eq flags.routerPackage "go_router")}}appRouter{{else}}AppRouter().config(){{/if}},
+      {{else}}
+      home: const OnboardingPage(),
+      onGenerateRoute: AppRouter.onGenerateRoute,
+      {{/if}}
+      {{#if flags.supportsLocalization}}
+      localizationsDelegates: context.localizationDelegates,
+      supportedLocales: context.supportedLocales,
+      locale: context.locale,
+      {{/if}}
+      builder: (context, child) {
+        Widget current = child!;
+        {{#if flags.usesSkeletonizer}}
+        current = SkeletonWrapper(child: current);
+        {{/if}}
+        current = SessionListenerWrapper(child: current);
+        
+        // Ensure Material themes (tokens, widget styles like dialogs/buttons/inputs) 
+        // are available even in Cupertino mode, as many apps use a mix of both.
+        {{#if flags.isCupertino}}
+        current = Theme(
+          data: {{#if flags.hasDarkMode}}{{#if theme.darkMode.system}}(MediaQuery.of(context).platformBrightness == Brightness.dark){{else}}true{{/if}}{{else}}false{{/if}}
+              ? buildDarkTheme(primaryColorHex: '{{theme.primaryColor}}')
+              : buildLightTheme(primaryColorHex: '{{theme.primaryColor}}'),
+          child: current,
+        );
+        {{/if}}
+        
+        return current;
+      },
+    );
+  }
+  {{else}}
+  Widget _buildMaterialApp(BuildContext context) {
+    return {{#if flags.isGetX}}GetMaterialApp{{else}}MaterialApp{{/if}}{{#if (and flags.routerPackage (not (eq flags.routerPackage "getx")))}}.router{{/if}}(
+      {{#if flags.isGetX}}
+      initialBinding: AppBindings(),
+      {{/if}}
+      {{#unless flags.routerPackage}}
+      navigatorKey: rootNavigatorKey,
+      {{/unless}}
+      title: '{{appName}}',
+      debugShowCheckedModeBanner: false,
+      theme: buildLightTheme(primaryColorHex: '{{theme.primaryColor}}'),
+      {{#if flags.hasDarkMode}}
+      darkTheme: buildDarkTheme(primaryColorHex: '{{theme.primaryColor}}'),
+      themeMode: {{#if theme.darkMode.system}}ThemeMode.system{{else}}ThemeMode.dark{{/if}},
+      {{/if}}
+      {{#if (eq flags.routerPackage "getx")}}
+      initialRoute: AppRoutes.onboarding,
+      getPages: AppRouter.getPages,
+      {{else if flags.routerPackage}}
+      routerConfig: {{#if (eq flags.routerPackage "go_router")}}appRouter{{else}}AppRouter().config(){{/if}},
+      {{else}}
+      home: const OnboardingPage(),
+      onGenerateRoute: AppRouter.onGenerateRoute,
+      {{/if}}
+      {{#if flags.supportsLocalization}}
+      localizationsDelegates: context.localizationDelegates,
+      supportedLocales: context.supportedLocales,
+      locale: context.locale,
+      {{/if}}
+      builder: (context, child) {
+        Widget current = child!;
+        {{#if flags.usesSkeletonizer}}
+        current = SkeletonWrapper(child: current);
+        {{/if}}
+        current = SessionListenerWrapper(child: current);
+        return current;
+      },
+    );
+  }
+  {{/if}}
+}

package/templates/base/lib/src/config/app_config.dart.hbs

@@ -0,0 +1,112 @@
+{{#if flags.usesDio}}
+import '../imports/core_imports.dart';
+{{/if}}
+{{#if flags.usesDio}}
+import 'package:dio/dio.dart';
+{{/if}}
+{{#if flags.usesHttp}}
+import 'package:http/http.dart' as http;
+{{/if}}
+{{#if (eq backend.provider "firebase")}}
+import 'package:firebase_core/firebase_core.dart';
+import 'package:firebase_auth/firebase_auth.dart';
+{{#if backend.options.firestore}}import 'package:cloud_firestore/cloud_firestore.dart';{{/if}}
+{{#if backend.options.realtimeDb}}import 'package:firebase_database/firebase_database.dart';{{/if}}
+{{#if backend.options.storage}}import 'package:firebase_storage/firebase_storage.dart';{{/if}}
+{{/if}}
+{{#if (eq backend.provider "supabase")}}
+import 'package:supabase_flutter/supabase_flutter.dart';
+{{/if}}
+{{#if (eq backend.provider "appwrite")}}
+import 'package:appwrite/appwrite.dart';
+{{/if}}
+import 'package:flutter_dotenv/flutter_dotenv.dart';
+
+class AppConfig {
+  AppConfig._();
+  {{#if flags.usesDio}}
+  static late final Dio dio;
+  {{/if}}
+  {{#if flags.usesHttp}}
+  static late final http.Client httpClient;
+  {{/if}}
+  {{#if (eq backend.provider "supabase")}}
+  static late final SupabaseClient supabase;
+  {{/if}}
+  {{#if (eq backend.provider "appwrite")}}
+  static late final Client appwriteClient;
+  static late final Account appwriteAccount;
+  {{/if}}
+  {{#if (eq backend.provider "firebase")}}
+  static FirebaseAuth get firebaseAuth => FirebaseAuth.instance;
+  {{#if backend.options.firestore}}
+  static FirebaseFirestore get firestore => FirebaseFirestore.instance;
+  {{/if}}
+  {{#if backend.options.realtimeDb}}
+  static FirebaseDatabase get realtimeDb => FirebaseDatabase.instance;
+  {{/if}}
+  {{#if backend.options.storage}}
+  static FirebaseStorage get storage => FirebaseStorage.instance;
+  {{/if}}
+  {{/if}}
+
+  static String get baseUrl => _getBaseUrl();
+
+  static Future<void> init() async {
+    {{#if (eq backend.provider "firebase")}}
+    await Firebase.initializeApp();
+    {{/if}}
+    {{#if (eq backend.provider "supabase")}}
+    await Supabase.initialize(
+      url: dotenv.get('SUPABASE_URL', fallback: 'https://YOUR-PROJECT.supabase.co'),
+      publishableKey: dotenv.get('SUPABASE_ANON_KEY', fallback: 'YOUR-ANON-KEY'),
+    );
+    supabase = Supabase.instance.client;
+    {{/if}}
+    {{#if (eq backend.provider "appwrite")}}
+    appwriteClient = Client()
+      ..setEndpoint(dotenv.get('APPWRITE_ENDPOINT', fallback: 'https://cloud.appwrite.io/v1'))
+      ..setProject(dotenv.get('APPWRITE_PROJECT_ID', fallback: 'your-project-id'))
+      ..setSelfSigned(status: true);
+    appwriteAccount = Account(appwriteClient);
+    {{/if}}
+    {{#if flags.usesDio}}
+    dio = Dio(
+      BaseOptions(
+        baseUrl: _getBaseUrl(),
+        connectTimeout: const Duration(seconds: 30),
+        receiveTimeout: const Duration(seconds: 30),
+        headers: {
+          'Content-Type': 'application/json',
+          'Accept': 'application/json',
+        },
+      ),
+    );
+
+    dio.interceptors.add(
+      InterceptorsWrapper(
+        onRequest: (options, handler) {
+          AppLogger.info('🌐 [DIO] REQUEST[${options.method}] => PATH: ${options.path}');
+          return handler.next(options);
+        },
+        onResponse: (response, handler) {
+          AppLogger.info('✅ [DIO] RESPONSE[${response.statusCode}] => PATH: ${response.requestOptions.path}');
+          return handler.next(response);
+        },
+        onError: (DioException e, handler) {
+          AppLogger.error('❌ [DIO] ERROR[${e.response?.statusCode}] => PATH: ${e.requestOptions.path}');
+          return handler.next(e);
+        },
+      ),
+    );
+    {{/if}}
+
+    {{#if flags.usesHttp}}
+    httpClient = http.Client();
+    {{/if}}
+  }
+
+  static String _getBaseUrl() {
+    return dotenv.get('API_BASE_URL', fallback: '{{#if (eq backend.provider "custom")}}{{backend.options.baseUrl}}{{else}}https://api.example.com{{/if}}');
+  }
+}

package/templates/base/lib/src/extensions/collection_extension.dart.hbs

@@ -0,0 +1,55 @@
+import 'package:flutter/widgets.dart';
+
+extension IterableExtension<T> on Iterable<T> {
+  // Safe accessors
+  T? get firstOrNull => isEmpty ? null : first;
+  T? get lastOrNull => isEmpty ? null : last;
+
+  // Iteration
+  Iterable<E> mapIndexed<E>(E Function(int index, T item) f) {
+    var i = 0;
+    return map((e) => f(i++, e));
+  }
+
+  // Data manipulation
+  Map<K, List<T>> groupBy<K>(K Function(T item) keySelector) {
+    final groups = <K, List<T>>{};
+    for (final item in this) {
+      final key = keySelector(item);
+      groups.putIfAbsent(key, () => []).add(item);
+    }
+    return groups;
+  }
+
+  Iterable<List<T>> chunk(int size) {
+    if (size <= 0) return [toList()];
+    final chunks = <List<T>>[];
+    final list = toList();
+    for (var i = 0; i < list.length; i += size) {
+      chunks.add(list.sublist(i, i + size > list.length ? list.length : i + size));
+    }
+    return chunks;
+  }
+
+  List<T> get distinct => toSet().toList();
+
+  List<T> distinctBy(Object Function(T item) keySelector) {
+    final seen = <Object>{};
+    return where((item) => seen.add(keySelector(item))).toList();
+  }
+}
+
+extension ListWidgetExtension on List<Widget> {
+  // UI Helpers
+  List<Widget> separatedBy(Widget separator) {
+    if (isEmpty) return [];
+    final result = <Widget>[];
+    for (var i = 0; i < length; i++) {
+      result.add(this[i]);
+      if (i < length - 1) {
+        result.add(separator);
+      }
+    }
+    return result;
+  }
+}