smart_review_dialog #

An intelligent, 2-step sentiment rating funnel for Flutter that protects public App Store and Google Play ratings while intercepting user dissatisfaction before it hurts your reputation.

🌟 Overview & Hook #

Asking every user to review your app blindly on public stores often invites 1-star ratings from upset users and hurts your algorithmic visibility.

smart_review_dialog solves this with an intelligent sentiment routing funnel:

1. Step 1 (Internal Sentiment Check): Presents a clean, delightful rating prompt (stars, mood emojis, or thumbs).
2. Step 2A (Positive Sentiment - 4 or 5 stars): Celebrates with a colorful particle confetti explosion and immediately guides happy users to leave a 5-star public store review.
3. Step 2B (Critical Sentiment - 1 to 3 stars): Seamlessly diverts upset users into a private internal feedback form (with issue description and optional contact email), preserving your store rating while capturing valuable bug reports and product critiques.

✨ Features #

• 🛡️ 2-Step Reputation Shield: Automatically filters positive vs. critical sentiment with configurable rating thresholds.
• 🎉 Celebratory Confetti Engine: Built-in lightweight particle physics burst upon high ratings with zero external dependencies.
• 📱 Store Review Routing: Directs positive reviewers to App Store / Google Play review prompts with custom redirect triggers.
• 📝 Graceful Negative Interception: Captures text feedback and optional follow-up email directly in-app.
• ⏱️ Smart Frequency Capping: Throttles dialog prompts by minimum days, key action thresholds, or permanent opt-out once rated.
• 🎨 Multiple Rating Styles: Choose between interactive animated Stars, Mood Emojis (😡 to 🤩), or Thumbs Up/Down.
• 🌙 Modern Design & Theming: Supports frosted glass backdrop blur (BackdropFilter), dark theme preset, rounded corners, and custom styling.

🚀 Installation #

Add the dependency to your pubspec.yaml:

flutter pub add smart_review_dialog

Or manually:

dependencies:
  smart_review_dialog: ^0.0.1

Then import:

import 'package:smart_review_dialog/smart_review_dialog.dart';

⚡ Quick Start #

Trigger the smart review dialog in under 15 lines of code:

SmartReviewDialog.show(
  context,
  onPositiveRating: (rating) {
    // Trigger in_app_review or launch store URL
  },
  onFeedbackSubmitted: (rating, feedback, email) {
    // Send feedback to your backend API or Slack webhook
  },
);

📖 Advanced Usage & Examples #

1. Mood Emojis with Custom Theming #

SmartReviewDialog.show(
  context,
  ratingStyle: RatingStyle.emojis,
  theme: const SmartReviewTheme(
    promptTitle: 'How is your mood today?',
    promptSubtitle: 'Pick the emoji that best reflects your experience.',
    primaryColor: Color(0xFF10B981),
  ),
  onPositiveRating: (rating) => print('Positive: $rating'),
  onFeedbackSubmitted: (rating, feedback, email) => print('Feedback: $feedback'),
);

2. Frequency Capping with Persistent Storage #

final frequencyManager = FrequencyManager(
  storage: MySharedPreferencesStorage(), // implements ReviewStorageDelegate
  rules: const ReviewFrequencyRules(
    minDaysBetweenPrompts: 14,
    minActionCount: 3,
    neverAskAgainIfRated: true,
  ),
);

// Call this on a critical app action (e.g., booking complete, order delivered):
await frequencyManager.recordAction();

if (await frequencyManager.shouldShowDialog()) {
  await frequencyManager.recordPromptShown();
  SmartReviewDialog.show(
    context,
    onPositiveRating: (_) => frequencyManager.recordRatingCompleted(),
    onFeedbackSubmitted: (_, __, ___) => frequencyManager.recordRatingCompleted(),
  );
}

🛠️ Properties Table #

🎬 Preview & Demo #

+-------------------------------------------------------------+
|                      [ smart_review_dialog ]                |
|                                                             |
|   Step 1: In-App Rating        Step 2A: 5-Star Confetti     |
|   +-----------------------+    +-----------------------+    |
|   |  Enjoying our App?    |    |  🎉 Thank You! 🎉     |    |
|   |   ⭐ ⭐ ⭐ ⭐ ⭐     | -> |  [ Rate on Store ]    |    |
|   |     [Maybe Later]     |    |     [Maybe Later]     |    |
|   +-----------------------+    +-----------------------+    |
|                                                             |
|                                Step 2B: Internal Feedback   |
|                                +-----------------------+    |
|                                |  Help Us Improve 💬   |    |
|                                |  [Describe issue...]  |    |
|                                |  [Send Feedback]      |    |
|                                +-----------------------+    |
+-------------------------------------------------------------+

🤝 Contributing #

Contributions, issues, and feature requests are welcome! Feel free to open an issue or pull request on GitHub.

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author #

Developed with ❤️ by Shahzain Baloch (BalochCodes).