awesome-django/README.md

# Awesome Django

> A curated list of awesome things related to Django

## Table of Contents

* [Table of Contents](#table-of-contents)
* [Resources](#resources)
  * [Official Resources](#official-resources)
  * [General Tutorials](#general-tutorials)
  * [External Resources](#external-resources)
  * [Starter Projects](#starter-projects)
  * [Example Apps: Beginner](#example-apps-beginner)
  * [Example Apps: Advanced](#example-app-advanced)
* [Django REST Framework](#django-rest-framework)
  * [Resources](#drf-resources)
  * [General Tutorials](#drf-tutorials)
  * [DRF and React Tutorials](#drf-and-react-tutorials)
  * [Starter Projects](#drf-starter-projects)
  * [Example Apps](#drf-example-apps)
* [Third-Party Packages](#third-party-packages)
* [Books](#books)
* [Videos](#videos)

## Resources

### Official Resources

* [Django Official Website](https://www.djangoproject.com/)
* [Django Documentation](https://docs.djangoproject.com/en/dev/)
* [Django Polls Tutorial](https://docs.djangoproject.com/en/dev/intro/tutorial01/)
* [Django Source Code](https://github.com/django/django)

### General Tutorials

* [Django for Beginners](https://djangoforbeginners.com/) - Build 3 apps from scratch: Hello World, Pages, and Message Board
* [Django Girls Tutorial](https://tutorial.djangogirls.org/en/) - Use FBVs to build a blog app
* [Mozilla Tutorial](https://developer.mozilla.org/en-US/docs/Learn/Server-side/Django) - Create a lending library app
* [A Complete Beginner's Guide to Django](https://simpleisbetterthancomplex.com/series/beginners-guide/1.11/) - In-depth and excellent walkthrough of a new Django app

### External Resources

* [Classy Class-Based Views](http://ccbv.co.uk/) - Detailed descriptions for each generic class-based view.
* [Django Packages](https://djangopackages.org/) - Comprehensive directory of reusable Django apps and tools.
* [William Vincent's Website](https://wsvincent.com) - Up-to-date tutorials on Django and Django REST Framework.
* [Simple is Better than Complex](https://simpleisbetterthancomplex.com/) - Regularly updated website with many tutorials and tips on Django.
* [Full Stack Python's Django Page](https://www.fullstackpython.com/django.html) - Explanation of Django philosophy and links to other resources and tutorials.

### Starter Projects

* [cookiecutter-django](https://github.com/pydanny/cookiecutter-django) - very complete and deployment-ready
* [djangox](https://github.com/wsvincent/djangox) - complete user auth with email/password, pipenv, and more
* [edge](https://github.com/arocks/edge) - user auth and 12-factor recommended security
* [demo-allauth-bootstrap](https://github.com/aellerton/demo-allauth-bootstrap) - example of new project with django-allauth

### Example Apps: Beginner

* [Hello, World app](https://github.com/wsvincent/djangoforbeginners/tree/master/ch2-hello-world-app)
* [Message Board app](https://github.com/wsvincent/djangoforbeginners/tree/master/ch4-message-board-app)
* [Blog app with users and forms](https://github.com/wsvincent/djangoforbeginners/tree/master/ch7-blog-app-with-users)
* [Newspaper app with custom user model, full user auth](https://github.com/wsvincent/djangoforbeginners/tree/master/ch15-comments)
* [Behavior-Driven Development with Aloe](https://github.com/testdrivenio/django-aloe-bdd)

### Example Apps: Advanced

* [Zulip](https://github.com/zulip/zulip) - open-source team chat
* [django-oscar](https://github.com/django-oscar/django-oscar) - e-commerce for Django
* [django-cms](https://github.com/divio/django-cms) - CMS for Django

## Django REST Framework

> The most popular way to build web APIs with Django.

### DRF Resources

* [Official Documentation](http://www.django-rest-framework.org/)
* [DRF Source Code](https://github.com/encode/django-rest-framework)

### DRF Tutorials

* [Official REST Framework - A Beginner's Guide](https://wsvincent.com/official-django-rest-framework-tutorial-beginners-guide/)
* [DRF Blog API](https://wsvincent.com/django-rest-framework-tutorial/)
* [Building APIs with Django and DRF](https://books.agiliq.com/projects/django-api-polls-tutorial/en/latest/)
* [DRF Serializers, Viewsets, and Routers](https://wsvincent.com/django-rest-framework-serializers-viewsets-routers/)
* [DRF Todo API with User Auth](https://wsvincent.com/django-rest-framework-authentication-tutorial/)
* [DRF User Authentication](https://wsvincent.com/django-rest-framework-user-authentication-tutorial/)

### DRF and React Tutorials

* [DRF with React: Todo API](https://wsvincent.com/django-rest-framework-react-tutorial/)
* [DRF with React](https://www.valentinog.com/blog/tutorial-api-django-rest-react/)
* [Making React and Django play well together](https://fractalideas.com/blog/making-react-and-django-play-well-together/)

### DRF Starter Projects

* [DRFx](https://github.com/wsvincent/drfx)

### DRF Example Apps

* [DRF Polls](https://github.com/wsvincent/drf-polls) - API of the official Django polls tutorial
* [DRF Blog](https://github.com/wsvincent/drf-blog-api) - basic Blog API
* [ECGC](https://github.com/flowerncsu/ecgc-2017) - example from DjangoCon 2017 talk [Write an API for Almost Anything](https://www.youtube.com/watch?v=-6tR5TffP0w)

## Third-Party Packages

> For a complete listing of all available packages, see [Django Packages](https://djangopackages.org/)

* [django-allauth](https://github.com/pennersr/django-allauth/) - User registration, social authentication, account management, and more.
* [django-compressor](https://github.com/django-compressor/django-compressor/) - Compress JavaScript/CSS into a single cached file
* [django-crispy-forms](https://github.com/django-crispy-forms/django-crispy-forms/) - DRY Django forms
* [django-debug-toolbar](https://github.com/jazzband/django-debug-toolbar/) - Configurable panels to debug requests/responses
* [django-environ](https://github.com/joke2k/django-environ) - Environment variables
* [django-extensions](https://github.com/django-extensions/django-extensions/) - Custom management extensions, notably `runserver_plus` and `shell_plus`
* [django-filter](https://github.com/carltongibson/django-filter) - Powerful filters based on Django QuerySets
* [django-guardian](https://github.com/django-guardian/django-guardian) - Per object permissions in Django
* [django-hijack](https://github.com/arteria/django-hijack) - Admins can log in and work on behalf of other users without having to know their credentials
* [django-tables2](https://github.com/jieter/django-tables2) - HTML tables with pagination/sorting
* [django-test-plus](https://github.com/revsys/django-test-plus/) - Useful additions to Django's default TestCase
* [pytest-django](https://github.com/pytest-dev/pytest-django) - Use pytest features in Django
* [wagtail](https://github.com/wagtail/wagtail) - Popular Django content management system (CMS)
* [whitenoise](https://github.com/evansd/whitenoise) - Simplified static file serving for Python websites

> Django Rest Framework specific packages

* [django-rest-auth](https://github.com/Tivix/django-rest-auth) - REST API endpoints for authentication and registration
* [django-rest-framework](https://github.com/encode/django-rest-framework) - Web APIs for Django
* [django-rest-framework-jwt](https://github.com/GetBlimp/django-rest-framework-jwt) - JSON web tokens for DRF
* [django-rest-swagger](https://github.com/marcgibbons/django-rest-swagger) - API document generator for Swagger UI

## Books

* [Django for Beginners: Learn web development with Django 2.0](https://djangoforbeginners.com/)
* [Hello Web App 2.0](https://hellowebbooks.com/learn-django/)
* [Django Design Patterns and Best Practices](https://www.amazon.com/dp/1788831349/?tag=wsvincent-20)
* [Building Django 2.0 Web Applications](https://www.amazon.com/dp/B079DW6TRJ/?tag=wsvincent-20)
* [Two Scoops of Django: Best Practices for Django 1.11](https://www.twoscoopspress.com/products/two-scoops-of-django-1-11/)
* [Build Your First Website with Python and Django 1.11](https://www.amazon.com/Build-First-Website-Python-Django/dp/0994616856/?tag=wsvincent-20)
* [Test-Driven Development with Python](https://www.amazon.com/dp/1491958707/?tag=wsvincent-20)
* [Django RESTful Web Services](https://www.amazon.com/dp/1788833929/?tag=wsvincent-20)


## Videos

* [Treehouse](https://teamtreehouse.com/tracks/learn-django)
* [Coding for Entrepreneurs](https://www.codingforentrepreneurs.com/)
* [GoDjango](https://godjango.com/)

---

### License

[![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)](http://creativecommons.org/publicdomain/zero/1.0/)