This is the current live version of coderdojochi.org but no new development will be done on it. Version 2 is being developed at CoderDojoChi/c2.

We, the community and staff, have been building a custom Django application to handle out many parts of our organization.

1. Fork and clone this repository locally.

2. Download and install Docker for Mac or Windows*.

3. Navigate into the project directory via terminal and run docker-compose build.

4. Once complete, run docker-compose up -d.

5. Load up your browser and go to localhost

6. To view logs, you can run docker logs -f cdc-app

7. When you are done, you can stop the project via docker-compose down

Note: Docker for Mac requires OSX Yosemite 10.10.3 or above. Docker for Windows requires Microsoft Windows 10 Professional or Enterprise 64-bit. For previous versions download Docker Toolbox.

username: admin@admin.com password: admin

username: guardian@guardian.com password: guardian

After the initial project setup, you will only need to run docker-compose build and docker-compose up -d. You can speed the set up by running the command together like so docker-compose build && docker-compose up -d.

To setup the main respository as upstream, you can add a new remote called upstream.

git remote add upstream https://github.com/coderdojochi/coderdojochi

To grab the latest code from the main repo (named upstream), run the following.

git fetch upstream --prune
git checkout develop
git merge upstream/develop develop

Create a new branch based off of upstream's develop branch.

git fetch upsteam --prune
git checkout -b feature/a-good-name upsteam/develop
git push -u origin feature/a-good-name

Pull requests are always welcome. Make sure your pull request does one task only. That is, if it's fixing a bug, the pull request fixes only that bug. If you're adding a feature, make sure the pull request adds that one feature, not multiple at once.

Follow the "Creating a new branch" step above. Be sure to always push to your origin remote, not upstream.

When running any Django commands, you'll need to run them within the Docker container.

docker exec -it cdc-app  --rm app python manage.py <command>