https://github.com/eiri/codenames

A Vue3 + Ably implementation of Codenames board game.
https://github.com/eiri/codenames

ably codenames game vue

Last synced: 5 months ago
JSON representation

A Vue3 + Ably implementation of Codenames board game.

• Host: GitHub
• URL: https://github.com/eiri/codenames
• Owner: eiri
• License: mit
• Created: 2023-07-14T03:05:11.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-17T17:14:55.000Z (5 months ago)
• Last Synced: 2025-02-17T18:27:21.805Z (5 months ago)
• Topics: ably, codenames, game, vue
• Language: Vue
• Homepage: https://friday-game.netlify.app
• Size: 4.44 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Codenames

[![Netlify Status](https://api.netlify.com/api/v1/badges/33bba7d9-ee44-44de-bcb8-fcabb29b59a0/deploy-status)](https://app.netlify.com/sites/friday-game/deploys)

A [Vue3](https://vuejs.org/) + [Ably](https://ably.com/) implementation of [Codenames](https://en.wikipedia.org/wiki/Codenames_\(board_game\)) board game.

## Motivation

Just a quick hobby project for me and my friends.

![Game board](game_board.jpg)

## Building

Call `git clone` and then `npm install` to get the deps. The build tool is [Vite](https://vitejs.dev/), but before building the app it needs a couple of env var to be added in `.env`.

For multiplayer support the game needs an API key to talk to Ably servers and been a web app that means that the key will be exposed through JS source code. One way to go about it would be to use Netlify or Cloudflare functions to initialize the Ably client, but I went with another method and encrypted the key with AES-CBC, so it's all static and there is a shared secret between players that allows to decrypt the key on login.

To get the encryption's ciphertext and secret's checksum for a build set API key in `.env` file as `ABLY_API_KEY` and secret as `SECRET` and then run `npm run encrypt`.

```bash

$ npm run encrypt

> [email protected] encrypt

> node ./assets/encrypt.mjs

Because there is no global crypto property in this context, cryptographically unsafe Math.random() is used

VITE_KEY_CHECKSUM=...

VITE_KEY_CIPHERTEXT=...

```

Copy and paste the last two lines into `.env` file and run `npm run build`. Vite stores all the compiled code in `/dist` folder.

## Deployment

Pretty easy deployment to [Netlify](https://app.netlify.com), to be honest. Start a new site, link the repo, agree to all correctly guessed commands, add env vars and wait for deployment to finish. Then, optionally, change site name to something more catchy, discovering in the process that all the catchy names have already been taken.

The only gotcha is that it seems that the first deployment kicks in before env vars got set, so they haven't been picked up by Vite. However, no changes re-deployment did the trick.

All in all Netlify, as always, is a pleasure to work with, hugely intuitive and overall just amazing.

## Development

Run `npm run dev` and open the app on http://localhost:5173 It actually runs on `0.0.0.0`, to test on iPad, and it runs against real Ably account, because

![I don't always test my code, but when I do I, I do it in production.](i_dont_always_test_my_code.jpg)

There are not many tests, it's a hobby project, after all.

## License

[MIT](https://github.com/eiri/codenames/blob/master/LICENSE)