VotePack

Stop arguing. Start voting. Just go.

VotePack is a group travel planner that turns every decision — destination, activities, itinerary — into a quick democratic vote. No login required.

Setup

1. Install dependencies

python scripts/setup.py

Or manually:

npm install
cp .env.example .env

2. Add your Gemini API key

Open .env and add your key:

VITE_GEMINI_API_KEY=your_key_here

Get a free key at Google AI Studio.

3. Run the dev server

npm run dev

Open http://localhost:5173

4. (Optional) Seed a test trip

python scripts/seed_trip.py

This writes a mock trip to public/seed_trip.json. Load it in-browser via the console:

// Paste this in the browser console after loading the app
const trip = await fetch('/seed_trip.json').then(r => r.json())
localStorage.setItem('votepack_trips', JSON.stringify({ [trip.code]: trip }))

Then navigate to /trip/DEMO01/dashboard.

Build

npm run build

Validate

python scripts/validate.py

PDF Export (Phase 4)

pip install reportlab
python scripts/export_pdf.py --trip public/seed_trip.json

Stack

• React 18 + Vite
• Tailwind CSS
• React Router v6
• Leaflet / react-leaflet (map voting)
• Framer Motion (animations)
• Gemini 2.5 Flash (itinerary generation)
• localStorage (no backend required for MVP)