Play cards with your friends even if you didn't bring any 🚫 🃏 — but everyone got a smartphone right? 📱
A mobile first (maybe only) web application that lets you play cards against humanity with friends without having a deck of cards handy. Although it works fully remote it is most fun if played in a IRL group.
Matchmaking is done via a serverless backend where clients are connected using a session token that gets shared from the host to its friends/players.
Run node server on port 3000 and webpack dev server on 8080 to develop both with hot reloading and open localhost:8080
# start dev server
npm run dev-server
# start webpack-dev-server in ./web directory
npm run dev-clientuse cases and interactions
game states
All communication between clients and the server happens over websockets and is therefore eventbased. Clients fire an event and the reaction is triggered once the server responds. With high latencies this event driven approach might feel unnatural.
There are two different state machine definitions one from the server viewpoint that describes the progress of a single game and one from a client view that describes the current client (UI) state.
Payloads updates of type Array are always in the form of:
{ add: [], remove [], status: [] }where add is a list of players/votes/cards that were added, remove resources that have to be removed from local state and status is a complete update of the state that should overwrite local state.
A special ACK event is emitted by the server in response to a client message that modifies state, e.g. voting on start, choosing a card.
Cards taken from crhallbergs collection of decks. The originals, his collection as well as all derivatives within this project are licensed under CC BY-NC-SA 2.0.
Any code in this project is licensed under MIT