Welcome to Django Tailwind’s documentation!#

Definitions#

This document uses the Tailwind word when we talk about two things: the CSS framework and the Django package.

So let’s agree that we’ll use:

  • Django Tailwind, when we talk about this very package;

  • Tailwind CSS, when we talk about the CSS framework;

So Django Tailwind was created to make Tailwind CSS and Django play together (💚).

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

Note

This is a maintained fork of Tim Kamanin’s original django-tailwind project. The original project is no longer maintained. This fork updates the project to work with the latest version of Tailwind CSS while preserving the original functionality.

Django + Tailwind Demo

Goal#

This project aims to provide a comfortable way of using the Tailwind CSS framework within a Django project.

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;

  • Includes official Tailwind CSS plugins like typography, form, line-clamp, and aspect-ratio;

  • Supports the latest Tailwind CSS v4.x;

For instructions on upgrading from v2 to v3, see this post on Tim Kamanin’s blog.

Requirements#

Python 3.10 or newer with Django >= 3.2 or newer.

Documentation#

The full documentation is at https://django-tailwind-4.readthedocs.io

Installation#

pip install django-tailwind-4

[RECOMMENDED IN DEV] If you want to use automatic page reloads during development use the [reload] extras, which installs the django-browser-reload package in addition:

pip install 'django-tailwind-4[reload]'

Check docs for the Installation instructions.

Bugs and suggestions#

Please see CONTRIBUTING.

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

2024 - present (c) Ryan Sevelj - Fork Maintainer