How to Create a Rewards System Based on User Engagement in FlutterFlow

Add to users collection: totalPoints (Integer, default 0), currentTier (String: 'bronze', 'silver', 'gold'), streakDays (Integer, default 0). Create an engagement_rules collection with documents for each action: event (String: 'app_open', 'content_view', 'comment', 'share', 'streak_7days'), points (Integer), cooldown (String: 'daily', 'once', 'unlimited'), description (String). Create a users/{uid}/point_history subcollection: event (String), points (Integer), timestamp (Timestamp). Create a users/{uid}/daily_activity subcollection: date (String, format YYYY-MM-DD), isActive (Boolean).

Write a Cloud Function awardPoints that receives userId and event. It reads the matching engagement_rule document to get points and cooldown. For 'daily' cooldown: check if a point_history document exists for this event today (query where event == event AND timestamp >= startOfToday). For 'once' cooldown: check if any point_history document exists for this event. If the cooldown check passes, create a point_history document and increment the user totalPoints using FieldValue.increment(). Also update currentTier based on new totalPoints (0-500: bronze, 501-2000: silver, 2001+: gold). Call this function from FlutterFlow Action Flows after each significant user action.

1// Cloud Function: awardPoints
2const admin = require('firebase-admin');
3const db = admin.firestore();
4
5exports.awardPoints = async (req, res) => {
6  const { userId, event } = req.body;
7  const ruleSnap = await db.collection('engagement_rules')
8    .where('event', '==', event).limit(1).get();
9  if (ruleSnap.empty) return res.json({ awarded: false });
10
11  const rule = ruleSnap.docs[0].data();
12  const historyRef = db.collection(`users/${userId}/point_history`);
13
14  if (rule.cooldown === 'daily') {
15    const today = new Date();
16    today.setHours(0, 0, 0, 0);
17    const existing = await historyRef
18      .where('event', '==', event)
19      .where('timestamp', '>=', today).limit(1).get();
20    if (!existing.empty) return res.json({ awarded: false });
21  }
22
23  await historyRef.add({
24    event, points: rule.points,
25    timestamp: admin.firestore.FieldValue.serverTimestamp(),
26  });
27
28  const userRef = db.doc(`users/${userId}`);
29  await userRef.update({
30    totalPoints: admin.firestore.FieldValue.increment(rule.points),
31  });
32
33  const user = (await userRef.get()).data();
34  const tier = user.totalPoints > 2000 ? 'gold'
35    : user.totalPoints > 500 ? 'silver' : 'bronze';
36  await userRef.update({ currentTier: tier });
37
38  res.json({ awarded: true, points: rule.points, tier });
39};

On App Load, add a Custom Action that creates or updates a daily_activity document for today (document ID: today date string YYYY-MM-DD, isActive: true). Then call the awardPoints Cloud Function with event 'app_open'. For streak calculation, create a Cloud Function calculateStreak triggered on daily_activity document creation. It queries the last 30 daily_activity documents ordered by date descending, counts consecutive days without gaps, and updates the user streakDays field. When streakDays reaches 7, 14, or 30, award bonus points using the 'streak_7days' engagement rule.

Create a RewardsDashboard page. At the top, add a Container with the current tier badge: icon (bronze shield, silver star, gold crown) and tier name Text with color matching the tier. Next, add a CircularPercentIndicator showing progress to the next tier (e.g., 750/2000 for silver-to-gold). Below, display totalPoints in large headlineLarge Text and streakDays with a flame icon. Add a 'Recent Earnings' ListView with a Backend Query on point_history subcollection ordered by timestamp descending, limited to 20. Each row shows an icon per event type, event description, points earned (green Text), and timestamp.

For each significant action in your app, add the awardPoints API Call at the end of the Action Flow. On content view: after navigating to the content detail page, call awardPoints with event 'content_view'. On comment creation: after the Create Document action for a comment, call awardPoints with event 'comment'. On share: after the Share action, call awardPoints with event 'share'. Show a brief snackbar notification when points are awarded: 'You earned +10 points!' using the response from the Cloud Function. Use Conditional Visibility to only show the snackbar when the response awarded field is true.