gamekit

The TV is the table.
Phones are the hands.

gamekit is the shared spine under the deluxified games: rooms, seats, bots, secrets and screens, so a new party game starts as rules and art instead of plumbing.

The manifesto

What we believe a living-room game owes the people in the room.

  1. The TV is the table. Phones are the hands.

    Everything on the big screen is public, and everything secret lives on the phone in your hand. Nobody ever has to touch the TV.

  2. No app. No account. Scan and sit down.

    A QR code and a four-letter room is the whole onboarding. If a guest needs instructions to join, we built it wrong.

  3. Every table can start tonight.

    Bots fill the empty chairs, so a game for five works with two. And a bot uses the front door: the same moves a person sends, no special cases in the rules.

  4. Nobody steals your turn.

    A bot covers an idle seat only after a five-minute clock that everyone can see. The seat stays yours, and one tap takes it back.

  5. Secrets are structural.

    Each viewer gets their own projection of the game. If a field is not projected, it never leaves the server, so there is nothing to peek at in the network tab.

  6. A restart never loses a table.

    Game state is plain JSON: no classes, no closures. Rooms snapshot on shutdown and come back mid-hand.

  7. Rules are a pure function.

    State in, intent in, state out. A refused move changes nothing. A crash freezes one room, never the house.

  8. The ending is the payoff.

    A total is not an ending. Show what was hidden, who turned it, and what you missed.

  9. Show, don't describe.

    Help pages carry real screenshots that a script retakes, and the numbers on a rules card come from the rules themselves. A rebalance cannot leave the card lying.

  10. A library, not a landlord.

    Every game keeps its own server, its own repo and its own deploy. The kit is adopted one file at a time, from the edges inward. The framework that owned the transport got one game. This one has dozens.

  11. Every line was paid for.

    The contract is a list of bugs that happened twice. We wrote it down so nobody pays a third time.

What the kit gives a game

One Bun process per game. The kit owns the room; the game owns the fun.

πŸšͺRooms

Four-letter codes, a lobby, ready / start / rematch, idle rooms swept, fixed codes for a TV that lives on the wall.

πŸ“±Scan to join

A QR on the TV seats a phone in seconds. Reconnect by seat, with a private token so nobody can sit in your chair.

πŸ€–Bots by default

The kit schedules them (turns, beats, or a realtime tick). The game only decides what a bot plays.

⏳Presence

Who the table is waiting on, on every screen. Idle seats get covered, late phones can take over a bot.

πŸ™ˆPer-viewer state

One public state for the TV, one private frame per seat. Hidden-hand games are the default, not a hack.

πŸ’ΎSnapshot + replay

Pure-JSON state with a seeded RNG: restore a room exactly, or replay a whole game from its seed.

🧭Room directory

Every game answers /api/rooms the same way, so one front door lists every open table.

🏁End-screen debrief

Standings with honest ties, the reveal, and three to six turning points picked from the log.

πŸ”ŠSound and speech

A radio, effects, a narrator. With no TV in the room, one phone reads the table aloud.

πŸ“Rules facts

Declare a number once; the rules card, the splash and the engine all read the same one.

πŸ“ΈShotkit

Plays a real game headlessly and retakes every help-page screenshot.

πŸ§ͺgk

gk new stamps out a playable game. gk sim runs a thousand bot games. gk check audits one against the contract.

The whole seam is one object

A game hands the kit a GameDef and two screen hooks. That is the entire contract in code.

export const game: GameDef<State> = {
  id: 'mygame', name: 'My Game',
  seatsMin: 2, seatsMax: 6,
  botNames: ['Ada', 'Grace', 'Linus'],
  intentTypes: new Set(['play', 'pass']),
  engine,              // createGame / startGame / applyIntent
  privateFramesFor,    // what each seat alone may see
  debrief,             // what the table missed
};
startGameServer(game);
The kit ownsYour game owns
Rooms, codes, lobby, rematchThe rules, as a pure reducer
WebSocket protocol and reconnectWhich moves exist
When a bot actsWhat a bot plays
The privacy funnel and snapshotsWhat each seat may see
Join, lobby and end screensThe play screens and the art

Two ways to sit down

A game should work on both.

πŸ“ΊPhone + TV

The living room. Put the game on any screen with a browser, scan the code, play from the couch.

πŸ––Touch stations

The game table. Every seat is a dealt touch panel, and a launcher deals the next game to all of them at once.

Built on it

Open one on a TV or laptop, then scan in with your phone.

πŸŽ₯Cinemashers Live

Cinemashers for a room full of people. The TV hosts the marquee and drops clues in three acts: tagline and years, the mashed synopsis, then the poster. Everyone scans in and types guesses on their phone; solve early to score more, and name one of the two source films for a bonus.

Party Phone + TV

🎲All-In Bingo

A casino-themed twist on classic bingo with betting mechanics. Place your chips, call your numbers, and go all-in when you're feeling lucky. Perfect for game nights and parties.

2+ Players Party Game

πŸ•΅Wobble Mysteries

Jonathan Leistiko's game of wobbly crosswords. A mastermind builds a crossword face down on the board of Calder Wobblers and needs 33 points to make their getaway. The detectives are told only how long each hidden word is and what it scored, and they get one guess a round: a box for the right letter in the right place, a line for the right letter in the wrong place. Crack a word and its points come off the mastermind β€” and its tiles turn face up, which gives away letters in everything that crosses it. Nobody for the villain’s chair? The house takes it.

2–5 Players Phone + TV Asymmetric Word Game

🎡Yearworm

A music timeline party game: the TV plays a clip, you name the artist and the song, guess the decade and slot it into the timeline of every song so far.

1–16 Players Music Phone+TV Teams

🍴Seven Ate Nine

A food-chain card game where every creature eats the one below it. Play and reference cards from a single clever 50-card deck as you climb the chain - eat or be eaten.

2-5 Players Card Game

🐟Read Herring

Hot potato with a reading test. A red herring with a lit fuse lands on your phone: is it the RED fruit, or the fruit in RED? Answer right to throw it on before it blows. Plus a solo Fuse Run.

2–10 Players Party Phone+TV Solo

πŸ™…Not a clue!?

Every clue says what the secret word is NOT, and one clue-giver is secretly the Liar with one lie to tell. Three guesses, a sand timer, and one chance to point and shout β€œNot a clue!?” Speed Not mode: anyone, any time.

4–10 Players Party Word Game Hidden Liar Phone+TV

🌊Deep Frontiers

Mine DeepGlass from a deep-sea crater: crystal clear, stronger than steel, and all that is left of the Ancients' sunken city. Now they wake to take it back. Roll your subs, dock them at the Rig, raid the Mothersphere and land habitats together before the Pulse crushes the Rig. Solo: you run 2 crews. A co-op Alien Frontiers by Shawn Storie & Jonathan Leistiko.

1–4 Players Co-op Dice Placement Phone+TV

βš—οΈQuintessential

Run an alchemist's laboratory. Fill your flasks with fire, water, earth and air dice, win new formulas at auction, and set off chain reactions where one card's new die fires the next. Feed one of each element to your forge to make a Fifth Element; the first to own five ends the game.

2–5 Players Dice Engine-Builder Chain Reactions Phone+TV

πŸ“Uncopyrightable

A clever word puzzle game built around heterograms - words where no letter repeats. Challenge yourself to find the longest words using only unique letters. How many can you discover?

Word Game Phone+TV

10 of 36 live games are out front. The rest are still in the lab. See who is playing now β†’