fix: settings && update readme

README.md

@@ -1,153 +1,160 @@
 # Django Docker Quickstart
 
+This quickstart provides an easy way to initiate a Django project using Docker. It comes with pre-configured services including PostgreSQL, Redis, Celery (worker and beat), Nginx, and Traefik, ready to run a Django web application. Additionally, it provides a few handy shortcuts for easier development.
+
 ---
-Provides a quick and easy way to get started with a Django project using Docker.
-It comes with pre-configured services,
-including PostgreSQL, Redis, Celery (worker and beat),
-Nginx, and Traefik, that can be used to run a Django web application.
-It also comes with a few shortcuts to make development easier.
 
+## Features 🚀
 
-## Features
+- **Django** web application framework
+- **PostgreSQL** database
+- **Redis** in-memory data structure store
+- **Celery** worker and beat services for running background tasks asynchronously
+- **Nginx** web server for serving static and media files, and proxying requests to the Django application
+- **Traefik** reverse proxy for routing requests to the appropriate service and providing SSL termination
 
-- Django web application framework
-- PostgreSQL database
-- Redis
-- Celery worker and beat services: Celery is a task queue that is used to run background tasks asynchronously.
-- Nginx web server: Used to serve static files and media files, and to proxy requests to the Django application.
-- Traefik reverse proxy: Used to route requests to the appropriate service. It also provides SSL termination.
+## Included Packages and Tools 🛠️
 
-## Included Packages and Tools
+- **Pytest**: Testing framework
+- **Pytest Sugar**: A pytest plugin for a better look
+- **Pytest Django**: A pytest plugin providing useful tools for testing Django applications
+- **Coverage**: Test coverage tool
+- **Ruff**: Linter
+- **Black**: Code formatter
 
-- Pytest: Testing framework
-- Pytest Sugar: Plugin for pytest that changes the default look
-- Pytest Django: Plugin for pytest that provides useful tools for testing Django applications
-- Coverage: Test coverage
-- Ruff: Linter
-- Black: Code formatter
+## Requirements 📋
 
-## Requirements
-
-- Docker & Docker Compose [Install and Use Docker](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-20-04)
+- Docker & Docker Compose - [Install and Use Docker](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-20-04)
 - Python 3.10 or higher
-- Make(optional for shortcuts)
+- Make (optional for shortcuts)
 
+---
 
-## Getting Started
+## Getting Started 🏁
 
-To get started, follow these steps:
-
-1. Clone the repository:
-    
-    ```
+1. **Clone the repository:**
+    ```bash
     git clone https://github.com/godd0t/django-docker-quickstart.git
     ```
 
-2. Change directory into the project:
-    ```
+2. **Change directory into the project:**
+    ```bash
     cd django-docker-quickstart
     ```
-   
-3. Copy the `env.example` file to `.env` and update the values as needed:
-    ```
+
+3. **Copy the `env.example` file to `.env` and update the values as needed:**  
+<br>
+    **For Linux/macOS:**
+    ```bash
     cp env.example .env
     ```
+    **For Windows (Command Prompt):**
+    ```powershell
+    Copy-Item -Path env.example -Destination .env
+    ```
 
-## Initial Setup
+---
+
+## Initial Setup ⚙️
 
 ### Development Prerequisites
 
-To set up the project for development, follow these steps:
-
-1. Create a virtual environment:
-    ```
+1. **Create a virtual environment:**
+    ```bash
     python -m venv venv
     ```
-   
-2. Activate the virtual environment:
-    ```
+
+2. **Activate the virtual environment:**
+    ```bash
     source venv/bin/activate
     ```
-   
-3. (Optional) Install the development requirements specific to your IDE for enhanced functionality and support.
-    ```
+
+3. **(Optional) Install the development requirements specific to your IDE for enhanced functionality and support.**
+    ```bash
     pip install -r src/requirements-dev.txt
     ```
-4. Build the image and run the container:
-    ```
-    docker-compose -f docker-compose.yml up --build -d
-    ```
-   Or you can use the shortcut:
-    ```
-    make build-dev
-    ```
-   
-Now you can access the application at http://localhost:8000.
-With the development environment, you can make changes to the code and the changes will be reflected immediately.
 
+4. **Build the image and run the container:**  
+<br>
+   - If buildkit is not enabled, enable it and build the image:
+     ```bash
+     DOCKER_BUILDKIT=1 COMPOSE_DOCKER_CLI_BUILD=1 docker-compose -f docker-compose.yml up --build -d
+     ```
 
-### Production
+   - If buildkit is enabled, build the image:
+     ```bash
+     docker-compose -f docker-compose.yml up --build -d
+     ```
 
-To set up the project for production, follow these steps:
+   - Or, use the shortcut:
+     ```bash
+     make build-dev
+     ```
 
-1. Build the image and run the container:
+You can now access the application at http://localhost:8000. The development environment allows for immediate reflection of code changes.
+
+### Production Setup
+
+1. **Build the image and run the container:**  
+<br>
+    - If buildkit is not enabled, enable it and build the image:
+    ```bash
+    DOCKER_BUILDKIT=1 COMPOSE_DOCKER_CLI_BUILD=1 docker-compose -f docker-compose.prod.yml up --build -d
     ```
+
+    - If buildkit is enabled,
+    build the image:
+     ```bash
     docker-compose -f docker-compose.prod.yml up --build -d
     ```
-   Or you can use the shortcut:
-    ```
+   - Or, use the shortcut:
+    ```bash
     make build-prod
     ```
 
+---
 
-## Shortcuts
+## Shortcuts 🔑
 
-To make development easier, there are a few shortcuts available:
+This project includes several shortcuts to streamline the development process:
 
-Create migrations:
+- **Create migrations:**
+    ```bash
+    make make-migrations
+    ```
 
-```
-make make-migrations
-```
+- **Run migrations:**
+    ```bash
+    make migrate
+    ```
 
-Run migrations:
+- **Run the linter:**
+    ```bash
+    make lint
+    ```
 
-```
-make migrate
-```
+- **Run the formatter:**
+    ```bash
+    make format
+    ```
 
-Run the linter:
+- **Run the tests:**
+    ```bash
+    make test
+    ```
 
-```
-make lint
-```
+- **Create a super user:**
+    ```bash
+    make super-user
+    ```
 
-Run the formatter:
+- **Build and run dev environment:**
+    ```bash
+    make build-dev
+    ```
 
-```
-make format
-```
-
-Run the tests:
-
-```
-make test
-```
-
-Create a super user:
-
-```
-make super-user
-```
-
-Build and run dev environment:
-
-```
-make build-dev
-```
-
-Build and run prod environment:
-
-```
-make build-prod
-```
+- **Build and run prod environment:**
+    ```bash
+    make build-prod
+    ```
+---