Skip to content

This repository aims to simplify the initial setup of Django projects by providing a boilerplate with common configurations, dependencies, and best practices.

License

Notifications You must be signed in to change notification settings

abdi-bb/django-boilerplate

Repository files navigation

Django Boilerplate

Django Boilerplate is a template to simplify the initial setup of Django projects, created by @abdi-bb. It includes common configurations, dependencies, and best practices to save time when starting new Django projects.

Features

  • Basic Setup: Pre-configured Django project with common settings.
  • Dependency Management: Utilizes Docker for managing dependencies and containerization.
  • Documentation: Comprehensive documentation to guide you through using the boilerplate.
  • Testing and CI: Includes a suite of tests and continuous integration setup.
  • Community Support: Open to contributions and community feedback.

Usage

To use Django Boilerplate, simply clone the repository and follow the setup instructions in the documentation.

Note: This boilerplate utilizes Docker for managing dependencies and containerization. Ensure Docker is installed on your system before proceeding.

git clone https://github.com/abdi-bb/django-boilerplate.git
cd django-boilerplate
cp .env.example .env 

Development Mode

To run the project in development mode, follow these steps:

  1. Build and start the Docker containers:

    docker-compose up --build
  2. Access the API: Open your browser and navigate to http://localhost:8000/api

Production Mode

To run the project in production mode, follow these steps:

  1. Build and start the Docker containers using the production configuration:

    docker-compose -f docker-compose.prod.yml up --build
  2. Access the API: Open your browser and navigate to http://localhost/api


Documentation

Check out the documentation for detailed usage instructions and configuration options.

Contributing

We welcome contributions from the community! Please read the contribution guidelines before getting started.

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute the code for both commercial and non-commercial purposes.

About

This repository aims to simplify the initial setup of Django projects by providing a boilerplate with common configurations, dependencies, and best practices.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages