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

Tests GitHub Python versions

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 and without even needing to install Node.js if you choose the standalone binary mode.

Features

An opinionated Tailwind CSS setup that makes your life easier;
Two installation modes: standalone binary (works without Node.js) or npm-based (Node.js required);
Hot reloading of CSS, configuration files, and Django templates. No more manual page refreshes!
Out of the box support for CSS imports 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.11 or newer and Django 4.2.20 or newer.

Note: Node.js is only required if you choose the npm-based installation. The standalone binary mode does not require Node.js.

Documentation

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

Getting Started

Install django-tailwind:

a) With all dependencies that make development easier (recommended):
```
pip install 'django-tailwind[cookiecutter,honcho,reload]'
```
b) or just the core package (enough for production use):
```
pip install django-tailwind
```

Add to INSTALLED_APPS in settings.py:

INSTALLED_APPS = [
    # ...
    "tailwind",
]

Create Tailwind app:
```
python manage.py tailwind init
```

Add the generated app to INSTALLED_APPS and configure:

INSTALLED_APPS = [
    # ...
    "tailwind",
    "theme",  # your generated app name
]

TAILWIND_APP_NAME = "theme"

Install Tailwind CSS dependencies:
```
python manage.py tailwind install
```
Start development (runs Django + Tailwind):
```
python manage.py tailwind dev
```

Use Tailwind classes in your templates:

{% load tailwind_tags %}
{% tailwind_css %}

<h1 class="text-4xl font-bold text-blue-600">Hello Tailwind!</h1>

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 and Wagtail Developer

Star History

Release files for django-tailwind 4.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-tailwind 4.5.0
File	Size	Uploaded
django_tailwind-4.5.0.tar.gz	14.0 kB	Jun 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-tailwind 4.5.0
File	Interpreter	ABI	Platform	Reset
django_tailwind-4.5.0-py3-none-any.whl 23.4 kB Jun 12, 2026	Python 3	none	any	Details

Total release size: 37.3 kB

Release files / django_tailwind-4.5.0.tar.gz

Download URL	django_tailwind-4.5.0.tar.gz
Size	14.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`c4b40820663ac3932f6951b82b91e3773361a46d9bde972bc8a338eee3c5d045`
BLAKE2b-256 checksum How to use checksums	`4a52a87b0d08fd786f3f4bd7686edc0d3ae5cd1906d087cf8e2c2ef8157b07d7`
Upload date	Jun 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/timonweb/django-tailwind
Publishing commit: github.com/timonweb/django-tailwind/tree/2b7d170b26a7661202aa2e5139b37d3ca6a5f716

Workflow

Publishing configuration: github.com/timonweb/django-tailwind/blob/2b7d170b26a7661202aa2e5139b37d3ca6a5f716/.github/workflows/ci.yml
Publishing logs: github.com/timonweb/django-tailwind/actions/runs/27418381386/attempts/1

Artifact

Subject: django_tailwind-4.5.0.tar.gz
SHA-256 checksum: c4b40820663ac3932f6951b82b91e3773361a46d9bde972bc8a338eee3c5d045 Verifying attestations

Release files / django_tailwind-4.5.0-py3-none-any.whl

Download URL	django_tailwind-4.5.0-py3-none-any.whl
Size	23.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`618314751e867e8871b1e06ed98c0b8beb762ac9b431f739647ad4d82ab8b125`
BLAKE2b-256 checksum How to use checksums	`0932ffb8c8f6e86d06912d3afe4800e72a5045d21916171b36e256c07f87cc91`
Upload date	Jun 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/timonweb/django-tailwind
Publishing commit: github.com/timonweb/django-tailwind/tree/2b7d170b26a7661202aa2e5139b37d3ca6a5f716

Workflow

Publishing configuration: github.com/timonweb/django-tailwind/blob/2b7d170b26a7661202aa2e5139b37d3ca6a5f716/.github/workflows/ci.yml
Publishing logs: github.com/timonweb/django-tailwind/actions/runs/27418381386/attempts/1

Artifact

Subject: django_tailwind-4.5.0-py3-none-any.whl
SHA-256 checksum: 618314751e867e8871b1e06ed98c0b8beb762ac9b431f739647ad4d82ab8b125 Verifying attestations