Theo NgaBlogGitHub

Django and React Gatsby using GraphQL API to create a blog

17 March, 2020 - 7 min read

Learn how to structure your django and react js project. If you have problems integrating django and react gatsby js then you've come to the right place. This simple yet comprehensive tutorial with teach you to build web apps with django and react js from scratch.

Django Graphene and React

Django is a python web framework that follows the MVT architecture. Since it's inception, django popularity has being rising ever since. Many big companies are using django to power their backend including NASA (Space Organisation). Developers love django framework for many reasons including the fact that it's a python framework. We'll be using django and react js in this tutorial to create a simple blog web application. What you will learn:

  • How to build a django GraphQL API
  • How to configure your django project to work with react js.

GraphQL and React Gatsbyjs

React js a frontend library build by Facebook to simplify frontend development. React is used by big companies such as twitter, Instagram, github, bitbucket and amazon. Gatsby is a react based framework. It is packed with GraphQL features that are not in react itself and we shall be using it to speed our development. What you will learn:

  • How to define your GraphQL API in react Gatsby js.
  • How to make react Gatsby communicate with Django API.

Let's get started and develop our website.

Create a virtual environment and install django

A virtual environment helps us to separate our system files from the mess we might cause when developing our django project

mkdir blogging && cd blogging
pipenv install django==3.0.3

Note: Sometimes you will an UnsupportedPythonVersion error - Django requires Python>=2.7.17. To solve this problem. Open your Pipfile and change the python version from 2.7 to 3.7 or 3.6 depending which one is globally installed on your computer. and after changing the python version, run the following command:

pipenv --rm
pipenv install
pipenv shell 

Now we have installed our django. Let's create the actual project.

Note: Don't forget to activate your virtual environment by running the pipenv shell command.

Create Django Project using Pipenv

After installing Django we can go ahead and create the django-react project.

django-admin startproject django_react
cd django_react

Before we continue let's install all the necessary python requirements we'll need to integrate django and react.

pipenv install graphene-django
pipenv install django-graphql-jwt
pipenv install django-cors-headers
pipenv install autopep8 --dev

Create Django application

Everything is set to go now, let's create our first django app and define our blog models

python startapp blog

Django blog models

Create your model classes in the blog file.

from django.db import models
from django.utils.translation import gettext_lazy as _ 
from django.utils.text import slugify
from django.urls import reverse
# Create your models here.
class Post(models.Model):
     title = models.CharField(_("Post title"), max_length=100)
     summary = models.CharField(_("Summary"), max_length=255)
     keywords = models.CharField(_("SEO Keywords"), max_length=255)
     body = models.TextField(_("Post body"))
     published = models.DateTimeField(auto_now=True)
     slug = models.SlugField(_("Slug"), max_length=255, default='', blank=True, unique=True)    

    class Meta:
        verbose_name = _("Post")
        verbose_name_plural = _("Posts")

    def __str__(self):

    def get_absolute_url(self):
        return reverse("post_detail", kwargs={"slug": self.slug})

    def save(self, *args, **kwargs):
        self.slug = slugify(self.title)
        super().save(*args, **kwargs)

Now that our main blog application is created and we've also defined our models. Let's register the blog application and define our Graphene settings in the file


     #Third part applications
     #Custom applications

     #To be created file inside the django_react project folder
    'SCHEMA': 'django_react.schema.schema',
    # JWT Authentication

After adding your application,register your models inside the django_react/blog/

from django.contrib import admin
from blog.models import Post

Your Post model is registered and you can view from the django dashboard. Now add a django super user that can access and create the Post in the dashboard.

python createsuperuser

Navigate to your django admin,if you're running the default configurations it's on

You can now create your sample posts.

GraphQL Schema files

Let's create the necessary GraphQL files, We'll define our GraphQL schema in the app level and register it to the project level file.

touch django_react/
touch blog/

Before we start defining the graphql schema, let's migrate our database

python makemigrations
python migrate

With our database intact, django graphene is ready to take define our queries and mutations. There two things needed to make queries in:

  • schema with defined object types.
  • View that takes input and returns output.

Objects are presented as graph structure than a hierarchical structure. Graphene needs to understand all type of object which is expected in the graph. For more information visit the graphene official website.

import graphene
from graphene_django.types import DjangoObjectType
from blog.models import Post

class PostType(DjangoObjectType):
    class Meta:
        model = Post

class Query(object):
    all_posts = graphene.List(PostType)
    get_post = graphene.Field(PostType, slug=graphene.String())

    def resolve_all_posts(self, info, **kwargs):
        return Post.objects.all()
    def resolve_get_post(self, info, **kwargs):
        slug = kwargs.get('slug')
        if slug is not None:
            return Post.objects.get(slug=slug)
        return None

The query calss is a mixin inheriting from object. Lets now create a project level query class that will combine all the application level query classes.

import graphene
import blog.schema

class Query(blog.schema.Query, graphene.ObjectType):

schema = graphene.Schema(query=Query)

Everything in our Graphene schema is set to function well.

Lets test our Graphene API on a URL endpoint

Since we want to test our queries on the GraphQL playground, we have to configure the urls. GraphQL allows you to have only one single URL from which to access your API and all the requests to that URL is handled in Graphene GraphQLView.

from django.contrib import admin
from django.urls import path
from graphene_django.views import GraphQLView
from django.views.decorators.csrf import csrf_exempt

urlpatterns = [
    path("", csrf_exempt(GraphQLView.as_view(graphiql=True))),

If you run the server and open the browser you should see the Graphene Playground open.

Now that we've installed django and created our Graphene API endpoint, let's create the React Gatsby frontend side.

Install React Gatsby Js

Gatsby is an open source framework based on React js. It uses the latest technologies such as GraphQL and Webpack to speed up the site loading time. Every Gatsby website is a Progressive web app (PWA). If you're new to React but feel comfortable learning a few concepts along the way, i highly recommend you try Gatsby js.

Benefits of Gatsbyjs

  • Plugins - Just like WordPress plugins, Gatsby plugins extends the functionality of Gatsby.
  • Ready to use starters - Gatsby community of developers have build a wide range of web apps that you can choose a starter or theme from.
  • Site speed - Gatsby uses pre-build web pages thus improving server response time.

Open your terminal and create the Gatsby project inside the django_react root folder.

npm install -g gatsby-cli
gatsby new frontend
cd frontend
gatsby develop

Now make sure you're inside the newly created Gatsby project. Let's install the necessary Gatsby plugins needed to pull our Django Graphene API.

npm install --save gatsby-source-graphql

Source GraphQL Plugin Configurations.

plugins: [
    // Add the configurations
      resolve: "gatsby-source-graphql",
      options: {
        // Arbitrary name for the remote schema Query type
        typeName: "django",
        // Field under which the remote schema will be accessible. You'll use this in your Gatsby query
        fieldName: "DJANGO",
        // Url or Django Graphene Endpoint
        url: "",

Restart your frontend server and go to graphQL server, in my case it's running on http://localhost:8001/___graphql.


import React from "react"
import { graphql, Link } from "gatsby"
import Layout from "../components/layout"

export default ({ data }) => (

    {, i) => (
      <Link key={i} to={blog.slug}>

export const query = graphql`
  query {
    DJANGO {
      allPosts {

Open your frontend server on the browser, you should the post you added in your django admin.

© 2020, Built with