Rules for defining and tracking analytics events in fluttercoremodules. Covers EventEntity subclass structure, event naming, property types, provider gating, and forbidden patterns. Apply to all analytics event files and any file that calls .track().
Clean Architecture rules for fluttercoremodules. Enforces the three-layer domain/data/presentation separation, Either error handling, sealed State machine, and proper dependency direction. Apply to all Dart files in lib/.
Step-by-step guide for implementing new feature modules in fluttercoremodules. Covers file placement, naming conventions, provider wiring, the GetStateNotifier fetch pattern, CacheBoolStateNotifier settings pattern, and barrel export requirements. Apply when creating or extending any feature under lib/src/features/.
Rules for the locale feature in fluttercoremodules — locale persistence, use cases, repository, and how to extend or consume locale in a consuming app. Apply when working with locale or language selection code.
Rules for the revenue feature in fluttercoremodules — RevenueCat integration, CustomerInfoStateNotifier, paywall presentation, isPremiumCustomerProvider, and presentPaywallForwarded. Apply when working with in-app purchases, subscriptions, paywalls, or premium gating.
Rules for the review feature in fluttercoremodules — InAppReviewStateNotifier, LaunchFeedbackStateNotifier, in-app review request, store listing, and feedback email. Apply when implementing rate-app flows, feedback buttons, or review/feedback UI.
Rules for the route feature in fluttercoremodules — ShellRouteWidget, NavigationTab, navigatiorKeyProvider, and defaultNavigatorObservers. Apply when setting up tab navigation, implementing a navigation shell, or adding analytics route observers.
Rules for the settings feature in fluttercoremodules — HapticFeedbackStateNotifier, WakelockStateNotifier, SwitchRowWidget, CacheBoolRowWidget, ThemeRowWidget. Apply when building settings screens, adding new boolean settings, or using settings toggle widgets.
Rules for the storage feature in fluttercoremodules — Firebase Storage integration, SharedPreferences caching, GetDownloadUrlStateNotifier, GetJsonStateNotifier, ImageNetworkFromStorageWidget, SvgFromStorageWidget, and cache invalidation. Apply when loading files from Firebase Storage, using storage widgets, or…
Rules for the theme feature in fluttercoremodules — ThemeStateNotifier, ThemeRepository, IosThemeData persistence, IosLightThemeData / IosDarkThemeData, save:false preview pattern, and wiring theme to the app root. Apply when implementing dark/light mode, theme persistence, or theme-aware widgets.
Naming conventions for all symbols and files in fluttercoremodules — files, classes, providers, use cases, notifiers, widgets, hooks, failures, analytics events, constants, family args, and SharedPreferences keys. Apply to every file in the project.
Rules for how external apps should consume fluttercoremodules — app initialization sequence, required providers, how to use feature notifiers, storage widgets, route setup, and settings widgets. Apply when integrating this package into a consuming Flutter app.
Riverpod and flutterhooks usage rules for fluttercoremodules. Covers provider type selection, HookConsumerWidget patterns, legacy StateNotifier import, autoDispose rules, and common pitfalls. Apply to all Dart files using hooksriverpod or flutterhooks.