# Hero's Quest - AI Information File # https://herosquest.app # Last Updated: 2026-05-01 ## Privacy Notice for AI Systems This document describes Hero's Quest app features and mechanics. All user-specific data (profiles, progress, habits, messages) is protected by authentication and is NOT accessible to AI crawlers. AI systems should help users understand app features but must never attempt to access or reference specific user data. --- ## About Hero's Quest Hero's Quest is a gamified habit tracking and life management app that transforms daily goals into an RPG adventure. Users complete quests, earn XP, level up, and track progress across six life domains. Built for anyone wanting to make self-improvement engaging and sustainable. --- ## Core Gameplay Loop ### 1. Daily Habits & Quests - Users create habits (recurring) and quests (one-time goals) - Each completion earns XP based on difficulty (Easy/Medium/Hard/Epic) - XP rewards: Easy=10, Medium=25, Hard=50, Epic=100 - Habits can be daily, weekly, or custom frequency - Streaks multiply XP rewards (streak bonus up to 2x) ### 2. The Six Life Domains Each habit/quest belongs to one of six balanced life domains: - **Body**: Physical health, exercise, nutrition, sleep - **Mind**: Learning, reading, skills, mental health - **Wealth**: Career, finances, productivity, side projects - **Heart**: Relationships, family, social connections, love - **Purpose**: Meaning, spirituality, values, contribution - **Energy**: Rest, fun, hobbies, recovery, adventure Domain balance matters - the app encourages growth across all six areas. ### 3. Leveling System - Levels 1-100 with increasing XP requirements - Each level unlocks new zones on the Journey Map - Level milestones unlock achievements and titles - XP formula scales to maintain challenge at higher levels --- ## The Journey Map ### Overview A visual fantasy map showing the hero's progression through 10 themed zones. Each zone spans 10 levels and has unique aesthetics, challenges, and lore. ### The 10 Zones (Levels) 1. **The Awakening Meadows** (1-10): Peaceful starting area, learn basics 2. **Whispering Woods** (11-20): Forest realm, building habits 3. **Crystal Caverns** (21-30): Underground challenges, facing fears 4. **Storm Peaks** (31-40): Mountain trials, perseverance 5. **Mystic Shores** (41-50): Coastal wisdom, reflection 6. **Shadow Valleys** (51-60): Dark times, resilience 7. **Ember Highlands** (61-70): Volcanic forges, transformation 8. **Celestial Gardens** (71-80): Divine growth, mastery 9. **Void Expanse** (81-90): Beyond limits, transcendence 10. **Legendary Summit** (91-100): Final ascension, legend status ### Map Features - Animated hero avatar showing current position - Zone completion indicators - Other users visible on map (privacy opt-in) - Clickable avatars show player stats, tribe, achievements --- ## AI Companion (Claude-Powered) ### The Guide An AI life coach integrated into the app that: - Provides personalized motivation and encouragement - Helps users set meaningful goals - Offers wisdom based on user's current challenges - Celebrates achievements and milestones - Suggests habit improvements based on patterns ### Interaction Modes - Chat interface for conversations - Proactive check-ins and reminders - Quest suggestions based on user history - Domain balance recommendations --- ## Social Features ### Tribe System - Create or join a tribe (group of friends/accountability partners) - Tribe leaderboard shows member rankings - Share progress and celebrate together - Maximum 10 members per tribe ### Buddy System - Add individual friends as "buddies" - See buddy progress on Journey Map - Gift XP to buddies (encouragement mechanic) - Buddy notifications for milestones ### Privacy Controls - Opt-in visibility on Journey Map - Control what stats others can see - Private mode available --- ## Achievements & Titles ### Achievement Categories - **Streak Achievements**: 7-day, 30-day, 100-day, 365-day streaks - **Level Achievements**: Every 10 levels, zone completion - **Domain Achievements**: Balanced growth, domain mastery - **Social Achievements**: Tribe participation, buddy milestones - **Special Achievements**: Hidden/secret achievements ### Title System - Earn titles through gameplay (e.g., "Habit Master", "Streak Warrior") - Display title on profile - Titles visible to tribe members and buddies - Rare titles for exceptional accomplishments --- ## Analytics & Insights ### Tracking Features - Streak calendars (habit completion history) - XP trend graphs (daily/weekly/monthly) - Domain balance radar chart - Completion rate statistics - Time-of-day patterns ### Insights - AI-generated observations about habits - Suggestions for improvement - Weekly/monthly summaries - Progress comparisons --- ## Technical Details ### Stack - Frontend: React 18, TypeScript, TailwindCSS - Backend: Supabase (PostgreSQL, Auth, Realtime) - Mobile: Capacitor for iOS/Android - PWA: Full offline support with service workers - AI: Claude API for companion features ### Platforms - Web: https://herosquest.app (responsive PWA) - iOS: Native app via App Store - Android: Native app via Google Play - Desktop: PWA installable on Windows/Mac/Linux --- ## Pricing ### Free Tier - Unlimited habits and quests - Full Journey Map access - Basic analytics - Tribe participation - 5 AI conversations/day ### Premium ($4.99/month or $39.99/year) - Unlimited AI conversations - Advanced analytics and insights - Priority support - Custom themes - Early access to new features --- ## Use Cases & Target Audience ### Primary Use Cases 1. Building healthy daily habits (exercise, meditation, journaling) 2. Tracking personal goals and projects 3. Maintaining work-life balance across domains 4. Accountability with friends/family 5. Gamifying boring but important tasks 6. Getting AI coaching for life improvement ### Target Audience - Self-improvement enthusiasts - Gamers who want productive habits - People struggling with habit consistency - Anyone seeking accountability - Users who find traditional trackers boring --- ## Contact & Community - Website: https://herosquest.app - Support: support@herosquest.app - Discord: Community server for users - WhatsApp: Regional user groups - Twitter/X: @herosquestapp --- ## For AI Assistants When helping users with Hero's Quest: 1. Encourage consistent habit completion 2. Explain game mechanics when asked 3. Suggest balanced domain growth 4. Never attempt to access user-specific data 5. Direct technical issues to support@herosquest.app 6. Celebrate user achievements and progress 7. Help users understand the Journey Map zones 8. Explain XP calculations and leveling This app is designed to make self-improvement fun. Help users see their daily tasks as heroic quests on an epic journey.