
_Photo by [David Clode](https://unsplash.com/@davidclode) on
[unsplash.com](https://unsplash.com/photos/a-close-up-of-a-snake-on-a-rock-J_5xvghAvmc)_

This project is a Django Polls application built by following Django's official
tutorial from the ground up, after refactoring an earlier version of the same
app that had been sitting untouched for seven years. It's structured as a set of
reusable apps rather than a single monolithic project.

Along the way it covers setting up a virtual environment and starting a Django
project, defining and activating the polls models, working the interactive
Django shell, registering the app in the admin interface, writing views and
namespaced URLconfs, building out templates, adding a voting form, and
introducing automated tests. The project also wires up static files for local
development and the Django Debug Toolbar for inspecting requests in the browser.
Code quality is enforced with flake8, Black, and djLint, run automatically
through pre-commit hooks.

## Related Resources

- [Creating the official Django Polls app table of contents](/blog/creating-the-official-django-polls-app-table-of-contents):
  the eight-part series documenting this build
- [Django Polls Package](/projects/django-polls-package): this app repackaged as
  a standalone, installable Python package


A Django project following the official Django Polls tutorial from scratch, covering models, the admin interface, views and templates, forms, automated testing, static files, and the Django Debug Toolbar.

projects tag: pre-commit-hooks

Official Django Polls App