Home

Awesome

đŸē Werewolves Assistant Web

GitHub release GitHub license Build Status Known Vulnerabilities Contributions are welcome

ForTheBadge open-source ForTheBadge built-with-love ForTheBadge made-with-vue

📋 Table of Contents

  1. đŸē What is this tool ?
  2. 🔍 Let's try !
  3. 🃏 Roles available
  4. 📈 Versions & changelog
  5. ☑ī¸ Code analysis and consistency
  6. 🔨 Installation
  7. 🔌 Let's go
  8. ⚙ī¸ Other useful commands
  9. Šī¸ License
  10. ❤ī¸ Contributors

<a name="what-is-this-tool">đŸē What is this tool ?</a>

đŸē Werewolves Assistant Web is a Vue web app using the <a href="https://github.com/antoinezanardi/werewolves-assistant-api" target="_blank">Werewolves Assistant API</a>. Thanks to this app, being the game master of the Werewolves of Millers Hollow game is so easy !

đŸē Werewolves Assistant Web provides some cool features :

🤔 Want to know more about this awesome project ? <a href="https://werewolves-assistant.antoinezanardi.fr/about" target="_blank">Check out the dedicated about page</a>.

<a name="lets-try">🔍 Let's try !</a>

Two versions are available for testing this project:

✨<a href="https://werewolves-assistant.antoinezanardi.fr" target="_blank">Main version</a>

🔧<a href="https://sandbox.werewolves-assistant.antoinezanardi.fr" target="_blank">Sandbox version</a>

Sandbox version may contain some bugs and unexpected behaviors as its purpose is to test new features before deploying on main version.

Both versions are running on a server with the following configuration:

The MongoDB database is protected under username and password authentication.

<a name="roles-available">🃏 Roles available</a>

On this current version GitHub release, 24 different roles are available to play:

Please check the <a href="https://werewolves-assistant-api.antoinezanardi.fr/apidoc/#player-roles" target="_blank">Player role section on API documentation</a> or the <a href="https://werewolves-assistant.antoinezanardi.fr/about" target="_blank">Available Roles section on the official website</a> for more details about each role.

<a name="versions">📈 Versions & changelog</a>

Each change when a new version comes up is listed in the <a href="https://github.com/antoinezanardi/werewolves-assistant-web/blob/master/CHANGELOG.md" target="_blank">CHANGELOG.md file</a> placed at project's root.

Also, you can keep up with changes by watching releases with the Watch GitHub button at the top of this page.

Current release on main version is GitHub release.

Travis helps the project to be automatically updated by deploying new versions for both sandbox and main versions. Please refer to the .travis.yml file for more details.

🏷ī¸ <a href="https://github.com/antoinezanardi/werewolves-assistant-web/releases" target="_blank">All releases for this project are available here</a>.

<a name="code-analysis-and-consistency">☑ī¸ Code analysis and consistency</a>

In order to keep the code clean, consistent and free of bad JS practises, ESLint is installed with nearly 320 rules activated !

Complete list of all enabled rules is available in the .eslintrc.js file.

<a name="installation">🔨 Installation</a>

  1. Install dependencies with npm install (add --production to omit dev dependencies).
  2. Copy .env.example and paste it as .env.
  3. Replace environment values in the fresh new .env file if necessary (When ⚠ī¸ī¸ Required is specified):
    • VUE_APP_WEREWOLVES_ASSISTANT_API_URL: Base URL of Werewolves Assistant API.
      • ⚠ī¸ī¸ Required
    • VUE_APP_WEREWOLVES_ASSISTANT_WEB_URL: Base URL of Werewolves Assistant Web app. Set to localhost:8080 if in development mode.
      • ⚠ī¸ī¸ Required
    • VUE_APP_SENTRY_KEY: Private key used by Sentry for authenticating the project.
      • Not Required
    • VUE_APP_SENTRY_PROJECT_ID: Project ID used by Sentry.
      • Not Required
    • VUE_APP_SENTRY_ENABLED: If you want to enable error tracking with Sentry.
      • Not Required - Default value: false
    • VUE_APP_GOOGLE_ANALYTICS_ID: Tracking and measurement ID used by Google Analytics.
      • Not Required
    • VUE_APP_GOOGLE_ANALYTICS_ENABLED: If you want to enable traffic data measurement with Google Analytics.
      • Not Required - Default value: false
    • VUE_APP_FACEBOOK_APP_ID: Facebook application ID if you want to enable Facebook authentication.
      • Not Required
    • VUE_APP_GOOGLE_CLIENT_ID: Google client ID if you want to enable Google authentication.
      • Not Required

<a name="lets-go">🔌 Let's go</a>

To start the web app on development mode, simply run npm start.

To start the web app on production mode, run npm run build and host the dist folder with an HTTP server.

<a name="other-useful-commands">⚙ī¸ Other useful commands</a>

<a name="license">Šī¸ License</a>

This project is licensed under the MIT License.

<a name="contributors">❤ī¸ Contributors</a>

There are no contributor yet... Be the first one by creating a pull request !