Ultimate-Django3.2-SepFront-Template

KO | EN

gitlite — search

#javascript #ai #typescript #rust #docker #nodejs #windows #awesome #cli #kubernetes #security #ios #openai #open-source

Ultimate-Django3.2-SepFront-Template

(★ 17)

This is an starting point for beginning any project which includes Django as backend api and React/Vue/Angular as front

Ultimate-Django3.2-SepFront-Template Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Ultimate Django3.2 Separated FrontendFramework</h1>
<h3 align="center">Just a big starting point for any backend project which includes frontend framework</h3>

<a href="https://www.python.org" target="_blank"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/python/python-original.svg" alt="python" width="40" height="40"/> </a>
<a href="https://www.djangoproject.com/" target="_blank"> <img src="https://user-images.githubusercontent.com/29748439/177030588-a1916efd-384b-439a-9b30-24dd24dd48b6.png" alt="django" width="60" height="40"/> </a> 
<a href="https://www.docker.com/" target="_blank"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/docker/docker-original-wordmark.svg" alt="docker" width="40" height="40"/> 
<a href="https://www.postgresql.org" target="_blank"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/postgresql/postgresql-original-wordmark.svg" alt="postgresql" width="40" height="40"/> </a>
<a href="https://www.nginx.com" target="_blank"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/nginx/nginx-original.svg" alt="nginx" width="40" height="40"/> </a>
<a href="https://git-scm.com/" target="_blank"> <img src="https://www.vectorlogo.zone/logos/git-scm/git-scm-icon.svg" alt="git" width="40" height="40"/> </a>
<a href="https://git-scm.com/" target="_blank"> <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/React-icon.svg/2300px-React-icon.svg.png" alt="react" width="40" height="35"/> </a><a href="https://git-scm.com/" target="_blank"> <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/Angular_full_color_logo.svg/2048px-Angular_full_color_logo.svg.png" alt="angular" width="40" height="40"/> </a><a href="https://git-scm.com/" target="_blank"> <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/95/Vue.js_Logo_2.svg/2367px-Vue.js_Logo_2.svg.png" alt="vue" width="40" height="40"/> </a>

[![Code Style Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

# Guideline
- [Goal](#goal)
- [How to setup](#how-to-setup)
- [Repo Features](#repo-features)
- [Configurations](#configurations)
- [Development usage](#development-usage)
- [Testing usage](#testing-usage)
- [Production usage](#production-usage)
- [Security](#security)
- [License](#license)
- [Todo](#todo)
- [Bugs](#bugs)

# Goal
This project main goal is to provide a way to deploy django applications by using docker along with nginx, gunicorn and letsencrypt and much more features a backed developer needs.

# How to setup
you can watch this video to know how you can use this repo

# Repo Features
<ul>
 <li>
 Latest LTS Django3.2 
 </li>
 Latest LTS included 3.2.x and needed requirements
 <li>
 Git 
 </li>
 python gitignore and README with license
 <li>
 Docker File 
 </li>
 Latest Python image dockerfile prod/dev and dockerignore
 
 <li>
 Docker Compose 
 </li>
 Docker compose prod/dev and minimum setup for django and db included,with volumes and network
 
 <li>
 Nginx + Gunicorn 
 </li>
 included nginx setup with gunicorn as serving service and file configs for production
 
 <li>
 Django env 
 </li>
 enviroment sample file and setup
 
 <li>Hints and Files</li>
 Sample files and hints all over the template for giving more pace
 
 <li>Github Actions</li>
 Pre Configurations for CI/CD in github actions. plus two step jobs for testing and deploying on vps with docker

<li>Black and Flake8</li>
 Included Pep8 and Flake8 configuration file for test purposes.Reformating the codes and bring the best out of it.

<li>Django Rest Framework</li>
 Included DRF package and all its dependencies along side of cors headers. plus simplejwt and token authentication for accounting.

<li>Swagger and Redoc</li>
 Allowing the urls to include rest api documentations

<li>
 Preconfigured 
 </li>
 Preconfigured settings.py for email,db,static,media etc.
</ul>

# Configurations
<ul>
 <li>
 Static & Media Directories 
 </li>
 STATIC_ROOT and STATIC_URL and same for media configurations with STATICFILES_DIRS
 <li>
 Template Directories 
 </li>
 Genral templates directory for root
 <li>
 Site Framework and Sitemaps + robots 
 </li>
 Siteframework as in site_id configs with robots.txt and sample sitemaps
 
 <li>
 Database Configs 
 </li>
 Database configuration for production with postgresql and volume directory in data
 
 <li>
 Email Configs 
 </li>
 Email configurations for dev and prod as in env file
 
 <li>
 Message Configs 
 </li>
 Message and warnings configuration for notification handelings
 <li>Hints and Files</li>
 Sample files and hints all over the template for more giving more pace
 
 <li>
 TestCase 
 </li>
 Hints for TestCases and sample files for an app
 <li>
 Security 
 </li>
 Security tags for https and redirections,HSTS,Cookie and other headers
</ul>

# Development usage
You'll need to have [Docker installed](https://docs.docker.com/get-docker/).
It's available on Windows, macOS and most distros of Linux.

If you're using Windows, it will be expected that you're following along inside
of [WSL or WSL
2](https://nickjanetakis.com/blog/a-linux-dev-environment-on-windows-with-wsl-2-docker-desktop-and-more).

That's because we're going to be running shell commands. You can always modify
these commands for PowerShell if you want.

#### Clone this repo anywhere you want and move into the directory:

```sh
git clone https://github.com/AliBigdeli/Ultimate-Django3.2-Template.git
```

#### Enviroment Varibales are included in docker-compose.yml file for debugging mode and you are free to change commands inside:

```docker
services:
  backend:
    command: sh -c "python manage.py makemigrations && python manage.py migrate && python manage.py runserver 0.0.0.0:8000"
    environment:      
      - DEBUG=True
```

#### Build everything:

*The first time you run this it's going to take 5-10 minutes depending on your
internet connection speed and computer's hardware specs. That's because it's
going to download a few Docker images and build the Python + requirements dependencies.*

```sh
docker compose up --build
```

Now that everything is built and running we can treat it like any other Django
app.

#### Note:

If you receive an error about a port being in use? Chances are it's because
something on your machine is already running on port 8000. then you have to change the docker-compose.yml file according to your needs.
#### Check it out in a browser:

Visit <http://localhost:8000> in your favorite browser.

# Testing Usage
#### running all at the same time:
```sh
docker compose run --rm backend sh -c " black -l 79 && flake8 && python manage.py test" -v core:/app
```
or
```sh
docker compose exec backend sh -c sh -c " black -l 79 && flake8 && python manage.py test" 
```

# Stage usage
In this phase of the project you can launch the service either in your pc/laptop to use as local host or you can setup on a vps to access through ip or even the domain which is dedicated to it. 
but before that dont forget to create .env files in the envs directory for stage mode which contains backend,nginx and the db.
after creating the files all you need to do to build the project is to run the command bellow:
```bash
docker compose -f docker-compose-stage.yml up --build
```
# Production usage
In this phase of the project you can launch the project only on the vps with the domain name connect to it other than that you have to change the settings accordingly.(you can use the stage config as base for the nginx)
But before that dont forget to create .env files in the envs directory for prod mode which contains backend,nginx and the db.
after creating the files all you need to do to build the project is to run the command bellow:
```bash
docker compose -f docker-compose-prod.yml run --rm certbot /opt/certify-init.sh
```
Note:the command i provided will firstly create the containers and volumes to run the whole project, then it will create a container to access the running server, when the server is accessible it will ask letsencrypt server to create a certificate for it with acme challange. this certificate will be valid for 90 days and you can renew it when ever you want.
Note: if you are using arm base cpu, please go inside the docker file inside of dockerfiles/prod/certbot/dockerfile and change the image name from
```bash
FROM certbot/certbot:v1.27.0
```
to

```bash
FROM certbot/certbot:arm32v6-latest
```
# Security
On Production mode you have all the security headers and settings added to nginx and even auto ssl encryption for 90 days valid. you can find the results by using these services:
- Mozilla Observatory

- Security Headers
<img src="https://user-images.githubusercontent.com/29748439/188070068-67a16c8f-3705-4fd0-b98a-a14fd53e98b2.png" alt="security headers" style="max-width:1280px;width:100%" />

- SSL Checker
<img src="https://user-images.githubusercontent.com/29748439/188070268-bbb70b90-3516-46e6-9799-7342fb63f7f5.png" alt="security headers" style="max-width:200px;width:100%; max-height:400px;text-align:center" />

# License
MIT.

# Todo
- [ ] add api test docs
- [ ] add predefined commands

# Bugs
Feel free to let me know if something needs to be fixed. or even any features seems to be needed in this repo.

Ultimate-Django3.2-SepFront-Template

Ultimate-Django3.2-SepFront-Template Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Ultimate-Django3.2-SepFront-Template

Ultimate-Django3.2-SepFront-Template Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README