project-6b455c4e

Introduction

The "SEEKER" project is a mobile application designed to offer users a real-world exploration adventure game. It allows users to discover hidden locations, complete exploration missions, and engage with a community of explorers. The app is designed to provide a premium AAA-style experience with a clean, modern, and immersive design. Starting in Jordan, the app is scalable to a global audience.

System Overview

SEEKER is a mobile application that combines elements of adventure gaming with real-world exploration. Users can register, create custom profiles, and embark on missions to discover and document hidden or historical locations. The app features an interactive map, live streaming capabilities, and a robust gamification system to enhance user engagement and community interaction.

Functional Requirements as Story Points

• As a User, I should be able to register and log in to the app.
• As a User, I should be able to create and customize my profile with a username, avatar, and exploration statistics.
• As a User, I should be able to view my level, XP progress, achievements, and completed missions.
• As a User, I should be able to accept and complete exploration missions.
• As a User, I should be able to view mission details including location, difficulty, and GPS navigation.
• As a User, I should be able to explore a full-screen interactive map with mission markers and navigation paths.
• As a User, I should be able to upload photo/video proof of mission completion.
• As a User, I should be able to start a live stream during exploration.
• As a User, I should be able to follow other explorers and view their profiles.
• As a User, I should be able to participate in daily and weekly challenges.
• As a User, I should be able to view leaderboards and seasonal events.
• As a User, I should be able to like and comment on other explorers' discoveries.

User Personas

• Explorer: A user who engages in missions, uploads proof of exploration, and interacts with the community.
• Viewer: A user who follows explorers, watches live streams, and participates in community activities.

Core User Flows

• User registers -> creates profile -> accepts mission -> navigates to location -> uploads proof -> gains XP and achievements.
• Explorer starts live stream -> followers watch and comment -> explorer completes mission -> updates profile with new achievements.
• User views map -> selects mission -> follows navigation path -> completes mission objectives -> uploads proof.

Visuals Colors and Theme

• primary: Deep forest green (#123524)
• primary_light: Misty teal (#3FA7A3)
• secondary: Soft sky blue (#6EC6E8)
• accent: Warm sand beige (#D8C3A5)
• highlight: Clean off-white (#F5F5F0)
• bg: Clean off-white (#F5F5F0)
• surface: rgba(18, 53, 36, 0.8)
• text: Deep forest green (#123524)
• text_muted: Misty teal (#3FA7A3)
• border: rgba(18, 53, 36, 0.2)

Signature Design Concept

The SEEKER app will feature an interactive map as its signature design concept. The map will be a living, breathing entity that evolves as users explore new areas. As users discover locations, the map will gradually reveal hidden paths and markers, creating a sense of mystery and adventure. The map will include smooth animations and transitions, with a glassmorphism effect on mission cards and overlays. Users can interact with the map by zooming, panning, and tapping on mission markers to view details. The map will also feature dynamic weather effects and time-of-day changes to enhance the immersive experience.

Landing Hero Motion Brief

The landing page will feature a continuously moving 2D composition built with motion/react. The animation will depict a compass that transforms into a map, highlighting the user's journey from start to mission completion. The compass will rotate, and the map will unfold, revealing new paths and locations. The animation will loop every 10 seconds, with interactive elements allowing users to click on different parts of the map to explore further. The first frame will show the SEEKER logo with a call-to-action to start exploring.

Interaction Model & Motion Direction

The intended interaction model for the SEEKER app is "animated." The landing page will feature moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements. Each section of the app will have a distinctive core mechanic, such as morphing SVGs or kinetic typography, to enhance the user experience.

Non-Functional Requirements

• The app must be scalable to support a global user base.
• The app should maintain high performance and responsiveness.
• The app must ensure data privacy and secure access control.

Tech Stack

• Frontend: React Native for mobile app
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: Google Nano banana for image verification
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The app will initially launch in Jordan with plans for global expansion.
• Users must have GPS-enabled devices to participate in missions.
• The app will require internet connectivity for live streaming and map updates.

Glossary

• XP: Experience Points, a measure of a user's progress in the game.
• GPS: Global Positioning System, used for navigation and location verification.
• AI Verification: Automated system to confirm the accuracy of user-uploaded proof.
• Glassmorphism: A design style that uses transparency and blur effects to create a glass-like appearance.