A
Aveo Software Inc.
Project Proposal · Prepared for Kevin Dunlap

HuntBoard: QR Team
Scavenger Hunt Platform

A browser-based, mobile-first scoring platform for your live events. Guests scan, pick a team, and watch the rivalry play out live on your projectors. Built once, reused every event.

▸ View the live working prototype
Prepared For
Kevin Dunlap
Prepared By
Keval G. · Aveo Software Inc.
Date
June 3, 2026
Valid Until
June 17, 2026
01 Executive Summary

A scoring platform you own, not a subscription you rent.

Your guests scan QR markers placed around the venue, join Gold or Silver on their first scan, and every code adds points to their team. Two big-screen pages keep the live score in front of the room, updating instantly with no refresh. Behind it, a simple admin panel lets you build the hunt, adjust points on the fly, and re-skin the whole thing for the next event in minutes.

The difference from the off-the-shelf tools you mentioned: this is built once and yours to keep. No recurring membership, no per-event fees. Run it twice a year, every year, with fresh QR codes and team names each time.

A complete working prototype is already live at huntboard-ar5.pages.dev, so you can walk the full flow on your own phone before a single line of production code is written.

02 What We Understand You Need

Twenty checkpoints. Two teams. One live scoreboard.

Guests scan QR codes with their phone camera, no app install
Pick Gold or Silver on the first scan, locked for the event
Each QR adds its own point value to that team's total
One scan per guest per code, so nobody farms points
Some checkpoints stay locked until prerequisites are scanned
Two projector pages with live totals, updating without refresh
Admin can add or subtract points and view standings live
Create, edit, disable, or delete checkpoints; reset between events
Re-skin per event: team names, colors, graphics, QR codes
Optional phone capture with SMS newsletter opt-in
Roughly 20 QR activity markers per event
Reusable for events twice a year, with new codes each time
03 What We Will Build · V1

Everything in the prototype, production-ready.

The eleven items below make up the complete V1. Each one is already represented in the live prototype, so there are no surprises about what you are signing off on.

✓
Phone QR scanner with team choice on first scanBrowser-native camera scan, Gold or Silver locked in on the opening scan.
✓
Per-QR point values with prerequisite locksEach of the 20 markers carries its own points; gated checkpoints unlock once their prerequisites are scanned.
✓
Anti-cheat: one scan per guest per codeDevice token plus optional phone identity prevents repeat-scanning the same marker.
✓
Two projector broadcast pages, liveMain and secondary big-screen views, team totals updating in real time with no refresh.
✓
Admin dashboardLive standings, manual point adjustments, full checkpoint create/edit/disable/delete, and score reset between events.
✓
Event rebrand panelSwap team names, colors, logo, and regenerate the printable QR-code pack for the next event in minutes.
✓
Optional phone capture + newsletter opt-inCollect guest numbers with consent and hand them to your existing SMS platform.
✓
Reporting: CSV export + most-scanned analyticsSee which checkpoints drew the crowd and export the full event record.
✓
Single-password admin accessNo user accounts to manage; one password gets you into the control room.
✓
Deployment to your hosting of choiceCloudflare, Vercel, or your own server. You hold the keys.
✓
Handoff document + 30-minute Loom walkthroughSo you can run, reset, and re-skin every future event yourself.
04 How It Works

Simple, reliable, and entirely yours.

1 Mobile web, no app

Guests scan straight from their phone browser. Nothing to download, works on iPhone and Android.

2 Real-time scoring engine

Scores update the moment a code is scanned and push live to the projector pages with no manual refresh.

3 Admin control room

One password gets you standings, point overrides, checkpoint management, and the per-event rebrand panel.

4 Built to handle the crowd

Designed for 100 to 300 guests scanning at once during a live event, tested on real devices.

Under the hood: React front-end, Node.js back-end with real-time updates, PostgreSQL database, browser-native QR scanning. Final hosting, interface library, and database provider are confirmed with you up front so the build fits your infrastructure, not the other way around.
05 Timeline

Three to four weeks, from kickoff to your hands.

Week 1 · Foundation

Scan flow and the 20 markers

Database, the phone QR scan and team-choice flow, anti-cheat, point values, and prerequisite locks for all 20 checkpoints.

Week 2 · Live Scoring

Broadcast pages and admin standings

The two real-time projector pages, plus the admin dashboard with live standings and manual point adjustment.

Week 3 · Control & Rebrand

Full admin and event re-skin

Checkpoint create/edit/disable/delete, score reset, the per-event rebrand panel, printable QR-pack generation, and analytics.

Week 4 · Launch

QA, deploy, and handoff

Cross-device testing on real iPhones and Androids, your acceptance review, deployment, and the handoff document plus Loom walkthrough.

06 Your Team

Lean and direct. You talk to the person building it.

Lead Full-Stack Developer
Keval G.

Architecture, the full build front to back, real-time scoring, the admin panel, and deployment. Your single point of contact throughout.

QA Pass
Dedicated device testing

Real-device testing across iPhone and Android, anti-cheat and prerequisite-lock verification, and a concurrency check for live-event load.

One relationship, not a committee. You work directly with Keval, the developer writing the code. Updates come in writing, on a cadence that suits you.
07 Investment

One fixed price for the complete V1.

Fixed Project Price
$2,475 USD

Covers the entire eleven-item V1 above, scoped against the live prototype. No hourly meter, no surprises. Engaged through Upwork with milestone-funded escrow.

Included in the price
  • All eleven V1 deliverables
  • Full source code, owned by you
  • Cross-device QA (iPhone + Android)
  • Deployment to your hosting
  • Handoff doc + 30-min Loom walkthrough
  • 30-day warranty from go-live date
Milestone schedule
  • 50% advance · funded in Upwork escrow at kickoff
  • 30% at live-scoring demo · broadcast + admin
  • 20% at delivery · rebrand panel, QA, handoff
08 Out of Scope

Clear boundaries, with room to grow.

These are deliberately excluded from V1 to keep the build focused and the price honest. Each is available as a future phase whenever you want it.

Running multiple events simultaneously on one install
Photo-challenge checkpoints judged by an admin
VIP or sponsor QR badges with special rewards
A team chat or cheer wall on the broadcast page
A native iOS / Android app (V1 is mobile web)
Selling tickets through the app via Stripe

Anything here can be added later without rebuilding the core. The V1 architecture is designed to extend.

09 Engagement Terms

Straightforward and fair to both sides.

1
Validity

This proposal and the $2,475 fixed price are held for you for 2 weeks, through June 17, 2026.

2
Engagement

Contracted and paid through Upwork with milestone-funded escrow, so your payment is protected at every stage.

3
Start

Work begins as soon as the first milestone is funded. The 3 to 4 week timeline runs from that kickoff.

4
Ownership

Full source code and all deliverables transfer to you on final payment. The platform is yours to run, reuse, and extend forever.

5
Warranty

A 30-day warranty from the go-live date covers any defect in the delivered V1 at no charge. This is our standard on every build.

6
Acceptance

A reply confirming you would like to proceed is all it takes to lock the scope and schedule the kickoff.