feature-review

Feature: Review — Rules

What Is Already Implemented — Check Before Building

Capability	Status
Native in-app review dialog	✅ InAppReviewStateNotifier.requestReview()
Review availability check	✅ InAppReviewStateNotifier.isAvailable()
Open App Store / Play Store listing	✅ InAppReviewStateNotifier.openStoreListing()
Email feedback with auto-subject	✅ LaunchFeedbackStateNotifier.launch()
Feedback email from Remote Config	✅ FirebaseRemoteConfigCore.feedbackEmail (key: feedback_email)
Analytics events for review/feedback	✅ TapOnReviewButton, TapOnFeedbackButton, InAppReviewIsAvailable
Custom review request timing / frequency	❌ Not in package — OS-controlled; implement logic in consuming app

Before building review or feedback flows, confirm whether the above already covers the requirement.

---

Layer Structure

lib/src/features/review/
├── domain/
│   ├── repositories/in_app_review_repository.dart
│   └── usecases/ (IsAvailableUsecase, RequestReviewUsecase, OpenStoreListingUsecase)
├── data/
│   └── repositories/in_app_review_repository.dart   # InAppReviewRepositoryImpl
└── presentation/
    ├── providers/in_app_review.dart                  # inAppReviewProvider (SDK instance)
    ├── config/launch_url.dart                        # canLaunchFeedback / launchFeedback
    └── notifiers/
        ├── in_app_review_state_notifier.dart         # state: bool (is available)
        └── launch_feedback_state_notifier.dart       # state: bool (can launch)

---

Correct Usage Patterns

Request in-app review with analytics

await ref.read(inAppReviewStateNotifierProvider.notifier).requestReview(
  requestReviewCallback: () => TapOnReviewButton().track(context: context),
  isAvailableCallback: (isAvailable) =>
      InAppReviewIsAvailable(isAvailable: isAvailable).track(context: context),
);

Check availability before showing a "Rate App" button

// On widget mount:
useSafeEffect(() {
  ref.read(inAppReviewStateNotifierProvider.notifier).isAvailable();
  return () {};
}, []);

// In build:
final canReview = ref.watch(inAppReviewStateNotifierProvider);
if (canReview) { /* show button */ }