8080.AI
DesignReqsTasksUser FlowArchitecture
Log inSign up for free

project-3ccc68fa

byHARIKIRAN NHK

# PROJECT: KINGDOM RUN (Working Name) ## Vision Build the world's most engaging running platform that combines world-class activity tracking with hyperlocal competition, exploration, and community. This is NOT a game with running. This is a premium running app where every run increases your influence in the real world. The app should feel like: * Apple Health quality * Strava social experience * Duolingo motivation * Pokémon GO exploration * Apple-level UI and animations The experience must be elegant, premium, minimal and addictive. --- # Design Principles Every screen should feel premium. No clutter. Rounded cards. Glassmorphism only where appropriate. Smooth 120fps animations. Micro-interactions everywhere. Large typography. Dark mode first. Beautiful maps. Minimal colors. Primary color: Royal Blue Accent: Gold Background: Near Black (#0B0B0B) Cards: Dark Gray (#181818) Typography: SF Pro Display (iOS) Inter (Android/Web) Icons: Phosphor Icons Maps: Mapbox --- # Core Philosophy Every run should improve: 1. Fitness 2. Identity 3. Territory 4. Progress 5. Community Never punish users. Never make them lose weeks of effort. Influence naturally changes through continuous activity. --- # User Journey Open App ↓ Beautiful animated map ↓ Start Run ↓ Complete Quest ↓ Earn Kingdom Points (KP) ↓ Increase Influence ↓ Become Commander ↓ Become King ↓ Share Achievement ↓ Repeat --- # Homepage Homepage opens directly to the Map. Full-screen interactive map. Top Search Bar Profile Avatar Notification Bell Weather Widget Current Streak Current Title Floating Start Run button. Bottom Navigation Home Run Feed Quests Profile --- # Territory System The city is divided into predefined regions. Example Paris * Châtelet * Les Halles * République * Bastille * Montmartre * Latin Quarter * La Défense Each territory has: Current King Commander Knights Residents Weekly Activity Territory Prestige The current King appears with their profile photo pinned on the map. Blue = Your territory Gold = Territory you rule Gray = Neutral Red = Challenging territory Territories update dynamically based on recent Kingdom Points. --- # Kingdom Titles No numeric rankings. Titles only. 👑 King ⚔ Commander 🛡 Knight 🏹 Ranger 🧭 Explorer 🏃 Citizen These titles localize automatically while preserving the medieval theme. --- # Kingdom Points (KP) Every meaningful activity earns KP. Examples Complete Run +20 KP Personal Record +50 KP Quest Complete +100 KP Heart Route Complete +150 KP 7-Day Streak +70 KP 30-Day Streak +500 KP Exploring New Route +60 KP Helping Local Challenge +40 KP KP determines your influence in your local territory. Influence decays slowly over time if you stop running, allowing active runners to rise naturally. --- # Activity Tracking Professional-grade tracking. Track: Distance Duration Average Pace Current Pace Splits Elevation Heart Rate Cadence Calories Temperature Weather Running Surface Shoes Used Map Route Automatic Pause Background Tracking GPS Accuracy Offline Recording Workout Import Health Connect Apple Health Garmin Import (future) Coros (future) Polar (future) Apple Watch (future) --- # Activity Summary Every run becomes a beautiful story. Example Morning Run 8.42 km 43:51 5:12/km 🔥 Personal Best 👑 Became Commander of Châtelet ❤️ Completed Heart Route 🏆 +180 Kingdom Points Animated route replay. Beautiful statistics. Share card optimized for Instagram. --- # Personal Records Instead of boring statistics show achievements. Examples 🏆 Fastest 5K Ever ⚡ Top 2% in Châtelet 🔥 Fastest This Month 🌄 Highest Elevation Run ❤️ Longest Couple Route 🌍 Most Territories Explored 📈 Longest Streak Display improvements and trends visually. --- # Social Feed Every activity becomes a story. Harikiran ❤️ Completed Heart Route 👑 Became King of Châtelet 🔥 42 Day Streak 🏆 New 10K Personal Record Feed supports: Photos Comments Likes Route replay Follow users Share achievements --- # Quests Daily Weekly Monthly Seasonal Examples Run before sunrise. Visit 3 parks. Complete a Heart Route. Run beside the Seine. Explore 5 new streets. Run every day for one week. Complete all Paris bridges. Rewards KP Badges Exclusive Titles Animated Effects --- # Route Discovery One of the signature features. Categories ❤️ Couples ⭐ Beginners 🔥 Speed 🌄 Hills 🌳 Scenic ☕ Coffee Run 🏰 Historic 🎨 Creative Shapes Examples Heart Star Moon Infinity Butterfly Eiffel-inspired loop The route preview animates before the run. After completion, the shape fills with an elegant completion animation. --- # Live Beacon Live location sharing. Emergency Contact ETA Battery Current Pace Distance Remaining Real-time safety sharing. --- # Push Notifications Examples 👑 You became Commander of Châtelet. 🔥 You're only 120 KP away from becoming King. ❤️ New Heart Route unlocked nearby. 🏆 You set a new personal record. 🌅 Sunrise Quest starts in 30 minutes. 🎯 Weekly Quest expires tonight. Never spam. Only meaningful motivation. --- # Languages Fully localized. English French German Dutch Spanish Every title, quest, notification and interface element must translate naturally. --- # Profile Profile shows Avatar Title Current Territory Kingdom Points Weekly Distance Monthly Distance Yearly Distance Personal Records Badges Quest Progress Current Streak Followers Following Statistics Achievements --- # Animations Map zoom transitions Territory glow Button spring animations Smooth route drawing Confetti for achievements Card elevation effects Shared element transitions Animated counters Skeleton loading Haptic feedback Everything must feel fluid. --- # Technology Stack Frontend Flutter Backend Supabase Database PostgreSQL Authentication Supabase Auth Maps Mapbox GPS Native Android Fused Location Provider Native iOS Core Location Push Notifications Firebase Cloud Messaging Apple Push Notification Service Storage Supabase Storage Analytics Firebase Analytics Crash Reporting Firebase Crashlytics Localization Flutter Intl State Management Riverpod Architecture Clean Architecture Repository Pattern Offline-first synchronization --- # Anti-Cheat Reject impossible GPS jumps. Detect unrealistic speeds. Ignore suspicious activities in territory scoring. Validate GPS accuracy. Detect repeated identical routes with impossible timing. --- # MVP Features Authentication Profile Activity Tracking Map Territories Kingdom Points Titles Quests Personal Records Feed Followers Push Notifications Shape Routes Localization Settings --- # Success Metrics Day 1 Retention > 60% Day 7 Retention > 35% Average Runs/User/Week > 3 Average Session Length > 8 minutes Quest Completion Rate > 50% Weekly Active Users / Monthly Active Users > 45% Users should open the app because they want to: * Improve their health. * Become recognized in their neighborhood. * Complete unique quests. * Explore new places. * Share memorable running stories. Every feature must answer one question: **"Will this make someone excited to go for one more run today?"** If the answer is no, it does not belong in Version 1.

LandingNotificationsLoginQuests
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 6

project-3ccc68fa

Introduction

The project-3ccc68fa aims to develop a premium running platform that combines world-class activity tracking with hyperlocal competition, exploration, and community engagement. The platform is designed to enhance users' fitness, identity, territory, progress, and community involvement through an elegant, premium, and addictive experience.

System Overview

The system is a mobile application that provides users with a comprehensive running experience. It includes features such as activity tracking, territory management, social interaction, quests, and route discovery. The application is designed to be intuitive and engaging, with a focus on user motivation and community building.

Page 2 of 6

Functional Requirements as Story Points

  • As a User, I should be able to track my running activity, including distance, duration, average pace, current pace, splits, elevation, heart rate, cadence, calories, temperature, weather, running surface, shoes used, map route, automatic pause, background tracking, GPS accuracy, offline recording, and workout import.
  • As a User, I should be able to view a summary of my activities with beautiful statistics and animated route replays.
  • As a User, I should be able to earn Kingdom Points (KP) for completing runs, setting personal records, completing quests, and exploring new routes.
  • As a User, I should be able to see my influence in my local territory through KP and titles such as King, Commander, Knight, Ranger, Explorer, and Citizen.
  • As a User, I should be able to explore predefined territories and see the current King, Commander, Knights, Residents, Weekly Activity, and Territory Prestige.
  • As a User, I should be able to participate in quests and earn rewards such as KP, badges, and exclusive titles.
  • As a User, I should be able to discover new routes with categories like Couples, Beginners, Speed, Hills, Scenic, Coffee Run, Historic, and Creative Shapes.
  • As a User, I should be able to share my live location with emergency contacts and view ETA, battery, current pace, and distance remaining.
  • As a User, I should receive meaningful push notifications about my achievements, quests, and territory status.
  • As a User, I should be able to view my profile, including avatar, title, current territory, KP, distances, personal records, badges, quest progress, current streak, followers, following, statistics, and achievements.
  • As a User, I should experience smooth animations and transitions throughout the app.

User Personas

  • Runner: A fitness enthusiast who uses the app to track running activities, earn KP, and engage with the community.
  • Explorer: A user interested in discovering new routes and completing quests.
  • Competitor: A user focused on gaining influence and titles within their local territory.
  • Social User: A user who enjoys sharing achievements and interacting with other users through the social feed.

Core User Flows

  • Runner starts the app -> views animated map -> starts a run -> completes a quest -> earns KP -> increases influence -> shares achievement -> repeats.
  • Explorer opens the app -> discovers new routes -> completes a route -> earns KP -> shares route completion.
  • Competitor checks territory status -> participates in quests -> earns KP -> gains titles -> maintains or challenges for territory control.
  • Social User opens the app -> views social feed -> likes/comments on activities -> shares personal achievements.
Page 3 of 6

Visuals Colors and Theme

  • primary: Royal Blue (#4169E1)
  • primary_light: Light Royal Blue (#6A8DFF)
  • secondary: Gold (#FFD700)
  • accent: Crimson Red (#DC143C)
  • highlight: Amber (#FFBF00)
  • bg: Near Black (#0B0B0B)
  • surface: Dark Gray (rgba(24, 24, 24, 0.8))
  • text: White (#FFFFFF)
  • text_muted: Light Gray (#A9A9A9)
  • border: Gray (rgba(169, 169, 169, 0.2))

Signature Design Concept

The homepage features a full-screen interactive map that serves as the central hub for user interaction. The map dynamically updates to show territories, user influence, and real-time activity. Users can interact with the map by zooming, panning, and selecting territories to view detailed information. The map transitions smoothly with animations, providing a seamless user experience. The map's design incorporates glassmorphism elements, giving it a premium and modern look.

Page 4 of 6

LANDING HERO MOTION BRIEF

The landing page features a dynamic map that highlights user territories and achievements. As users interact with the map, territories glow and animate to show changes in influence and activity. The map includes animated transitions for zooming and panning, with smooth route drawing and territory updates. The map's interactive elements respond to user actions, providing haptic feedback and visual cues. The design is optimized for both light and dark modes, ensuring a consistent experience across devices.

Interaction Model & Motion Direction

  • Interaction Model: Animated
  • The landing page features moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements. The map and user interface elements animate smoothly, providing a polished and engaging experience.

Non-Functional Requirements

  • The app must support high-performance activity tracking with minimal battery consumption.
  • The user interface should be responsive and optimized for both iOS and Android devices.
  • The app must support offline-first synchronization to ensure data availability without an internet connection.
  • Localization must be seamless, supporting multiple languages including English, French, German, Dutch, and Spanish.
Page 5 of 6

Tech Stack

  • Frontend: Flutter
  • Backend: Supabase
  • Database: PostgreSQL
  • Authentication: Supabase Auth
  • Maps: Mapbox
  • GPS: Native Android Fused Location Provider, Native iOS Core Location
  • Push Notifications: Firebase Cloud Messaging, Apple Push Notification Service
  • Storage: Supabase Storage
  • Analytics: Firebase Analytics
  • Crash Reporting: Firebase Crashlytics
  • Localization: Flutter Intl
  • State Management: Riverpod
  • Architecture: Clean Architecture, Repository Pattern

Assumptions and Constraints

  • The app is designed for users who are interested in running and fitness activities.
  • The app must provide a premium user experience with high-quality animations and interactions.
  • The system should handle a large number of concurrent users and activities.
  • The app must comply with privacy and data protection regulations.
Page 6 of 6

Glossary

  • KP: Kingdom Points, a measure of user influence and activity.
  • Territory: A predefined region within a city where users can gain influence and titles.
  • Quest: A task or challenge that users can complete to earn rewards.
  • Route Discovery: A feature that allows users to explore and complete predefined running routes.
  • Live Beacon: A feature for sharing live location and safety information with emergency contacts.
Landing design preview
Landing: View Map
Login: Sign In
Home: View Map
Territory: Check Status
Quests: Participate
Run: Track Activity
Summary: Earn KP
Territory: Gain Title
Territory: Challenge Rival
Profile: View Title
Notifications: View Alerts