Xplore - cs428TAs/f2026 GitHub Wiki

Think paper.io but with real life location data. Xplore is a progressive web app where users record trips they go on (categorized: walk, run, bike, drive, etc), to gain territory. Users can join groups, and steal territory, and have time based competitions.

• How to request location data
• When to start recording location data
• How often to request location data
• How to connect and map saved location data
• Time based convex hull algorithms

flowchart TD
    A["Josh<br/>Project Manager"]
    B["Bryce<br/>Chief Architect"]

    A --> C["Jocelyn<br/>Head of QA"]
    B --> C

    A --> D["Mark<br/>DevOps Specialist"]
    B --> D

    A --> E["Abbie<br/>UI/UX Designer"]
    B --> E

Bryce: tbd based on project architecture

• Bryce: Build test PWA app
• Mark: Explore database options for geo location storage and comparison
• Josh: Org Chart
• Abbie: App mockups
• Jocelyn: Pull request and code management processes (create an organization)

• Map

  • Display a map where a user's walk can be represented.
  • Show a walking path on the map using mock or prototype data.

• Walk Tracking

  • Allow the user to start a walk.
  • Allow the user to end a walk.
  • Display the walk/path on the map.

• Territory Claiming

  • Show a mockup of what claiming territory will look like.
  • Demonstrate how a completed walk could result in claimed territory.

• User Registration

  • Allow users to register an account.

The application should move from a prototype to functional location tracking and territory claiming.

• Active Location Tracking

  • Track the user's location while they are walking.
  • Update the user's path on the map as they move.

• Territory Claiming

  • Allow the user to complete a walk.
  • Convert the completed walk into claimed territory.
  • Associate the claimed territory with the user.

The final application should support multiple users and allow users to see the territories claimed by other players.

• Multiple Users

  • Support multiple registered users.
  • Display multiple users' territories on the map.

• Territory Map

  • Show the user's own claimed territory.
  • Show other players' claimed territories.
  • Identify which player owns each territory.

These features are not required for the initial implementation but may be considered if time allows.

• Territory Stealing

  • Allow players to capture territory belonging to other players.
  • Update territory ownership when territory is captured.

The following features are explicitly outside the scope of the project:

• Workout tracking
• Speed tracking
• Chat features
• Offline mode
• Friends
• Groups
• Teams

Mark: mbird13 Josh: joshuahala Jocelyn: jocelynperucca Abbie: abbie-barton Bryce: bolasson

Status Report 1 Status Report 2 Status Report 3 Status Report 4

🟧 - Frontend | 🟦 - Backend | 🟥 - DevOps

Architecture & Design Document