Software-as-a-Service (SaaS) is a model of software delivery in which users pay a subscription to get access to centrally hosted software. Nowadays, you can easily build your own SaaS, but you need to have programming skills. There are a lot of open-source web frameworks that allow you to quickly create a web service. You can serve SaaS on rented hardware in the cloud. You can start your own SaaS at 10-50$ per month of total costs (but you need to have programming skills!).

The main costs:

  • You will need to buy a domain for your website, which costs about 12$ per year.
  • You will need to have a server machine. You can rent it from cloud providers with prices starting at 5$/month (sometimes even lower). Yes, you can run the whole app on a single machine.

There is even a community of people building online businesses, called Indie Hackers. You can get a lot of help from community. You can check there examples of SaaS applications that are self-funded: link to the list.

In this series of posts, I would like to show you how to start your SaaS with Django and React from scratch. By the end of the tutorial, you will have Django + React boilerplate (a template code that can be reused to create a new SaaS). This boilerplate will be much different from existing boilerplates:

  • You will write it from scratch. You will be familiar with every part of the boilerplate code.
  • It will have only parts that are needed for you. If you don’t need a feature you won’t implement it, simple.
  • The boilerplate code will be open-source on the MIT license. You may reuse it as many times as you want for free.
  • A complete guide on how to deploy the SaaS boilerplate to a single server machine (and how to update the code) will be available.

By the end of this post you shoud …

  • You should prepare local development environment (install required libraries).
  • You should setup the text editor or Integrated Development Environment.
  • You should set a code repository for the project.
  • You will initialize Django and React projects.

Start SaaS with Django and React

Prepare your development machine

You need to setup your machine (laptop or desktop) for development. You will need to have 3 things:

  • Python available on your machine (needed for Django).
  • Node.js needed for React.
  • Git for code repository.

I’m using Ubuntu (16.04) for development. You can use any other operating system (Windows, MacOS). I would recommend Ubuntu 18.04 or Windows Subsystem for Linux on Windows OS.

Text Editor

I’m using Visual Code for text editing. It is free and open-source Integrated Development Environment (IDE). You can use other IDE/editors, for example PyCharm.

Initialize the code repository

I’m using GitHub for code repository. It is free for public and private repositories. The alternative to GitHub can be: BitBucket or GitLab (both with free plans).

Let’s go into and start a new repository!

Create code repository in GitHub for your project

You can see that I’ve selected the Public repository on the MIT license. The code I’m writing will be open to anyone on the internet. If you want to hide your code from others you should select Private here and don’t select the license.

The next important thing is .gitignore file. Notice that I’m adding Python template. It is important to select it because it will prevent git from tracking unimportant or unsafe files (like .env files). What about the JavaScript files? There will be an additional .gitignore in the frontend code automatically generated when we start React application.

My repository is available at When you go to the repository you should see repository like in the image below.

Create code repository in GitHub for your project

Create Django project

Before starting Django project let’s get the empty repository from the Github:

git clone

Now, please navigate to this directory and create backend directory.

cd django-react-boilerplate
mkdir backend

Your project directory should look like:

├── backend

Let’s create virtual environment in the backend directory.

cd backend
virtualenv venv
# activate virtual env
source venv/bin/activate

We are using virtual environment to not mess with packages from other projects. Let’s check the python version:

python --version

Python 3.6.11

We will install Django package:

pip install django

Please take a look at Django version. We will need it to save in requirements.txt file. Please add requirements.txt in backend directory with your Django version. In my case it was:

# content of backend/requirements.txt

We are now ready to initialize the Django project:

# run in backend dir
django-admin startproject server

You can run initialized server with command:

# navigate to server dir
cd server 
# run development server
python runserver

Note: You can also run development server with ./ runserver command.

Please enter in your favourite browser and you should see a default Django welcome site.

Default Django welcome site

Congratulations you have successfully initialized the backend! We are in the half-way of this post, let’s initialize the frontend project.

To stop the Django development server use keyboard: CONTROL+C.

Create React App

Please navigate to the project root directory (where the backend directory is) and run commands:

npx create-react-app frontend
cd frontend
npm start

The above commands should initialize the React frontend code and run the development server at address: http://localhost:3000/. You should see in the browser a spinning atom:

Default React welcome site

Congratulations you have successfully initialized the frontend! :tada:


Please notice that default Django port for development is 8000 and for React application it is 3000.

Commit code to the repository

Your project structure should look like this:

├── backend
│   ├── server
│   └── venv
├── frontend
│   ├── node_modules
│   ├── package.json
│   ├── public
│   ├──
│   ├── src
│   └── yarn.lock

There are two directories:

  • backend for storing the Django server code.
  • frontend for React user interface code.

Let’s add them into git:

git add frontend
git add backend

To see what files will be added run git status:

> git status

On branch main
Your branch is up-to-date with 'origin/main'.
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

	new file:   backend/server/
	new file:   backend/server/server/
	new file:   backend/server/server/
	new file:   backend/server/server/
	new file:   backend/server/server/
	new file:   backend/server/server/
	new file:   frontend/.gitignore
	new file:   frontend/
	new file:   frontend/package.json
	new file:   frontend/public/favicon.ico
	new file:   frontend/public/index.html
	new file:   frontend/public/logo192.png
	new file:   frontend/public/logo512.png
	new file:   frontend/public/manifest.json
	new file:   frontend/public/robots.txt
	new file:   frontend/src/App.css
	new file:   frontend/src/App.js
	new file:   frontend/src/App.test.js
	new file:   frontend/src/index.css
	new file:   frontend/src/index.js
	new file:   frontend/src/logo.svg
	new file:   frontend/src/reportWebVitals.js
	new file:   frontend/src/setupTests.js
	new file:   frontend/yarn.lock

We need to commit and push changes to the repository server:

git commit -am "initalize backend and frontend"
git push

You can check the repository in the browser (in my case it will be, all changes should be there.


  • The hardest part is to start and we already started!
  • We have backend and frontend applications initialized. We are able to run development servers for both apps.
  • The project’s code is managed in the code repository.

What’s next?

In the next post, we will write the user interface for authentication. It will be only view of UI without taking any actions (without connecting to the backend). We will prepare:

  • create (signup) view for a new user,
  • login view,
  • show home and dashboard views.

Next article: React Routing and Components for Signup and Login

Let's stay in touch!

Would you like to be notified about new posts? Please fill this form.

Have you found a bug in the code? Please add a GitHub issue.

Do you have problems with running the code or setup and need help? Please add a StackOverflow question with django-react tag.

Boilerplate Tutorial Articles:
1. Starting SaaS with Django and React (↩ you are here!)
2. React Routing and Components for Signup and Login
3. Token Based Authentication with Django Rest Framework and Djoser
4. React Token Based Authentication to Django REST API Backend
5. React Authenticated Component
6. CRUD in Django Rest Framework and React
7. Docker-Compose for Django and React with Nginx reverse-proxy and Let's encrypt certificate
8. Django Rest Framework Email Verification
9. Django Rest Framework Reset Password
More articles coming soon!

Link to the code repository: saasitive/django-react-boilerplate