Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Simple Django configuration to serve a single-page app

Project description

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.

As part of setting up django-spa, you also need to set up WhiteNoise, which we’ll summarise here.

First, add django-spa to your requirements.txt and pip install -r requirements.txt (or pipenv install django-spa). Whitenoise is installed as a dependency, so no need to specify it extra.

Update with the Whitenoise & django-spa middleware:


Disable runserver’s static file serving by adding runserver_nostatic to the top of your INSTALLED_APPS list:

    # ...

Set 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.




0.3.0 (2019-12-15)

  • add example project
  • support Django 3.0

0.2.0 (2017-09-01)

  • Fix #3

0.1.1 (2017-04-08)

  • Metadata fixes.

0.1.0 (2017-04-08)

  • First release on PyPI.
  • Initial django-spa middleware.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-spa, version 0.3.5
Filename, size File type Python version Upload date Hashes
Filename, size django_spa-0.3.5-py2.py3-none-any.whl (6.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-spa-0.3.5.tar.gz (14.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page