Skip to main content

Django React Berry

Open-source Full Stack seed project built in React and Django on top of Berry Dashboard

Full-Stack Seed project generated by React App Generator top of Berry Dashboard design. The backend logic is provided by a simple, easy-to-extend DJANGO API Server that manages the Authentication flow (login, registration, logout) using JSON Web Tokens (JWT). The React Design is crafted by CodedThemes on top of MUI Library.

React Berry Dashboard - Full-Stack Starter generated by AppSeed.


Product features​

The product expects a running API backend that exposes an interface for login/logout and register actions. By default, the guest users are redirected to the login page. Once the user is authenticated using an existing account or the new one, all private pages are accessible.


React Berry Dashboard​

  • M-UI based design
  • Modern aesthetics UI design - Designed by CodedThemes
  • React, Redux, Redux-persist

Tests (compatibility matrix using Ubuntu 18 LTS as reference)

NodeJSNPMYARN
v14.0.0✅✅
v16.0.0✅✅
v18.0.0❌❌

Django API Features​

  • Stack: : Django / DRF / SQLite
  • Up-to-date dependencies
  • DB Layer: Django Native ORM, SQLite persistence
  • Auth: JWT tokens managed via PyJWT
  • API Definition - the unified API structure implemented by this server

Manual Build​

Being a full-stack product, the backend and the frontend should be compiled and started separately. Before starting to compile the product, make sure you have the following tools installed in the environment:

  • NodeJS - version 14.x or higher
  • GIT - used to clone tjhe sources from Github
  • Python3 - used in many tools

👉 Start the Frontend​

Step 1 - Once the project is downloaded, change the directory to react-ui. 

$ cd react-ui

Step 2 - Install dependencies via NPM or yarn

$ npm i
// OR
$ yarn

Step 3 - Start in development mode

$ npm run start 
// OR
$ yarn start

At this point, the app is available in the browser localhost:3000 (the default address).


👉 Start the Backend Server​

Step 1 - Change the directory to api-server-django

$ cd api-server-django

Step 2 - Install dependencies using a virtual environment

$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate
$
$ pip install -r requirements.txt

Step 3 - Setup the database 

$ python manage.py makemigrations
$ python manage.py migrate

Step 4 - Start the API server (development mode)

$ python manage.py runserver 5000

Use the API via POSTMAN or Swagger Dashboard at localhost:5000.


👉 Start API using Docker​

Step 1 - Change the directory to api-server-django

$ cd api-server-django

Step 2 - Start API using docker-compose command 

$ docker-compose up --build

Resources​

Full-Stack React Berry PRO