Home screen
Incorrect guess
Correct guess

Geo-Quest

How to play

After pressing Play, the user is shown an image taken from somewhere within a selected range of their current location. The goal is to physically reach that spot and press "Guess" when they think they’ve found it. Users have three guesses, with points decreasing after each attempt.

Features

Frontend (React)

Built with React for a dynamic, component-based UI.
Real-time GPS tracking and live location updates using the browser's geolocation API.
Axios-based communication for efficient API calls.
Styled feedback system with popups for success/failure events.

Backend (Flask)

Lightweight Python Flask server for handling API requests.
Serves Google Maps Static API images based on user coordinates.
Implements CORS and secure routing for seamless cross-origin interaction.

Game Mechanics & Security

Location verification using a precision threshold (within 100m radius) calculated by the Haversine formula.
Point system with decreasing rewards over three allowed guesses.
Secure login and signup with JSON Web Tokens (JWT) for robust user authentication.

What's next for Geo-Quest

Adding speed checker for blocking users from cheating by using vehicles
Adding collectibles or some sort of shop where the points can be spent at
Adding virtual cards or items that only exist in virtual space and can be scanned, once scanned they can be added to the user's collection

Built With

Created by

- Implemented location route on flask backend. Used for retrieving random images using the Google Maps static API and serving them on the frontend.

- Implemented register / signup routes on the backend. Used for creating new users / logging in (using JWT auth)

- Implemented JWT authentication so specific routes (e.g. location) cannot be accessed by users who are not logged in.

- Created the index route with the logo, play button, settings button and manual button. Alongside popup modals for the settings and manual button.

- Created the Play route, where the user's location is retrieved, sent to the backend, a random image is generated (alongside metadata, such as the image coordinates) and displayed. This page also features the user's current location and a guess button, allowing users to guess when they think they are in the right spot.

- Implemented the Guessing logic with a pop-up displaying information about the users guess (if they're correct / incorrect, and how many points they have earned)

Aleksander Tacconi
Sonny Pullen
Daniel Cocos
Computer science student at university. Outside of class I write programs that I either find interesting or useful.

Updates

Aleksander Tacconi started this project — Jul 31, 2025 05:47 PM EDT

Leave feedback in the comments!

Log in or sign up for Devpost to join the conversation.