jastr945/latrine

Web app for finding hygiene resources in Portland, OR

latrine

Web app for finding hygiene resources in Portland, OR

Setup

Instructions for the Team

1. Fork and clone this project.

For Django:

2. Django requires Python to run. Download Python3 at https://www.python.org/downloads/ or with your operating system's package manager.
3. You may need to install pip (Python package manager) if you don't have it already. Follow pip installation.
4. Install virtualenv with pip (pip is already installed if you're using the latest version of Python). virtualenv is a tool to create isolated Python environments.

   $ [sudo] pip install virtualenv

5. Create and activate your virtual environment.

   $ virtualenv env --no-site-packages
   $ source env/bin/activate

6. After you’ve created and activated a virtual environment, Navigate to the Django project directory latrine_django. Install Django and other dependences:

   $ [sudo] pip install -r requirements.txt

7. Apply migrations:

   $ python manage.py makemigrations
   $ python manage.py migrate

8. Apply fixtures to populate the database with sample data:

   $ python manage.py loaddata fixturefile.json

9. Populate the database with the RefugeRestrooms public data:

   $ python manage.py get_restrooms

10. To have access to the Django admin site, run:

    $ python manage.py createsuperuser

Follow the prompts to set up your login and password. 11. To start the development server, run: sh $ python manage.py runserver 12. Open http://localhost:8000 in your browser to view the list of available endpoints.

For React:

The React app will live in the /frontend folder and talk to Django over an API.

1. You’ll need to have Node.js on your local development machine. The Node.js package comes with npm, the package manager for JavaScript.
2. cd into the /frontend directory and install the existing setup:

   $ cd ./frontend
   $ npm install

3. To start the development server, run:

   $ npm start

4. Open http://localhost:3000 in your browser to view the app.

Deploy

Run Tests

For Django

Cd into /latrine_django and run:

$ python manage.py test

Contribute!

Check out CONTRIBUTING.md for details.