Skip to content

Commit

Permalink
feat(docs): compelete steps to use docker as dev environment
Browse files Browse the repository at this point in the history
  • Loading branch information
MagneticNeedle committed Jul 6, 2023
1 parent 898324b commit dc7acf5
Showing 1 changed file with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,20 @@ If you already have experience with django/wagtail, understanding the backend wi
----
# Env Setup
- ### Docker
- Make sure You have docker installed and the `cd` to `bfportal` directory
- Create a Python Virtual Environment and activate it
- Install the pre-commit hooks by running `pre-commit install --install-hooks`
- Make sure You have **docker** installed and the `cd` to `bfportal` directory
- Copy the `.env.template` file to `.env`
- Create a [discord application](https://discord.com/developers/applications) for OAuth2 and copy the client id and secret
- Paste the client id and secret in `.env` file to `DISCORD_CLIENT_ID` and `DISCORD_SECRET` respectively
- Then run `docker-compose --profile dev_local up`
- The website should be available at `127.0.0.1:8000`
- If You want to set up everything your self, See the next points


- ### Python
- Refer to [readme.md](/readme.md#how-to-run-locally)
- install pre-commit checks by runnning (**make sure the Virtual Enviroment is activated !!**)
- install pre-commit checks by running (**make sure the Virtual Enviroment is activated !!**)
```
pre-commit install
```
Expand All @@ -47,6 +52,10 @@ If you already have experience with django/wagtail, understanding the backend wi
```
python manage.py tailwind start
```
- ### Postgres
- Make sure postgres is installed and running
- Create DB, USER and Password for the project
- Update the `.env` file accordingly
----
Expand Down Expand Up @@ -81,9 +90,9 @@ bfportal/
- Make sure all the precommit test are passed
- Open a pull request to merge the branch into dev branch
- The changes will be reviewed on dev deployment
- Upon successfull testing dev will be merged into main
- Upon successfully testing dev will be merged into main
# How to discuss with the maintainers
- Join our [discord server](https://bfportal.gg/join).
- Join our [discord server](https://discord.bfportal.gg/).
- Open a new issue.
- mail us at [email protected]

0 comments on commit dc7acf5

Please sign in to comment.