The Hippie Hill Hunt is an interactive mobile web experience that guides visitors through various zones in San Francisco's Golden Gate Park. Players explore different areas of the park, looking for hidden QR code stickers at notable locations. Each zone has its own unique hints - starting with a cryptic haiku and progressing to more direct clues if needed.
When players find a sticker, they can either scan the QR code or manually enter the code to mark that zone as discovered. The game tracks progress and allows players to share their completion results, including how many hints they needed for each zone.
The experience emphasizes respectful exploration - all stickers are placed in publicly accessible areas, and players are encouraged to stay on designated paths while enjoying their hunt through the park.
- Node.js 22.x
- Yarn package manager (v4.5.0 or later)
- Supabase (local or remote)
- Clone the repository
git clone https://github.com/danthedaniel/scavenger.git
cd scavenger
- Install dependencies
yarn install
- Install and run Supabase locally
npx supabase start
- Set up environment variables
cp .env.example .env
Edit .env with your Supabase credentials and other required values.
- Start the development server
yarn dev
The app will be available at http://localhost:3000
- Frontend: Next.js with TypeScript
- Styling: Tailwind CSS
- Backend: Supabase for data storage
- Maps: Custom SVG-based interactive map implementation
- PWA Features: Installable web app
The application uses React Context for state management, with modular components handling different aspects of the game experience. The map implementation uses SVG for efficient rendering and interaction, while game state persists through local storage and Supabase.
AGPL-3.0 - See /LICENSE file for details
CC0 - See /assets/LICENSE for details