timonweb/django-tailwind

Django + Tailwind CSS = 💚

css
django
django-tailwind
tailwind
tailwind-css

Tailwind CSS integration for Django a.k.a. Django + Tailwind = 💚

Tests PyPI GitHub Python versions Downloads Downloads / Month

Django Tailwind Demo

Goal

This project provides a convenient way to integrate the Tailwind CSS framework into a Django project. It creates a new Django app (named theme by default) that includes all the necessary files and configurations to get started with Tailwind CSS quickly.

Features

  • An opinionated Tailwind CSS setup that makes your life easier;
  • Hot reloading of CSS, configuration files, and Django templates. No more manual page refreshes!
  • Out of the box support for CSS imports, Sass-like variables, and nesting;
  • Supports the latest Tailwind CSS v4.x;
  • Start both Tailwind CSS and Django development servers with a single command;
  • An optional DaisyUI integration to spice up your Tailwind templates with pre-built components.
  • A convenient management command for installing Tailwind CSS plugins;

Requirements

Python 3.10 or newer and Django 4.2.20 or newer.

Documentation

The full documentation is at https://django-tailwind.readthedocs.io/ or in the docs directory of this repository.

Getting Started

  1. Install django-tailwind: bash pip install django-tailwind

  2. Add to INSTALLED_APPS in settings.py: python INSTALLED_APPS = [ # ... 'tailwind', ]

  3. Create Tailwind app: bash python manage.py tailwind init

  4. Add the generated app to INSTALLED_APPS and configure: ```python INSTALLED_APPS = [ # ... 'tailwind', 'theme', # your generated app name ]

TAILWIND_APP_NAME = 'theme' ```

  1. Install Tailwind CSS dependencies: bash python manage.py tailwind install

  2. Start development (runs Django + Tailwind): bash python manage.py tailwind dev

  3. Use Tailwind classes in your templates: ```html {% load tailwind_tags %}

Hello Tailwind!

```

That's it! 🎉 Your Django project now has Tailwind CSS installed and ready to use.

For configuring automatic page reloads during development, see the Installation instructions.

Bugs and suggestions

Please see CONTRIBUTING.

2019 - 2025 (c) Tim Kamanin - A Full Stack Django Developer

Stars
1619
2.22% more than last month
Forks
105
Open Issues
3