create-flutterinit 0.1.0

package/templates/partials/features/onboarding/onboarding_page.hbs

@@ -0,0 +1,264 @@
+import 'package:{{flags.appSnake}}/src/imports/imports.dart';
+
+{{#if (eq flags.routerPackage "auto_route")}}
+@RoutePage()
+{{/if}}
+{{#if flags.usesFlutterHooks}}
+class OnboardingPage extends HookWidget {
+  const OnboardingPage({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = context.theme;
+    final colorScheme = theme.colorScheme;
+    final textTheme = theme.textTheme;
+
+    final pageController = usePageController();
+    final currentIndex = useState(0);
+
+    final List<Map<String, dynamic>> onboardingData = useMemoized(() => [
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_1'.tr(){{else}}'Your Journey,\nPerfectly Planned'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_1'.tr(){{else}}'Effortlessly create and organize your\ndream trips. Start exploring now!'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_2'.tr(){{else}}'Discover\nFriends Nearby'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_2'.tr(){{else}}'See where your friends are traveling and\nexplore the world together.'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_3'.tr(){{else}}'Stay Updated\nwith Top Places'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_3'.tr(){{else}}'Find trending destinations and must-see attractions,\nall tailored to enhance your travel plans.'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+    ]);
+
+    void onGetStarted() {
+      // Navigate back or to home. For template purpose:
+      {{#if (eq flags.routerPackage "go_router")}}
+      context.go(AppRoutes.login);
+      {{else if (eq flags.routerPackage "auto_route")}}
+      context.replaceRoute(const LoginRoute());
+      {{else}}
+      Navigator.pushReplacementNamed(context, AppRoutes.login);
+      {{/if}}
+    }
+
+    return _OnboardingView(
+      theme: theme,
+      colorScheme: colorScheme,
+      textTheme: textTheme,
+      pageController: pageController,
+      currentIndex: currentIndex.value,
+      onboardingData: onboardingData,
+      onPageChanged: (index) => currentIndex.value = index,
+      onGetStarted: onGetStarted,
+    );
+  }
+}
+{{else}}
+class OnboardingPage extends StatefulWidget {
+  const OnboardingPage({super.key});
+
+  @override
+  State<OnboardingPage> createState() => _OnboardingPageState();
+}
+
+class _OnboardingPageState extends State<OnboardingPage> {
+  late final PageController _pageController;
+  int _currentIndex = 0;
+
+  late final List<Map<String, dynamic>> _onboardingData;
+
+  @override
+  void initState() {
+    super.initState();
+    _pageController = PageController();
+    _onboardingData = [
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_1'.tr(){{else}}'Your Journey,\nPerfectly Planned'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_1'.tr(){{else}}'Effortlessly create and organize your\ndream trips. Start exploring now!'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_2'.tr(){{else}}'Discover\nFriends Nearby'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_2'.tr(){{else}}'See where your friends are traveling and\nexplore the world together.'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+      {
+        'title': {{#if flags.supportsLocalization}}'onboarding.onboarding_title_3'.tr(){{else}}'Stay Updated\nwith Top Places'{{/if}},
+        'subtitle':
+            {{#if flags.supportsLocalization}}'onboarding.onboarding_subtitle_3'.tr(){{else}}'Find trending destinations and must-see attractions,\nall tailored to enhance your travel plans.'{{/if}},
+        'pageWidget': const FlutterLogo(size: 200),
+      },
+    ];
+  }
+
+  @override
+  void dispose() {
+    _pageController.dispose();
+    super.dispose();
+  }
+
+  void _onGetStarted() {
+    // Navigate back or to home. For template purpose:
+    {{#if (eq flags.routerPackage "go_router")}}
+    context.go(AppRoutes.login);
+    {{else if (eq flags.routerPackage "auto_route")}}
+    context.replaceRoute(const LoginRoute());
+    {{else}}
+    Navigator.pushReplacementNamed(context, AppRoutes.login);
+    {{/if}}
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = context.theme;
+    final colorScheme = theme.colorScheme;
+    final textTheme = theme.textTheme;
+
+    return _OnboardingView(
+      theme: theme,
+      colorScheme: colorScheme,
+      textTheme: textTheme,
+      pageController: _pageController,
+      currentIndex: _currentIndex,
+      onboardingData: _onboardingData,
+      onPageChanged: (index) => setState(() => _currentIndex = index),
+      onGetStarted: _onGetStarted,
+    );
+  }
+}
+{{/if}}
+
+class _OnboardingView extends StatelessWidget {
+  const _OnboardingView({
+    required this.theme,
+    required this.colorScheme,
+    required this.textTheme,
+    required this.pageController,
+    required this.currentIndex,
+    required this.onboardingData,
+    required this.onPageChanged,
+    required this.onGetStarted,
+  });
+
+  final ThemeData theme;
+  final ColorScheme colorScheme;
+  final TextTheme textTheme;
+  final PageController pageController;
+  final int currentIndex;
+  final List<Map<String, dynamic>> onboardingData;
+  final ValueChanged<int> onPageChanged;
+  final VoidCallback onGetStarted;
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      backgroundColor: colorScheme.surface,
+      body: SafeArea(
+        child: Column(
+          children: [
+            // Top branding
+            Padding(
+              padding: EdgeInsets.only(
+                top: {{res 'AppSpacing.lg' 'h' flags.usesScreenutil}},
+                bottom: {{res 'AppSpacing.md' 'h' flags.usesScreenutil}},
+              ),
+              child: Text(
+                'FlutterInit.',
+                style: textTheme.titleLarge?.copyWith(
+                  fontWeight: FontWeight.w900,
+                  color: colorScheme.onSurface,
+                  fontSize: {{res 22 'sp' flags.usesScreenutil}},
+                ),
+              ),
+            ),
+
+            // PageView
+            Expanded(
+              child: PageView.builder(
+                controller: pageController,
+                itemCount: onboardingData.length,
+                onPageChanged: onPageChanged,
+                itemBuilder: (context, index) {
+                  return Column(
+                    children: [
+                      // Dynamic Illustration Section
+                      Expanded(
+                        child: Center(
+                          child: Padding(
+                            padding: EdgeInsets.symmetric(
+                              horizontal: {{res 'AppSpacing.lg' 'w' flags.usesScreenutil}},
+                            ),
+                            child: onboardingData[index]['pageWidget'] as Widget,
+                          ),
+                        ),
+                      ),
+                      
+                      // Text Section
+                      Padding(
+                        padding: EdgeInsets.symmetric(
+                          horizontal: {{res 'AppSpacing.xl' 'w' flags.usesScreenutil}},
+                        ),
+                        child: Column(
+                          children: [
+                            Text(
+                              onboardingData[index]['title'] as String,
+                              textAlign: TextAlign.center,
+                              style: textTheme.headlineMedium?.copyWith(
+                                fontWeight: FontWeight.w700,
+                                color: colorScheme.onSurface,
+                                height: 1.2,
+                                fontSize: {{res 24 'sp' flags.usesScreenutil}},
+                              ),
+                            ),
+                            SizedBox(height: {{res 'AppSpacing.md' 'h' flags.usesScreenutil}}),
+                            Text(
+                              onboardingData[index]['subtitle'] as String,
+                              textAlign: TextAlign.center,
+                              style: textTheme.bodyMedium?.copyWith(
+                                color: colorScheme.onSurfaceVariant,
+                                height: 1.5,
+                                fontSize: {{res 14 'sp' flags.usesScreenutil}},
+                              ),
+                            ),
+                          ],
+                        ),
+                      ),
+                      {{#if flags.usesScreenutil}}SizedBox(height: 40.h){{else}}const SizedBox(height: 40){{/if}},
+                    ],
+                  );
+                },
+              ),
+            ),
+
+            // Bottom Section: Dots and Button
+            Padding(
+              padding: EdgeInsets.all({{res 'AppSpacing.xl' 'w' flags.usesScreenutil}}),
+              child: Column(
+                children: [
+                   {{#if flags.usesScreenutil}}SizedBox(height: AppSpacing.xl){{else}}const SizedBox(height: 32){{/if}},
+                  // Get Started Button
+                  AppButton(
+                    label: {{#if flags.supportsLocalization}}'shared.get_started'.tr(){{else}}'Get Started'{{/if}},
+                    onPressed: onGetStarted,
+                    variant: ButtonVariant.primary,
+                    width: ButtonSize.medium,
+                  ),
+                  {{#if flags.usesScreenutil}}SizedBox(height: AppSpacing.md){{else}}const SizedBox(height: 16){{/if}},
+                ],
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

package/templates/partials/llm/add-feature-workflow.hbs

@@ -0,0 +1,38 @@
+## How to add a new feature
+
+{{#if (eq architecture "clean")}}
+1. Create domain entity and repository contract under `lib/src/features/<feature>/domain/`.
+2. Add use case(s) in `domain/usecases/` (single responsibility).
+3. Add data model, datasource, and repository implementation under `data/`.
+4. Wire state ({{stateManagement}}) under `presentation/`.
+5. Build screens and widgets under `presentation/`.
+6. Register the route in `lib/src/routing/app_router.dart`.
+7. Export new public API only through existing barrel files if needed.
+{{/if}}
+
+{{#if (eq architecture "feature-first")}}
+1. Create `lib/src/features/<feature>/` with model, service, state, and view folders as needed.
+2. Keep all feature code inside that folder — use `shared/` only for truly global UI/utils.
+3. Register the route in `lib/src/routing/app_router.dart`.
+{{/if}}
+
+{{#if (eq architecture "mvc")}}
+1. Add models under `lib/src/models/` (or feature subfolder if you introduce one).
+2. Add or extend services in `lib/src/services/`.
+3. Add a controller under `lib/src/controllers/<feature>/`.
+4. Add views under `lib/src/views/<feature>/`.
+5. Register the route in `lib/src/routing/app_router.dart`.
+{{/if}}
+
+{{#if (eq architecture "mvvm")}}
+1. Add data models and repository under `lib/src/data/`.
+2. Add UI, view model / provider / bloc under `lib/src/ui/<feature>/`.
+3. Register the route in `lib/src/routing/app_router.dart`.
+{{/if}}
+
+{{#if (eq architecture "layer-first")}}
+1. Add domain entity and repository contract under `lib/src/domain/`.
+2. Implement datasource/model/repository under `lib/src/data/`.
+3. Add presentation (screens + state) under `lib/src/presentation/`.
+4. Register the route in `lib/src/routing/app_router.dart`.
+{{/if}}

package/templates/partials/llm/architecture-rules.hbs

@@ -0,0 +1,92 @@
+## Architecture (`{{architecture}}`)
+
+{{#if (eq architecture "clean")}}
+```text
+lib/src/
+├── features/<feature>/
+│   ├── data/          # datasources, models, repository impls
+│   ├── domain/        # entities, repo contracts, use cases
+│   └── presentation/  # screens, widgets, state ({{stateManagement}})
+├── routing/
+├── services/
+├── shared/
+└── theme/
+```
+
+**Rules**
+
+- `domain/` is pure Dart — no Flutter imports, no imports from `data/`.
+- `data/` implements contracts from `domain/` — never the reverse.
+- Entities are not models — no `fromJson`/`toJson` on domain entities.
+- Use cases expose a single responsibility (typically one public `call()`).
+- `presentation/` talks to use cases or state layer — not datasources directly.
+{{/if}}
+
+{{#if (eq architecture "feature-first")}}
+```text
+lib/src/
+├── features/<feature>/   # model, service, state, view per feature
+├── shared/               # cross-feature widgets & utils only
+├── routing/
+├── services/
+└── theme/
+```
+
+**Rules**
+
+- Each feature is self-contained — no imports from another feature's internals.
+- Shared code lives only under `lib/src/shared/`.
+{{/if}}
+
+{{#if (eq architecture "mvc")}}
+```text
+lib/src/
+├── controllers/    # state & orchestration ({{stateManagement}})
+├── models/
+├── services/       # repositories & API access
+├── views/          # screens & widgets
+├── routing/
+└── theme/
+```
+
+**Rules**
+
+- Views only talk to controllers — no direct service calls from widgets.
+- Controllers orchestrate services — no Flutter widget imports in controllers.
+- One controller per screen or cohesive flow.
+{{/if}}
+
+{{#if (eq architecture "mvvm")}}
+```text
+lib/src/
+├── ui/             # screens, widgets, state ({{stateManagement}})
+├── data/           # models, repository impls
+├── routing/
+├── services/
+└── theme/
+```
+
+**Rules**
+
+- UI layer binds to view models / providers / controllers under `ui/`.
+- Data access goes through repositories in `data/` or `services/`.
+- No business logic in widget `build()` methods.
+{{/if}}
+
+{{#if (eq architecture "layer-first")}}
+```text
+lib/src/
+├── presentation/   # screens, providers/blocs, widgets
+├── domain/         # entities, repo contracts
+├── data/           # models, datasources, repository impls
+├── routing/
+├── services/
+└── theme/
+```
+
+**Rules**
+
+- `domain/` has no Flutter or `data/` imports.
+- `data/` implements `domain/` contracts only.
+- `presentation/` depends on domain abstractions — not concrete datasources.
+{{/if}}

package/templates/partials/llm/backend-rules.hbs

@@ -0,0 +1,30 @@
+## Backend ({{backend.provider}})
+
+{{#if flags.usesFirebase}}
+- All Firebase access goes through `lib/src/services/` and repository/datasource layers — never from widgets.
+- Use `FirebaseAuth` / SDK instances via existing app initialization in `lib/main.dart` — do not re-initialize Firebase in features.
+{{#if flags.usesFirebaseAuth}}- Auth: email/Google/phone options are pre-wired per generator config.{{/if}}
+{{#if flags.usesFirebaseFirestore}}- Firestore: keep security rules enabled; map errors to domain failures in the data layer.{{/if}}
+{{#if flags.usesFirebaseStorage}}- Storage: upload/download via repository or service abstractions.{{/if}}
+- Native config: place `google-services.json` and `GoogleService-Info.plist` per **SETUP.md** — do not commit secrets.
+{{/if}}
+
+{{#if flags.usesSupabase}}
+- All Supabase calls go through services/repositories — not from UI.
+- Assume Row Level Security on tables — never bypass RLS in client code.
+- Session persistence is handled by the SDK — avoid manual token caching.
+- Configure URL and anon key via `.env` / **SETUP.md** when `usesDotenv` is enabled.
+{{/if}}
+
+{{#if flags.usesAppwrite}}
+- Use the configured Appwrite client from app config/services — do not instantiate ad hoc clients in widgets.
+- Auth and database flags follow generator options — extend services, not screens.
+{{/if}}
+
+{{#if flags.usesCustomBackend}}
+- HTTP/Dio client is configured in `lib/src/config/app_config.dart`.
+- API calls belong in `lib/src/services/` (e.g. auth service) using the shared client.
+- Base URL comes from environment / config — see **SETUP.md**.
+{{/if}}
+
+For console setup (keys, native files, env), follow **[SETUP.md](SETUP.md)** — do not duplicate platform steps here.

package/templates/partials/llm/build-runner-note.hbs

@@ -0,0 +1,15 @@
+{{#if (or flags.isMobX (eq flags.routerPackage "auto_route") flags.usesHive flags.usesFirebase)}}
+### Code generation
+
+This stack uses `build_runner` ({{#if flags.usesHive}}Hive, {{/if}}{{#if flags.isMobX}}MobX, {{/if}}{{#if (eq flags.routerPackage "auto_route")}}Auto Route, {{/if}}{{#if flags.usesFirebase}}Firebase, {{/if}}etc.):
+
+```bash
+dart run build_runner build --delete-conflicting-outputs
+```
+
+Re-run after changing generated routes, MobX stores, Hive adapters, or Firebase-related generated code.
+{{else}}
+### Code generation
+
+No `build_runner` step is required for the selected stack.
+{{/if}}

package/templates/partials/llm/design-quick-ref.hbs

@@ -0,0 +1,14 @@
+## Design system (summary)
+
+Full reference: **[DESIGN.md](DESIGN.md)**
+
+- **Theme:** `lib/src/theme/theme.dart` — global `ThemeData` only; no per-widget theme overrides.
+- **Preset:** `{{theme.preset}}`{{#if flags.isCupertino}} (Cupertino){{/if}}{{#if theme.primaryColor}} · seed `{{theme.primaryColor}}`{{/if}}
+- **Dark mode:** {{#if flags.hasDarkMode}}on{{#if theme.darkMode.system}} (system){{/if}}{{else}}off (light only){{/if}}
+- **Colors:** `context.colors` (Material roles), `context.appColors` (`success`, `warning`, `info`)
+- **Typography:** `context.textTheme` / `context.typography` — no raw `fontFamily` in widgets
+{{#if flags.hasCustomFonts}}- **Fonts:** primary `{{flags.primaryFontFamily}}` (see `lib/src/theme/text_theme.dart`){{/if}}
+- **Tokens:** `AppSpacing`, `AppBorders`, `AppShadows`, `AppDurations`, `AppCurves` from `lib/src/theme/theme_constants.dart`
+- **Extensions:** `context_extension.dart` — `width`, `height`, `isDarkMode`, `showAppDialog`, `showTypedSnackBar`
+{{#if flags.usesScreenutil}}- **ScreenUtil:** baseline 390×844; `.w` `.h` `.r` `.sp`; wrapper already in app — no second `ScreenUtilInit`{{else}}- **Layout:** `MediaQuery` / `LayoutBuilder` / `Flexible` — no ScreenUtil{{/if}}
+- **Widgets:** reusable UI in `lib/src/shared/widgets/`; use tokens not magic numbers

package/templates/partials/llm/design-quick-reference.hbs

@@ -0,0 +1,14 @@
+## Design system (summary)
+
+Full reference: **[DESIGN.md](DESIGN.md)**
+
+- **Theme:** `lib/src/theme/theme.dart` — no per-widget `ThemeData` overrides
+- **Tokens:** `package:{{flags.appSlug}}/src/theme/theme_constants.dart` → `AppSpacing`, `AppBorders`, `AppShadows`, `AppDurations`, `AppCurves`
+- **Colors:** `context.colors` (Material roles); `context.appColors` (`success`, `warning`, `info` in `color_schemes.dart`)
+- **Typography:** `context.textTheme` / `context.typography` — no raw `fontFamily` in widgets
+{{#if theme.primaryColor}}- **Seed color:** `{{theme.primaryColor}}`{{/if}}
+{{#if flags.hasCustomFonts}}- **Primary font:** {{flags.primaryFontFamily}}{{/if}}
+{{#if flags.hasDarkMode}}- **Dark mode:** enabled{{#if theme.darkMode.system}} (system){{/if}} — use semantic colors, not `Colors.white`/`Colors.black`{{/if}}
+{{#if flags.usesScreenutil}}- **ScreenUtil:** baseline 390×844; `.w` `.h` `.r` `.sp`; single `ScreenUtilInit` in app wrapper{{else}}- **Layout:** `MediaQuery` / `LayoutBuilder` / `Flexible` — no ScreenUtil{{/if}}
+- **Extensions:** `lib/src/extensions/context_extension.dart` — `showAppDialog`, `showTypedSnackBar`, `width`/`height`
+- **Widgets:** reusable UI in `lib/src/shared/widgets/` only

package/templates/partials/llm/navigation-rules.hbs

@@ -0,0 +1,27 @@
+## Navigation
+
+{{#if (eq flags.routerPackage "go_router")}}
+- All routes are defined in `lib/src/routing/app_router.dart` — do not scatter route tables elsewhere.
+- Prefer typed/named routes from the central config — avoid hard-coded path strings in widgets when a named route exists.
+- `context.go()` replaces the stack; `context.push()` pushes on top.
+- Redirects and guards belong in the router configuration, not inside individual screens.
+{{/if}}
+
+{{#if (eq flags.routerPackage "auto_route")}}
+- Annotate routable pages with `@RoutePage()`.
+- Routes are code-generated — run `build_runner` after adding, renaming, or removing pages.
+- Use `context.router.push()`, `context.router.replace()`, and `context.router.pop()` for navigation.
+- Route definitions live in `lib/src/routing/app_router.dart` and generated `app_router.gr.dart`.
+{{/if}}
+
+{{#if (eq flags.routerPackage "getx")}}
+- Pages and bindings are registered via `AppRouter.getPages` in `lib/src/routing/app_router.dart`.
+- Use GetX navigation APIs consistent with the existing router setup.
+- Do not mix in a second routing package alongside GetX pages.
+{{/if}}
+
+{{#unless flags.routerPackage}}
+- Imperative navigation uses `AppRouter.onGenerateRoute` in `lib/src/routing/app_router.dart`.
+- Use `Navigator` APIs / extension helpers on `BuildContext` from `context_extension.dart`.
+- Register new screens in the central router — not ad hoc `MaterialPageRoute` factories in widgets.
+{{/unless}}

package/templates/partials/llm/networking-rules.hbs

@@ -0,0 +1,16 @@
+## Networking
+
+{{#if flags.usesDio}}
+- Use the shared `Dio` instance from `lib/src/config/app_config.dart` — never `Dio()` inside a widget or screen.
+- Extend or use existing services under `lib/src/services/` for HTTP calls.
+- Map transport errors to `Failure` / `FutureEither` results via `runTask()` — do not leak raw `DioException` to UI.
+{{/if}}
+
+{{#if (and flags.usesHttp (not flags.usesDio))}}
+- Use the HTTP service exported from `lib/src/services/` — do not call `http.get` directly from presentation code.
+- Handle timeouts and socket errors explicitly in the service layer.
+{{/if}}
+
+{{#unless (or flags.usesDio flags.usesHttp)}}
+- No HTTP client package is enabled — use mock/local data patterns already in the template or add Dio/HTTP via `pubspec.yaml` deliberately.
+{{/unless}}

package/templates/partials/llm/packages-list.hbs

@@ -0,0 +1,26 @@
+## Key packages
+
+{{#if (eq flags.routerPackage "go_router")}}- `go_router` — declarative routing{{/if}}
+{{#if (eq flags.routerPackage "auto_route")}}- `auto_route` — code-generated routing{{/if}}
+{{#if flags.isGetX}}- `get` — state & navigation{{/if}}
+{{#if flags.isRiverpod}}- `flutter_riverpod` — state management{{/if}}
+{{#if flags.isProvider}}- `provider` — state management{{/if}}
+{{#if flags.isBloc}}- `flutter_bloc` — state management{{/if}}
+{{#if flags.isMobX}}- `mobx`, `flutter_mobx` — state management{{/if}}
+{{#if flags.usesFirebase}}- `firebase_core`{{#if flags.usesFirebaseAuth}}, `firebase_auth`{{/if}}{{#if flags.usesFirebaseFirestore}}, `cloud_firestore`{{/if}}{{#if flags.usesFirebaseStorage}}, `firebase_storage`{{/if}}{{/if}}
+{{#if flags.usesSupabase}}- `supabase_flutter`{{/if}}
+{{#if flags.usesAppwrite}}- `appwrite`{{/if}}
+{{#if flags.usesDio}}- `dio`{{/if}}
+{{#if (and flags.usesHttp (not flags.usesDio))}}- `http`{{/if}}
+{{#if flags.usesHive}}- `hive`, `hive_flutter`{{/if}}
+{{#if flags.usesSharedPreferences}}- `shared_preferences`{{/if}}
+{{#if flags.usesSecureStorage}}- `flutter_secure_storage`{{/if}}
+{{#if flags.usesCachedNetworkImage}}- `cached_network_image`{{/if}}
+{{#if flags.usesGeolocator}}- `geolocator`{{/if}}
+{{#if flags.usesImagePicker}}- `image_picker`{{/if}}
+{{#if flags.usesFilePicker}}- `file_picker`{{/if}}
+{{#if flags.supportsLocalization}}- `easy_localization`{{/if}}
+{{#if flags.usesScreenutil}}- `flutter_screenutil`{{/if}}
+{{#if flags.usesFlutterHooks}}- `flutter_hooks`{{/if}}
+{{#if flags.usesDotenv}}- `flutter_dotenv`{{/if}}
+{{#if flags.usesSkeletonizer}}- `skeletonizer`{{/if}}

package/templates/partials/llm/services-conventions.hbs

@@ -0,0 +1,20 @@
+## Services & shared conventions
+
+- Services are singletons with `ClassName.instance`, returning `FutureEither<T>` via `runTask()`.
+- Never pass `BuildContext` into services — use `rootContext` from the global navigator helper when UI is required.
+- Logging: `AppLogger`; user feedback: `showGlobalToast()`; dialogs: `showAppDialog()` / `context.showAppDialog()`.
+- Primary import barrel: `package:{{flags.appSlug}}/src/imports/imports.dart`.
+- File names: `snake_case.dart`; classes: `PascalCase`; private members: `_camelCase`.
+- Prefer `const` constructors where possible; avoid `dynamic` without justification.
+- No empty `catch` blocks — log, map to failure, or rethrow.
+- Do not add packages that duplicate existing stack choices (routing, state, backend).
+
+### Dart / Flutter anti-patterns
+
+- No business logic in widget `build()` methods.
+- No direct backend or network calls from presentation widgets.
+{{#if flags.isRiverpod}}- Do not use `ref.read` inside `build()`.{{/if}}
+{{#if flags.isBloc}}- Do not put heavy logic inside bloc event handlers — delegate outward.{{/if}}
+{{#if flags.isProvider}}- Do not use `context.watch` inside callbacks.{{/if}}
+{{#if flags.isGetX}}- Do not mix GetX routing with GoRouter/AutoRoute in the same app.{{/if}}
+{{#if flags.isMobX}}- Do not mutate `@observable` fields outside `@action` methods.{{/if}}

package/templates/partials/llm/stack-summary.hbs

@@ -0,0 +1,22 @@
+## Project
+
+**{{appName}}**{{#if description}} — {{description}}{{/if}}
+
+Generated by [FlutterInit](https://flutterinit.com). Package: `{{packageId}}`.
+
+### Stack
+
+| Area | Choice |
+|------|--------|
+| Architecture | `{{architecture}}` |
+| State management | `{{stateManagement}}` |
+| Navigation | `{{navigation}}` |
+| Backend | `{{backend.provider}}` |
+| Networking | {{#if flags.usesDio}}Dio{{else if flags.usesHttp}}HTTP{{else}}—{{/if}} |
+| Local storage | {{#if flags.usesHive}}Hive{{/if}}{{#if (and flags.usesHive flags.usesSharedPreferences)}}, {{/if}}{{#if flags.usesSharedPreferences}}SharedPreferences{{/if}}{{#if (and (or flags.usesHive flags.usesSharedPreferences) flags.usesSecureStorage)}}, {{/if}}{{#if flags.usesSecureStorage}}Secure storage{{/if}}{{#unless (or flags.usesHive flags.usesSharedPreferences flags.usesSecureStorage)}}—{{/unless}} |
+| Theme preset | `{{theme.preset}}` |
+| Dark mode | {{#if flags.hasDarkMode}}enabled{{#if theme.darkMode.system}} (follows system){{/if}}{{else}}light only{{/if}} |
+| ScreenUtil | {{#if flags.usesScreenutil}}yes{{else}}no{{/if}} |
+| Localization | {{#if flags.supportsLocalization}}`easy_localization` ({{#each flags.supportedLocales}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}){{else}}disabled{{/if}} |
+| Flutter Hooks | {{#if flags.usesFlutterHooks}}enabled{{else}}disabled{{/if}} |
+| Dotenv | {{#if flags.usesDotenv}}enabled{{else}}disabled{{/if}} |

package/templates/partials/llm/state-management-rules.hbs

@@ -0,0 +1,40 @@
+## State management ({{stateManagement}})
+
+{{#if flags.isRiverpod}}
+- Use `ConsumerWidget` / `ConsumerStatefulWidget` where reactive state is needed.
+- Providers live next to features (see overlay paths under `presentation/providers/` or equivalent).
+- `ref.watch` inside `build()`; `ref.read` inside callbacks and one-off actions — never `ref.read` in `build()`.
+- Do not nest a second `ProviderScope` — one at app root is already configured.
+- This project does **not** use `@riverpod` / `riverpod_generator` — define providers manually.
+{{/if}}
+
+{{#if flags.isBloc}}
+- Events and states are immutable — prefer `const` constructors.
+- `BlocBuilder` for UI rebuilds; `BlocListener` for side effects; `BlocConsumer` when both are needed.
+- Keep handlers thin — delegate to use cases, repositories, or services.
+- One bloc per feature flow — do not share blocs across unrelated features.
+{{/if}}
+
+{{#if flags.isProvider}}
+- Call `notifyListeners()` after every state change in `ChangeNotifier`s.
+- `context.watch` in `build()`; `context.read` in callbacks — never reversed.
+- Scope providers at the appropriate subtree — not everything belongs at app root.
+{{/if}}
+
+{{#if flags.isGetX}}
+- Controllers extend `GetxController`; reactive fields use `.obs` with `Obx()`.
+- Register controllers via bindings / route setup — avoid inline `Get.put()` inside widgets.
+- `GetMaterialApp` is configured when navigation uses GetX — do not add a second material app wrapper.
+{{/if}}
+
+{{#if flags.isMobX}}
+- Annotate state with `@observable`; mutations with `@action`; derived values with `@computed`.
+- Wrap reactive UI in `Observer`.
+- Run `dart run build_runner build --delete-conflicting-outputs` after changing any store.
+{{/if}}
+
+{{#if flags.isNoneState}}
+- Session and feature state use manager / `ChangeNotifier` classes in architecture overlay paths.
+- Keep state classes free of widget imports.
+- Prefer explicit loading/error fields over silent failures.
+{{/if}}

package/templates/partials/state_label.hbs

@@ -0,0 +1 @@
+State: {{stateManagement}}