Heroku Gunicorn NGINX boilerplate

This boilerplate provides an example of a React / Django (Client / Server) based application hosted on Heroku with a Gunicorn NGINX setup.

Relevant files

.buildpacks

The .buildpacks file is used to use multiple Heroku buildpacks for different sub directories.

Find more about that file in the Buildpack documentation.

app.json

The app.json file is there for specifiying all the dependencies of your Heroku application. These can be addon-specific ones (Postgres e.g.), environment variables which needs to be set or hardware specification for you dynamic created environments via Review Apps.

Find more about that file in the Heroku docs.

Procfile

Via this file you instruct Heroku which processes should be run on the Dynos (containers). Also you can set there a command which will be execute on each release to run e.g. SQL migrations.

Find more about that file in the Heroku docs.

nginx.conf.erb

Via this file we instruct NGINX to proxy all incoming requests which start with /api to the Gunicorn backend server. Also we serve the assets either via the directory where the client frontend is located or if the file does not exist via the Django staticfiles directory to provide Django Admin functionality.

Find more about that file in the Buildpack docs.

Other boilerplates for React / Django

• Heroku Docker Gunicorn
• Heroku Gunicorn