I was looking for a boilerplate to run a GraphQL Django backend to use with a React or VueJS frontend and couldn't find one that fit my purposes so I wrote this one. The boilerplate uses graphene-django for graphql support and a custom user app has been created and integrated with JWT for authentication. The boilerplate can be used with any database backend Django supports but this boilerplate uses postgres. Everything is set up using docker for easy setup and development.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
- docker (on mac install using
brew cask install docker)
Below is a step by step series of examples that tell you how to get a development env running.
git clone <repository> <project_name>
cd <project_name>
rm -rf .git
git init
git remote add origin <your_project_git_url>
git add .
git commit -m <message>
git push -u origin master
./scripts/start-container # starts a local terminal for local development
./scripts/migrate
./scripts/seed # if you want to seed the database from fixtures
./scripts/start-app
You should now see Starting development server at http://0.0.0.0:8000/
Seed data can be kept in the fixtures directory. It can be stored as YAML or json, although I prefer YAML Example file for users is included. It creates three users. One admin, [email protected], and two other test users. The following commands load and dump data.
# load all fixtures
./scripts/seed
# load a specific fixture
./scripts/manage loaddata ./fixtures/users/user.yaml
# dump an apps data in a fixture
./scripts/manage dumpdata users.user --format=yaml > ./fixtures/users/user.yaml
Example GraphQL tests have been added to the users app. To run those and future tests use the command below.
./scripts/manage test
Dependencies are installed with pipenv. To install a new package simply run the command below. That will install it in your current working container. The ./scripts/start-container script will build the docker image from scratch so you don't have to worry about running pipenv install when you start the container.
pipenv install <package_name>
Some apps come pre-installed in this boilerplate. Here is a list of them and a link to their documentation. You may want to remove these if you don't want their functionality.
- django-extentions - Provides a bunch of useful commands for working in Django. For example, running
./scripts/manage shell_pluswill load a shell with all your models already loaded. - django-import-export - Provides an import and export which can be useful in the admin tool.
- django-simple-history - Provides a way to track changes to models. Useful for debugging and auditing which information has changed and by who. Simply add
history = HistoricalRecords()on to one of your models. It also easily integrates with the admin tool.
- Django - Web Framework
- PostgreSQL - Database
- Docker - Container for postgres
- graphene-django - GraphQL Support
- Kaden Barlow
This project is licensed under the MIT License - see the LICENSE.md file for details