Overview
The points system will incentivize users to discover new places and engage with their community by rewarding exploration with points, badges, and achievements. What’s implemented:- ✅ Project structure and navigation framework
- ✅ Themed components for consistent UI
- ✅ Tab-based navigation ready for profile/stats screens
- 🔜 Points tracking and persistence
- 🔜 Check-in system with location verification
- 🔜 Achievement and badge system
- 🔜 Level progression
- 🔜 Statistics and progress tracking
Planned Points Structure
Users will earn points through various exploration activities:| Activity | Points | Description |
|---|---|---|
| First Visit | 50 | Visit a place for the first time |
| Check-in | 10 | Check in at any location |
| Photo Upload | 20 | Share a photo of a place |
| Review | 30 | Write a review for a location |
| Daily Goal | 100 | Complete daily exploration goal |
| Weekly Challenge | 250 | Complete weekly exploration challenge |
Point values and activities are subject to change during development based on testing and user feedback.
Planned Achievement Badges
The app will feature a collection of achievement badges to unlock:🏃 Explorer Badges
🏃 Explorer Badges
- First Steps: Visit your first place
- Getting Around: Visit 10 different places
- Local Expert: Visit 50 different places
- City Navigator: Visit 100 different places
📍 Location Badges
📍 Location Badges
- Neighborhood Scout: Explore 3 different neighborhoods
- Borough Master: Explore all neighborhoods in your borough
- City Explorer: Explore all boroughs in your city
🎯 Category Badges
🎯 Category Badges
- Foodie: Visit 20 restaurants or cafes
- Culture Vulture: Visit 10 museums or cultural sites
- Nature Lover: Visit 15 parks or outdoor spaces
- Shop Local: Visit 10 local shops or markets
⭐ Special Badges
⭐ Special Badges
- Early Bird: Visit 5 places before 9 AM
- Night Owl: Visit 5 places after 9 PM
- Weekend Warrior: Complete 3 weekend challenges
- Streak Master: Maintain a 7-day exploration streak
Planned Level System
Users will progress through explorer levels based on total points earned:| Level | Title | Points Required |
|---|---|---|
| 1 | Novice Explorer | 0 - 499 |
| 2 | Local Wanderer | 500 - 1,499 |
| 3 | Neighborhood Scout | 1,500 - 3,999 |
| 4 | City Navigator | 4,000 - 9,999 |
| 5 | Master Explorer | 10,000+ |
- Level 2: Unlock advanced filtering
- Level 3: Unlock custom challenges
- Level 4: Unlock leaderboards
- Level 5: Unlock exclusive badge collection
Progress Tracking
The app will track exploration progress with:- Daily Stats: Places visited today, points earned
- Weekly Goals: Custom weekly exploration challenges
- Lifetime Stats: Total places visited, total points earned
- Achievements: Badge collection and completion percentage
- Streaks: Consecutive days of exploration
Planned Future Enhancements
Leaderboards
Compete with friends and local explorers
Seasonal Events
Special themed challenges and limited-time badges
Rewards Redemption
Redeem points for partner discounts and offers
Social Sharing
Share achievements and discoveries with friends
Implementation Notes
The points system will be built using:- Local Storage: For offline points tracking
- Supabase: For syncing points across devices
- Real-time Updates: Instant point and badge notifications
- Analytics: Track engagement and popular places
The gamification system is designed to encourage genuine exploration while respecting user privacy. Points are tied to place visits, not continuous location tracking.
Getting Involved
Want to help implement the points and rewards system?- Check the GitHub repository for open issues
- Review the Development Guide to understand the codebase
- Join discussions about gamification features in GitHub Issues
Start Exploring
Learn about the exploration experience and how it all comes together