Skip to content

rhdevs/rhapp

Repository files navigation

Issues GPL-3.0 License LinkedIn


Logo

The Raffles Hall App

Nobody asked:
RHdevs:

(Coming Soon!) View the App

Table of Contents

  1. The Project
  2. Getting Started
  3. Contributing
  4. License
  5. Contact
  6. Acknowledgements

The Project

This projects is build by RHDevs on December. More Details coming soon! :-)

Logo Logo Logo Logo Logo Logo Logo Logo

Built With

About Us

We are a CCA from Raffles Hall, National University of Singapore. Frustrated by the modernisation efforts by the nature of a gigantuan organisation, we've decided to use our knowledge and skills to ease our day-to-day life in the hostel.

With us, we have 2 main departments; The Developers and The Designers!

Getting Started

To run the application on your local machine, follow the steps below. To view the hosted application, click here instead (Coming Soon!)

Prerequisites

Please ensure that you have the following dependencies installed before carrying on!

  • Python 3 and pip3

    # MacOS Developers
      brew install python
    # Windows
      ## Refer to https://www.python.org/downloads/
    # Debian/Ubuntu
      sudo apt update
      sudo apt-get install python3
  • Flask

  • NodeJS and NPM

    # MacOS Developers
    # Windows
      ## Refer to
    # Debian/Ubuntu
  • PostgreSQL (?)

    # MacOS Developers
    # Windows
      ## Refer to
    # Debian/Ubuntu
  • yarn

      # MacOS Developers
          brew install yarn
      # Windows
          ## Refer to https://classic.yarnpkg.com/en/docs/install/#windows-stable
      # Debian/Ubuntu
          sudo apt update && sudo apt install yarn
  • Python 3 Virtual Env

    ## Unix
    python3 -m venv venv
    virtualenv venv
    . venv/bin/activate
    
    ## Windows
    py -3 -m venv venv
    \Python27\Scripts\virtualenv.exe venv
    venv\Scripts\activate
    

Installation

Running both instances for testing

Run yarn start:all or npm run start:all

Backend-only

  1. Ensure your venv is up (check pre-requisite)
  2. Run export FLASK_APP=testpy.py to set entry file
  3. Run flask run to start flask server
  4. Go to http://127.0.0.1:5000/ to view the server
  5. To share new dependencies, run pip freeze --local > requirements.txt

Frontend-only

  1. Copy and paste .env.template to fill up the env variables and save as frontend/.env
  2. run yarn in /frontend to install dependencies
  3. run yarn start to start front-end
  4. Go to http://localhost:3000/ to view the frontend

Contributing

Our Application is currently not yet ready for open source contributions

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Social Media: LinkedIn | Instagram Project Link: Github Repo | Application (Coming Soon!)

Acknowledgements

Useful Tools and Links

About

Nobody: nothing | RHDevs: Let's build an app

Resources

License

Stars

Watchers

Forks

Packages

No packages published