lopamudra2000/bunk-manager-mern

Building React Web App to manage attendance in a university.

BUNK MANAGER

Tech-Stack

Other Libraries

How To Run the Project

There are two ways to install the project:

1. Conventional Way

1. Open Project Folder

2. To install all dependencies open Command Prompt and run

npm i

3. To install all client dependencies open client folder and again run

npm i

4. To run the server-

npm run server

5. To run the client-

npm run client

6. To run both server and client- Recommended

npm run dev

2. Using Docker

• Install Docker, from the given link.

• Once Docker is installed, use the following two commands to run the app in the root dicrectory:

  • docker-compose build , This command will build the project
  • COMPOSE_HTTP_TIMEOUT=200 docker-compose up, This command will run the container.

• You can open the project on localhost:3000 on the machine.

Note: If you are using docker-desktop on Windows Or WSL2 i.e Windows Subsystem For Linux, you can use the GUI Options to run the containers

To start contributing, follow the below guidelines and Code of Conduct:

1. Fork this repository.

2. Clone your forked copy of the project.

git clone --depth 1 https://github.com/<your_user_name>/bunk-manager-mern.git

3. Navigate to the project directory 📁 .

cd bunk-manager-mern

4. Add a reference(remote) to the original repository.

git remote add upstream https://github.com/ADRE9/bunk-manager-mern.git

5. Check the remotes for this repository.

git remote -v

6. Always take a pull from the upstream repository to your master branch to keep it at par with the main project(updated repository).

git pull upstream master

7. Create a new branch.

git checkout -b <your_branch_name>

8. Perform your desired changes to the code base.

9. Track your changes:heavy_check_mark: .

git add .

10. Commit your changes .

git commit -m "Relevant message"

11. Push the committed changes in your feature branch to your remote repo.

git push -u origin <your_branch_name>

12. To create a pull request, click on compare and pull requests. Please ensure you compare your feature branch to the desired branch of the repo you are supposed to make a PR to.

13. Add appropriate title and description to your pull request explaining your changes and efforts done.

14. Click on Create Pull Request.

Landing Page prototype

Website: https://www.figma.com/file/yv7szBhuylAeMShJoNY7oF/BUNK-MANAGER?node-id=0%3A1

App: https://www.figma.com/file/sd8f5twPt3iCrMGPX2izFa/BunkManagerApp?node-id=0%3A1

Login Page prototype

https://www.figma.com/file/BBOPzTwcLPLc8B3HckxQqH/Login?node-id=0%3A1

Sign Up Page prototype

https://www.figma.com/file/Bag7fzf5w2NlrROsILCi91/SignUp?node-id=0%3A1

About Us Page Prototype

https://www.figma.com/file/az4dLzkdf2ODaDaFK7vdb9/AboutUsWeb?node-id=0%3A1

Today Page prototype

https://www.figma.com/file/ztcjLs33fX0k7dAY3SkCW0/Today?node-id=0%3A1

Subject Details Page Prototype

https://www.figma.com/file/8JiFfRS746ot9w7Uh7yq3O/Untitled?node-id=0%3A1

Bunk Manager Mern is a part of these Open Source programs

Contributor:

Credit goes to these people: ✨

Live version also available HERE