modern-django-starter 0.2.2

A CLI tool for generating Django 5.x projects with HTMX, AlpineJS, and more

Modern Django Starter 🚀

A CLI tool for generating Django 5.x projects with HTMX, AlpineJS, and more. Streamline your setup with customizable options for Docker, databases, cloud providers, and frontend pipelines. Build modern, reactive Django apps faster!

Installation

Install from PyPI:

pip install modern-django-starter

📦 PyPI Package: https://pypi.org/project/modern-django-starter/

Quick Start

Generate a new Django project:

modern-django-starter create my_awesome_project

Or with options:

modern-django-starter create my_project --output-dir /path/to/projects

Features

• Django 5.x
• HTMX for dynamic HTML updates
• AlpineJS for lightweight JavaScript interactions
• Django-allauth for authentication
• HyperScript for easy DOM manipulation
• TailwindCSS and DaisyUI for styling
• Docker support (optional)
• PostgreSQL database
• Cloud provider integration options
• Email provider integration
• Django Rest Framework (DRF) support
• Frontend pipeline options
• Celery for background task processing
• Sentry for error tracking
• CI tool integration options

Prerequisites

• Python 3.8+
• pip

Optional:

• Node.js and npm (for frontend pipelines)
• Docker (for containerized development)

Development Installation

If you want to contribute or install from source:

1. Clone this repository:

   git clone https://github.com/CasualEngineerZombie/modern-django-starter.git
   cd modern-django-starter
   

2. Install in development mode:

   pip install -e .
   

Usage

Generate a new Django project:

modern-django-starter create my_awesome_project

Or specify an output directory:

modern-django-starter create my_project --output-dir /path/to/projects

The CLI will guide you through configuration options interactively.

Configuration Options

• Docker support
• PostgreSQL version
• Cloud provider (AWS, Azure, GCP, Render, Railway, PythonAnywhere, Flyio, Dokku, Heroku, or none)
• Email provider
• Asynchronous support
• Django Rest Framework
• Frontend pipeline
• Celery
• Sentry
• CI tools

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.