DjangoStarter v3.3.0 Version Update

Foreword

Recently, I've been dedicating quite a bit of time to the DjangoStarter project.

The v3.3.0 version mainly focused on optimizing the Docker build process, continuing to streamline the framework by replacing the original Daphne server with the Granian server. The rest involves documentation improvements and adding introductory tutorials for Django and frontend development.

This is all in preparation for the upcoming Celery integration and more features.

Overall, this can be considered a transitional version.

During the project development process, I also wrote the following articles, which you can refer to for reading:

• Performance Improved by 4 Times! Using Granian as an ASGI Server for Django Projects
• Performance Investigation of Different Django Servers and Deployment Methods
• Python, CSharp, Go, Nextjs – Just How Much Difference Is There in the Performance of Different Frameworks?

The detailed update log is included at the end of the article.

Project Introduction

DjangoStarter is an AI+full-stack scaffolding tool designed for independent developers and small teams, enabling them to quickly turn ideas into launch-ready products with minimal boilerplate code.

Built on Django 5 + Django-Ninja (Type-Safe API) + HTMX/Alpine/Tailwind, it integrates authentication, security, middleware, code generation, containerization, and observability, letting you focus entirely on the business logic.

Typical use cases: personal/independent product MVPs, internal enterprise tools, data dashboards, and backends with admin interfaces for various AI Agents/Assistants.

Changelog

https://github.com/Deali-Axy/DjangoStarter/releases/tag/v3.3.0

✨ Features (New Features)

• 🌐 Enhanced Internationalization Support (i18n)
  • Added complete translations for Simplified Chinese, Traditional Chinese, and English
  • Added language switcher, i18n routing, and template tags
  • Completed multilingual content for pages like navigation bar, footer, error pages, privacy policy, terms of service, etc.
  • Fixed URL prefix format and removed old JS switching logic
• 🛠️ Added admin dashboard entry to the navigation bar
• 🗑️ Removed the unfold module to reduce maintenance costs

🐞 Bug Fixes（修复）

• 🔧 Fix inconsistent Swagger documentation path from /api/doc → /api/docs

♻️ Refactor

• 📦 Docker & Deployment Structure Comprehensive Optimization
  • Unified rename of docker-compose.yml to compose.yml
  • Optimized Granian command format (changed to multi-line array) to improve readability
  • Removed unnecessary static file mounts
• 🚀 Deployment Architecture Refactor: Using Granian to Replace nginx/daphne
  • Unified adoption of Granian as a high-performance ASGI server
  • Simplified deployment structure, removed nginx-related configurations and templates
  • Updated README with explanation on Granian's usage and advantages
• 🛠️ Dockerfile Refactoring
  • Adjusted build stage sequence (Tailwind → Gulp) to ensure correct dependencies
  • More reasonable build process and file copying logic

📦 Dependencies (Dependency Changes)

• 🔄 Add Granian as ASGI/WSGI/HTTP2 server
  • Integrates three startup modes: ASGI, WSGI, and HTTP/2

📄 Docs (Documentation Update)

• 🆕 Added several core documents:
  • Frontend Quick Start Guide (TailwindCSS, HTMX, Alpine.js)
  • Tailwind Build Process Description
  • DjangoStarter v3 Quick Start Tutorial (Windows-Friendly Version)
  • macOS/Linux Startup Instructions
  • Project Roadmap (docs/roadmap.md)
  • Documentation Restructuring Plan Checklist (docs-todo.md)
• ✏️ Updated multiple sections in the README:
  • Updated Python version requirement to 3.12
  • Added TODO list
  • Updated the Disclaimer section for clarity
  • Removed outdated documentation (docs/README.old.md)
• 🗂️ Adjusted filenames for quick-start documentation to unify structure and naming conventions

🔧 Others (Other)

• ⛏️ Multiple documentation content revisions, format optimization, and supplementary explanations
• 📜 Supplementary copying and command updates for build-related files such as Tailwind, templates, and scripts