Usage Tracking API

Track free user weekly usage limits and create compelling upgrade prompts with dynamic, database-driven limits. Users get fresh allowances every Monday.

Free Tier Management
Premium Detection
Dynamic Limits
Weekly Limits

What is Usage Tracking?

A comprehensive system to track free user weekly limits across different content types and provide upgrade prompts. Users get fresh allowances every Monday.

Key Features

  • Weekly Limits: Fresh allowances every Monday, no hardcoding
  • Premium Detection: Automatic unlimited access for premium users
  • Automatic Blocking: Creation blocked when limits reached
  • Clear Messaging: Users see exactly why they can't create content
  • Progress Tracking: Beautiful progress bars and percentages
  • Upgrade Prompts: Clear "Go PRO" messaging for conversion

Content Types Tracked

moods (3/week)
notes (1/week)
goals (2/week)
challenges (3/week)
memories (3/week)
photos (4/week)

How It Works

1

Check Before Creating

Frontend checks if user can create content before showing create button

2

Increment on Create

When user creates content, increment usage count

3

Decrement on Delete

When user deletes content, decrement usage count

4

Show Progress UI

Display beautiful progress bars and upgrade prompts