UWI Mona Computing Society's Web App

TODO: description

Requirements

• python 3.6
• postgresql

Setup

Linux & macOS

Assuming you are using bash as your shell. After cloning the repo, navigate to the uwi-cs-webapp folder in your terminal.

Windows

Download and install git which includes git bash. Using git bash as your shell, clone the repo, and navigate to the uwi-cs-webapp folder in your terminal.

Once in that folder, follow these steps.

1. Create a virtual environment.

   $ python3 -m venv ./venv
   

2. Activate the virtual environment.

   $ source ./venv/bin/activate
   

3. Install all requirements.

   $ pip3 install -r requirements.txt
   

4. Run the development server.

   $ export FLASK_CONFIG=development
   $ export FLASK_APP=run.py
   $ flask run
   

5. Navigate to 127.0.0.1:5000 in your browser to check if everything is working properly.

Website requirements

https://docs.google.com/document/d/1roVEoeM9OlwazfNmCuOj9uCMbijJqFAYO8rB8X7wwh8/edit?usp=sharing

What we'll be developing?

Contributions

Follow these general guidelines when contributing to the project.

• Fork the repo.
• Clone your forked repo.
• Create a branch with the name of the feature or fix you are implementing.
• Notify group(on whatsapp, just to prevent multiple people doing the same thing) of feature you are working on.
• Add your feature or fixes.
• Commit the code to your forked repo and ofcourse newly created branch.
• When you are done working on your feature or changes and have tested sufficiently, merge your feature/fix branch with your local development branch then create a pull request.
• Your code will be reviewed, feedback may be given.
• Your final code will then be merged into the development branch on the main repo and you will be added as a contributor to the project.

Contributors

• @daytonallen
• @renzy101
• @superrcoop