Tier Gist

Tier Gist is a multiplayer tier-list party game. Players join a room, add items, rank each other's picks, and see the results round by round.

It can run locally without setup, or use Supabase for live deployed games.

Features

• Room-code multiplayer
• Host lobby, topic collection, item submissions, ranking rounds, and results
• Group tier list mode with password-based player rejoin
• Safe-search Pixabay image suggestions for submitted items
• Shareable room links
• Local room sandbox for development

Stack

• Vite + React + TypeScript
• Tailwind CSS v4 via @tailwindcss/vite
• Supabase for auth, database, storage, and room state
• Vitest for game-logic tests
• Render static deployment via render.yaml

Local Development

npm install
npm run dev

Without environment variables, the app uses a browser-local room sandbox. That makes it easy to test the game in multiple tabs.

Scripts

npm run dev
npm run build
npm run test
npm run lint

Environment

Copy .env.example to .env.local to enable integrations locally:

• VITE_SUPABASE_URL
• VITE_SUPABASE_ANON_KEY
• VITE_PIXABAY_API_KEY

VITE_* variables are client-side config and can be visible in the built app. Do not put service-role keys, admin tokens, or deployment credentials in frontend env vars.

Deploy To Render

1. Import the project into Render as a Static Site, or let Render detect render.yaml.
2. Use npm ci && npm run build as the build command.
3. Use dist as the publish directory.
4. Add the two VITE_SUPABASE_* env vars so the deployed app uses Supabase.
5. Add VITE_PIXABAY_API_KEY if you want safe Pixabay image suggestions enabled.
6. Deploy. render.yaml rewrites app routes to index.html and redirects /join/:code links to /room/:code.

Database

Supabase schema changes live in supabase/migrations. Apply them to a Supabase project before running the deployed multiplayer mode.

License

Tier Gist is released under the MIT License.