{"id":21330875,"url":"https://github.com/kadenbarlow/django-postgres-graphql-boilerplate","last_synced_at":"2025-07-12T09:31:03.812Z","repository":{"id":39841721,"uuid":"165421484","full_name":"kadenbarlow/django-postgres-graphql-boilerplate","owner":"kadenbarlow","description":"A Boilerplate for a Django-GraphQL Project","archived":false,"fork":false,"pushed_at":"2022-05-25T02:36:32.000Z","size":64,"stargazers_count":28,"open_issues_count":4,"forks_count":6,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-25T01:12:53.492Z","etag":null,"topics":["boilerplate","django","docker","graphql-support","postgres"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kadenbarlow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-12T18:26:27.000Z","updated_at":"2024-10-06T23:23:19.000Z","dependencies_parsed_at":"2022-09-15T01:02:10.450Z","dependency_job_id":null,"html_url":"https://github.com/kadenbarlow/django-postgres-graphql-boilerplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kadenbarlow/django-postgres-graphql-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadenbarlow%2Fdjango-postgres-graphql-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadenbarlow%2Fdjango-postgres-graphql-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadenbarlow%2Fdjango-postgres-graphql-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadenbarlow%2Fdjango-postgres-graphql-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kadenbarlow","download_url":"https://codeload.github.com/kadenbarlow/django-postgres-graphql-boilerplate/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadenbarlow%2Fdjango-postgres-graphql-boilerplate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264972147,"owners_count":23691375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","django","docker","graphql-support","postgres"],"created_at":"2024-11-21T22:25:20.450Z","updated_at":"2025-07-12T09:31:03.531Z","avatar_url":"https://github.com/kadenbarlow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Django - Postgres - GraphQL Boilerplate\n\nI 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.\nThe 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.\n\n## Getting Started\n\nThese 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.\n\n### Prerequisites\n\n- docker (on mac install using `brew cask install docker`)\n\n### Installing\n\nBelow is a step by step series of examples that tell you how to get a development env running.\n\n```\ngit clone \u003crepository\u003e \u003cproject_name\u003e\ncd \u003cproject_name\u003e\nrm -rf .git\ngit init\ngit remote add origin \u003cyour_project_git_url\u003e\ngit add .\ngit commit -m \u003cmessage\u003e\ngit push -u origin master\n\n./scripts/start-container # starts a local terminal for local development\n./scripts/migrate\n./scripts/seed # if you want to seed the database from fixtures\n./scripts/start-app\n```\n\nYou should now see `Starting development server at http://0.0.0.0:8000/`\n\n## Seed Database\n\nSeed data can be kept in the fixtures directory. It can be stored as YAML or json, although I prefer YAML\nExample file for users is included. It creates three users. One admin, admin@app.com, and two other test users. The following commands load and dump data.\n\n```\n# load all fixtures\n./scripts/seed\n\n# load a specific fixture\n./scripts/manage loaddata ./fixtures/users/user.yaml\n\n# dump an apps data in a fixture\n./scripts/manage dumpdata users.user --format=yaml \u003e ./fixtures/users/user.yaml\n```\n\n## Running the tests\n\nExample GraphQL tests have been added to the users app. To run those and future tests use the command below.\n\n```\n./scripts/manage test\n```\n\n## Installing New Packages\n\nDependencies 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.\n\n```\npipenv install \u003cpackage_name\u003e\n```\n\n## Useful Apps and their Documentation\n\nSome 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.\n\n- [django-extentions](https://django-extensions.readthedocs.io/en/latest/installation_instructions.html) - Provides a bunch of useful commands for working in Django. For example, running `./scripts/manage shell_plus` will load a shell with all your models already loaded.\n- [django-import-export](https://django-import-export.readthedocs.io/en/stable/) - Provides an import and export which can be useful in the admin tool.\n- [django-simple-history](https://django-simple-history.readthedocs.io/en/latest/) - 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.\n\n\n## Built With\n\n* [Django](https://www.djangoproject.com/) - Web Framework\n* [PostgreSQL](https://www.postgresql.org/) - Database\n* [Docker](https://www.docker.com/) - Container for postgres\n* [graphene-django](https://github.com/graphql-python/graphene-django) - GraphQL Support\n\n## Authors\n\n* **Kaden Barlow**\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadenbarlow%2Fdjango-postgres-graphql-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkadenbarlow%2Fdjango-postgres-graphql-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadenbarlow%2Fdjango-postgres-graphql-boilerplate/lists"}