Cryptids board game

This project was completed by:

• Mitchell Neilson (2585497)

• Anand Patel (2561034)

• Luke Renton (2540440)

• Martin Shilenge (2557606)

For proof of Scrum Methodology as well as Additional Artifacts please check the following link:

Notion External Documentation

Or directly

https://carnation-surf-f04.notion.site/Submission-Links-b49539a8257741539160af9422e20d0f?pvs=4

For documentation on downloading and running the application locally, please read further below.

Table of Contents

1. For players

   1.1 Description

   1.2 Gameplay Overview

2. For developers

   2.1 File and Code Structure

   2.2 GitHub Branch Naming

   2.3 Project Setup

   2.4 Project Local Testing

   2.5 Deploying to the Server

   2.6 Versions

For Players

Description

CryptidsGame is a digital adaptation of the popular board game, Cryptids. This online version allows players to experience the thrill of hunting for elusive creatures from the comfort of their own homes. Engage in strategic deduction and exploration with friends, as you each strive to be the first to uncover the hidden cryptid's location. Whether you're a seasoned player or new to the game, CryptidsGame offers a captivating and interactive gameplay experience.

Gameplay Overview

In CryptidsGame, each player takes on the role of a cryptozoologist, racing to locate a mysterious creature known as the cryptid. The game revolves around collecting and analyzing clues to narrow down the possible locations of the cryptid. Players use logic and deduction to interpret these clues and make strategic moves on the map. The first player to correctly identify the cryptid's location wins the game.

Key Actions

1. Explore: Move your token to different locations on the map to gather clues.
2. Deduce: Use the clues you've collected to rule out impossible locations.
3. Challenge: If you think you know where the cryptid is hiding, issue a challenge and see if you're correct!

For more information you can check out our tutorial after logging in or creating an account at https://cryptidsgame-app.azurewebsites.net/

For developers

File and Code Structure

General

Comments

1. Comments should be clear.
2. Each file should contain a multi-line comment at the beginning of the file indicating the type of file (component, service, model, etc.).
3. Follow the following comment outline:

// -- ToDo: ____	Outline something that still needs to be completed in the file code
/* Function …. */	Multi-line comment above function definitions to outline what the function does. Should like similar to multi-line comment @ beginning of file
// -- xyz	1-liner comment to outline a patch of code below it

Frontend

File Structure

• The code should be structured in a nested folder-file system. Files will be in camel-case naming convention.

The application will have the following folders:

1. Components

   • Contains React component .js files

2. Styles

   • Contains .css files for each component

3. Services

   • Contains .js files that specifically access APIs or produce functional code that does not interfere with a component directly

4. Models

   • Contains .js files that are data models for required objects

5. Pages

   • React component .js files that are specifically pages

GitHub Branch Naming

• Kebab case when naming

  Format:

  <main-idea>/<description-of-idea> 
  

  examples:

  bug/fixing-login-failed
  
  feature/adding-admin-capabilities
  
  page/tutorial
  

Project Setup

We have added a bash file to automate this process, but will keep the documentation of doing it manually here for future reference. For easier project setup you can use the bash script as follows:

1. Clone the repository from GitHub

git clone https://github.com/LukeRenton/CryptidsGame

2. Navigate to CryptidsGame/

cd CryptidsGame/

1. Give the setup script executable priveledges (once off)

chmod +x setup.sh

4. Run the script

./setup.sh

There you have it! Now if you need to pull any changes you can just run the setup.sh script (in the root directory .../CryptidsGame/) and it will do everything for you!

Alternatively you can do it manually:

1. Clone the repository from GitHub

git clone https://github.com/LukeRenton/CryptidsGame

2. Navigate to CryptidsGame/

cd CryptidsGame/

3. Set up dependencies for local testing, for client

cd client/
npm install

4. For server (assuming you are in the root directory)

cd server/
npm install express

5. Your project is all set up!

Testing the project locally

NOTE: We assume you are in the root directory .../CryptidsGame/

NOTE: You also have to run this each time you make a change and want to see the change reflect locally

We have added a bash file to automate this process, but will keep the documentation of doing it manually here for future reference. For easier project setup you can use the bash script as follows:

1. Give the test script executable priveledges (once off)

chmod +x test.sh

2. Run the test script

./test.sh

3. Check out the project:

Open your browser on http://localhost:5000/ and there it is!

Alternatively you can do it manually:

1. Build your React files:

cd client/
npm run build
# (ensure you return to the root directory for step 2)
cd ..

2. Run the application

npm start

3. Check out the project:

Open your browser on http://localhost:5000/ and there it is!

Deploying to the Server

NOTE: We assume you are in the root directory .../CryptidsGame/

We have added a bash file to automate this process, but will keep the documentation of doing it manually here for future reference. For easier project setup you can use the bash script as follows:

1. Give the deployment script executable priveledges (once off)

chmod +x deploy.sh

2. Run the test script

./deploy.sh

NOTE: During this process you will be prompted to enter your commit message, once you have written your commit message, press enter and all your work is done

3. Merge changes (if not on master branch)

1. Go to GitHub Repository
2. Navigate to your selected branch
3. Select "Make a pull request"
4. Ask someone to review your pull request and confirm it
5. Merge the pull request
6. Check out your changes after it has deployed!

The website is at cryptidsgame-app.azurewebsites.net

Alternatively you can do it manually:

cd client/
npm run build
# (ensure you return to the root directory for step 2)
cd ..

2. Push your changes

git add . && git commit -m "your commit message" && git push

3. Merge changes (if not on master branch)

1. Go to GitHub Repository
2. Navigate to your selected branch
3. Select "Make a pull request"
4. Ask someone to review your pull request and confirm it
5. Merge the pull request
6. Check out your changes after it has deployed!

The website is at cryptidsgame-app.azurewebsites.net

Versions

• Node: 18.17.0
• Bootstrap: v5
• All other versions are stored in the package-lock.json and package.json files, but the setup.sh script handles the installment of these packages.