🎉 Party Planner
A small, cheerful web app for planning a team party, from "where should we go?" to "see you on the 19th!".
- Join: pick one of 100 animal avatars and a fake party name (plus a passcode so you can log back in).
- Ideas 💡: everyone adds ideas with a Google Maps or website link, photos and cost info.
Paste a link and the app grabs its name and preview photo when the site provides one.
- Vote 🗳️: everyone gets about a third as many votes as there are ideas (1–5) and spends them.
The organizer can crown the winner or run a runoff between the top few.
- Dates 📅: everyone suggests dates, then votes on them the same way.
- Party! 🥳: the winning idea and date, plus confetti.
The person who creates a party is its organizer. They can move each step along early, or set a
deadline after which it moves on by itself.
Running it locally
Requires Node 20+.
npm install
npm run dev
Open http://localhost:3000. A local SQLite file (local.db) is created and migrated automatically.
Copy .env.example to .env.local if you want to change any settings.
Other commands: npm test, npm run lint, npm run typecheck, npm run build.
Deploying (Vercel + Turso)
- Create a free database at Turso:
turso db create party-planner, then get its URL (turso db show party-planner --url)
and a token (turso db tokens create party-planner).
- Import this repo into Vercel and set these environment variables:
DATABASE_URL: the libsql://… URLDATABASE_AUTH_TOKEN: the tokenSESSION_SECRET: a long random string (openssl rand -base64 32)INVITE_CODE (optional but recommended): a code people must enter to join
- Deploy. Each build runs the database migrations before building the app.
How it's built
Next.js 16 (App Router, server actions) + Tailwind CSS v4 + Drizzle ORM on Turso/libSQL.
There are no other services: photos are shrunk in the browser and stored in the database, and
deadlines are checked whenever someone opens the party, so there's no cron job. See CLAUDE.md
for the architecture and conventions.
Credits
Animal avatars are Twemoji by Twitter, Inc. and other
contributors, licensed under CC-BY 4.0.
