diff --git a/README.md b/README.md index 985ac80..9e4c5b5 100644 --- a/README.md +++ b/README.md @@ -3,15 +3,13 @@

Find the latest deployment here: https://playwerewolf.uk.r.appspot.com/. -I value your feedback. An application to run games of Werewolf (Mafia) -smoothly when you don't have a deck, or when you and your friends are together virtually. Inspired by my time playing -Ultimate Werewolf and by -2020's quarantine. The app is free to use and anonymous. +smoothly when you don't have a deck, or when you and your friends are together virtually. Basically, a host builds a game and deals a role to everyone's device, and then the app keeps track of the game state (timer, player statuses, etc). + +Inspired by my time playing Ultimate Werewolf and by +2020's quarantine. The app is free to use, anonymous, and fully open-source under the MIT license. After a long hiatus I've rewritten a lot of the code and think this version works a lot better. This was (and still is) fundamentally a learning project, so feedback or assistance is appreciated. -After a long hiatus from maintaining the application, I have come back and undertaken a large-scale redesign, rewriting -most of the code and producing a result that I believe is more stable and has much more sensible client-server interaction.

@@ -35,11 +33,7 @@ The application prioritizes responsiveness. A key scenario would be when a group ## Tech Stack This is a Node.js application. It is written purely using JavaScript/HTML/CSS. The main dependencies are -Express.js and Socket.io. It is fully open-source -and under the MIT license. This was (and still is) fundamentally a learning project, and thus I welcome collaboration -and feedback of any kind. - -All pixel art is my own, for better or for worse. +Express.js and Socket.io. ## Contributing and Developers' Guide @@ -62,10 +56,10 @@ This command uses nodemon to listen for changes to **server-side code** (Node.js modules) and automatically restart the server. If you do not want this, run instead `npm run start:dev:no-hot-reload` or `npm run start:dev:windows:no-hot-reload`. -If you are developing as well, in a separate terminal, execute `npm run build:dev`. This uses +If you are making changes to client-side javascript, in a separate terminal, execute `npm run build:dev`. This uses Webpack to bundle javascript from the `client/src` directory and place it in the `client/dist` directory, which is ignored by Git. This command uses the `--watch` flag, which means the process will continue -to run in this terminal, watching for changes to JavaScript within the `client/src` directory and re-bundling automatically. You +to run in this terminal, watching for changes within the `client/src` directory and re-bundling automatically. You definitely want this if making frequent JavaScript changes to client-side source code. Any other changes, such as to HTML or CSS files, are not bundled, and thus your changes will be picked up simply by refreshing the browser.