Third Places Project is a project that will seek to connect Philadelphians to comfortable public spaces, with the focus being on finding places spontaneously.
This project was started as part of Code for Philly's Launchpad 2023 event.
We host weekly meetings both in person and remotely. This is largely where we make decisions and set up collaborative pairing sessions to get large chunks of work done.
The best way to find out about our meetings is joining the #third-places-project channel on the Code for Philly Slack.
Please read the contributing guidelines to find out how you can volunteer.
You will need to have a working understanding of using a Unix-like system via a terminal or shell and the instructions below use Bash commands.
In order to run this app, you will need to have the following libraries installed on your machine:
- Node: Javascript runtime
- npm: Node Package Manager
- Django: python web framework
- Python 3.9+
Note: These installations will not be required locally once we have the project containerized, the container will hand that.
We will be using a .env file to share environment variables with each of the Docker containers and separate our environment variables from our code.
Duplicate the .env.sample file and rename it to .env
The .env file is ignored by git and so any changes will have to be communicated to the team to make sure API keys etc. stay aligned from dev to dev.
To run all servers (React, Django, & PostgreSQL):
# Build the containers from images
docker-compose build
# Run the servers
docker-compose up
# OR for a single command to do both
docker-compose up --buildAccess the following ports from localhost to access their respective services
| Service | Port |
|---|---|
| React | 4321 |
| Django | 8321 |
/api/: Hello world!/users/:GET,POSTusers/users/{id}:GET,PUTspecific user details