Issue #13 - [FEATURE] Prompt user to review app after completing first action item

[rogelio-cmj]

Motivation

User reviews are critical for app discoverability and growth in app stores. However, prompting users too early or at random times often results in dismissals or negative reviews. By asking users to review the app immediately after they complete their first action item, we capture them at a moment of success and engagement when they've experienced real value from the app.

Current Behavior

The app does not prompt users to leave a review at any point in their journey. Users who want to support the app must manually navigate to the App Store or Google Play Store to leave a review, which creates friction and results in fewer reviews overall.

Reproduction Steps:

1. Open the app and navigate to the action items page
2. Complete (check off) any action item for the first time
3. Observe: No prompt or dialog appears asking the user to review the app
4. Complete additional action items
5. Observe: Still no review prompt appears at any point

Expected Behavior

After a user completes their first action item, the app should display a friendly dialog asking them to review the app in the App Store (iOS) or Google Play Store (Android). This prompt should only appear once per user, even if they complete multiple action items in the future. The dialog should be visually appealing, explain why their review matters, and provide clear options to either leave a review or dismiss the prompt.

Acceptance Criteria:

• A review prompt dialog appears immediately after the user completes their first action item
• The dialog displays platform-specific text (mentions "App Store" on iOS, "Google Play Store" on Android)
• The review prompt only appears once per user, even if they complete multiple action items
• The prompt works correctly from both the action items page and the conversation detail page where action items can be completed
• Users can dismiss the prompt without leaving a review, and it won't appear again

Steps To Test

1. Login to a new account or reset app state
2. Navigate to a conversation or the action items page that contains at least one action item (Or create a new one)
3. Complete (check off) your first action item
4. Verify that a review prompt dialog appears with appropriate styling and text
5. Dismiss the dialog and complete another action item
6. Verify that the review prompt does NOT appear again
7. If you choose to leave a review from the dialog, verify it opens the appropriate store page

Submission

Download https://cap.so/ to record your screen (use Studio mode). Export as an mp4, and drag and drop into an issue comment below.

Guide to submitting pull requests: https://hackmd.io/@timothy1ee/Hky8kV3hlx