Skip to content

Repository files navigation

King's Cup

A pass-the-phone King's Cup card game for a table of players sharing one device. Draw a card, honor its rule, keep the King's Cup filling.

For adults of legal drinking age. Every card works "dry" too — swap sips for any forfeit you like.

How it plays

  • Add 2–20 players, then pass the phone around the table.
  • The app names the next player, they draw a card, and it shows that card's rule.
  • Every rank carries a rule: Waterfall, You, Me, Floor, Guys, Chicks, Heaven, Mate, Rhyme, Categories, Make a Rule, Question Master, and King's Cup.
  • Mates, house rules and the Question Master persist for the rest of the game.
  • The fourth King fills the cup and ends the game.
  • Before you start you can rewrite any card's rule and add your own house rules.

Pass-and-play with saved state

There is no server and no account. The whole game state — players, deck, drawn cards, mates, rules and whose turn it is — is written to localStorage after every action. Refresh the page or close the tab and the game resumes on the same turn. Reset clears the saved game and returns to setup.

Run it

pnpm install
pnpm dev        # http://localhost:5173
pnpm build      # production build
pnpm preview    # serve the build
pnpm typecheck  # tsc --noEmit

Requires Node 18+. npm and yarn work too.

Tech

React 18 · TypeScript (strict) · Vite 5. No dependencies beyond React; everything runs in the browser.

About

React/Vite pass-and-play Kings Cup game with persistent localStorage state, player setup, card log, cup meter, custom rules, and mobile-first UI.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages