Geoscavenger

# Geoscavenger

> Real-world hunts · built for end-user ease

Real-world scavenger hunts created by AI in minutes — verified clue locations, photo and GPS answer checking, murder mysteries, lesson-plan hunts and local sponsor offers.

## Outcome

**Endless, custom hunts anywhere, anytime — with zero content upkeep.**

- Any place, any theme, any group size, generated on the spot
- No maintenance: hunts are created fresh, never hand-built
- Story-led clues make every hunt feel fun and interactive
- Options for every age, from kids and ADA-accessible routes to adult-only
- Guests join and play without making an account

## Problem

Planning a good scavenger hunt takes hours — writing clues, checking locations and judging answers — so families, teachers, hotels and event hosts rarely do it.

## Solution

Geoscavenger generates scavenger hunts in real time, anywhere in the world, from a simple prompt. Every hunt is built on demand, so there is no library to maintain and no content team to keep it fresh: the catalogue never runs out. Hosts describe the event, audience and story; AI writes narrative-driven clues, checks every location is real, and judges answers by photo, text or GPS.

| Problem | Solution |
| --- | --- |
| Home party host wants a hunt tonight. | Prompt a theme and the neighborhood; a full story hunt is ready in minutes, guests join by QR. |
| Hotel hosting a holiday hunt for many guests. | Custom map of the property, holiday narrative, many teams playing at once with instant answer checks. |
| Scout troop needs an outdoor activity. | Age-appropriate clues in a park or trail area, with GPS and photo check-ins for each stop. |
| Teachers lack time to build activities. | Upload a study guide; the hunt's narrative is built from it so students learn while they play. |
| Someone has to judge every answer. | AI photo, text and GPS checks give instant results. |

## Features

- AI hunt and clue generation, including custom uploaded maps
- Photo, text and GPS answer verification
- Murder mystery and storyline modes with AI characters and illustrations
- Lesson-plan hunts: upload a plan, get a student hunt
- Teams, guest join, leaderboards and QR sharing
- Printable hunt sheets, station cards and storybook export
- Vendor and sponsor offers with QR redemption and analytics
- Subscriptions for players, educators and vendors

## Tech stack

- React + TypeScript
- Vite
- Tailwind / Radix UI
- Capacitor (iOS & Android)
- Lovable Cloud (Postgres, auth, functions)
- Lovable AI Gateway (text and image models)
- Google Maps
- Stripe subscriptions
- Resend email
- jsPDF, PDF.js, Mammoth

## Notable components

- Real-time, global hunt generation: anywhere, anytime, never-ending, with no content to maintain
- Prompt-driven narrative engine shaping every hunt type (party, holiday, scouts, school, mystery)
- Study-guide-to-hunt: school narratives built from the lesson material
- Multiple clue types (riddle, photo, text, GPS) with audience settings from kids and ADA-accessible to adult-only
- AI photo verification of real-world answers
- Automatic verification and replacement of clue locations
- Story consistency checker for AI murder mysteries
- Lesson-plan-to-hunt conversion

## Compliance

- AI content moderation on every hunt
- Photo privacy policy and location reporting
- Auto-pause of dormant hunts and guest account cleanup

## Scope

- 33 backend services, including 6 AI verification and moderation services
- 49 app screens; iOS and Android builds
- Guest play without an account, with automatic guest cleanup

## Links

- Live: https://geoscavenger.com

## Author

Candace Hagood · Product & Quality Leader · AI Engineering