Simple Django configuration to serve a single-page app
Clone or download
Latest commit dbdfa6d Apr 3, 2018


django-spa Documentation Status Updates GitHub license

Django package to serve a single-page app (SPA).

The following settings that make serving SPAs easier are handled in django-spa:

  • index.html served when / requested
  • all /static/… files served on /… as well
  • Django's urls still work (Django admin, templates, Django REST framework APIs)
  • everything else goes to / for frontend routing (e.g. react-router)


For an example of using django-spa to serve a create-react-app frontend that consumes a Django REST framework API, check out generator-django-rest.

First set up WhiteNoise, as django-spa overrides some of its functionality.

Add django-spa to your requirements.txt and pip install -r requirements.txt:


Update with the django-spa middleware:


Use the django-spa static file storage:


You should be good to go!


Used some parts of the solution suggested in this WhiteNoise issue for serving index.html on /. This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.