Django and Tailwind integration based on the prebuilt Tailwind CSS CLI.
Project description
django-tailwind-cli
This project provides an integration of Tailwind CSS for Django that is based on the precompiled versions of the Tailwind CSS CLI.
It is inspired by the implementation of the Tailwind integration for Phoenix which completely skips the neccesity of a node installation. So it is a perfect match, if you are a user of htmx or any other framework that tries to avoid JavaScript coding in your web app. My personal motivation was, that I discovered that I never needed any other plugin besides the official plugins, which are already included in the CLI.
If you want to use node or you have to use it because of other dependencies, then the package django-tailwind by Tim Kamamin might be a better solution for you.
Features
- Management Commands...
- ...to install the the CLI for your operating system and machine architecture.
- ...to start the CLI in watch mode to incrementally compile your style sheet.
- ...to create a theme app which includes a basic stylesheet and a tailwind configuration which you can extend.
- ...to build the production ready CSS file.
- A template tag to include the CSS file in your base template.
- All the official plugins (typography, form, line-clamp, and aspect-ratio) integrated in the CLI are activated in the default configuration.
Requirements
Python 3.8 or newer with Django >= 3.2.
Installation
-
Install the package inside your Django project.
python -m pip install django-tailwind-cli
-
Add
django_tailwind_cli
toINSTALLED_APPS
insettings.py
.INSTALLED_APPS = [ # other Django apps "django_tailwind_cli", ]
-
Run the management command to install the cli and initialize the theme app.
python manage.py tailwind installcli python manage.py tailwind init
This installs the CLI to
$HOME/.local/bin/
and creates a new app in your project with the nametheme
. -
Add the new theme app to
INSTALLED_APPS
insettings.py
.INSTALLED_APPS = [ # other Django apps "django_tailwind_cli", "theme", ]
-
Edit your base template to include Tailwind's stylesheet.
{% load tailwind_cli %} ... <head> ... {% tailwind_css %} ... </head>
-
Start the Tailwind CLI in watch mode.
python manage.py tailwind watch
-
(Optional) Add django-browser-reload if you enjoy automatic reloading during development.
Configuration
The default configuration for this package is.
{
"TAILWIND_VERSION": "3.1.8",
"TAILWIND_CLI_PATH": "~/.local/bin/",
"TAILWIND_THEME_APP": "theme",
"TAILWIND_SRC_CSS": "src/styles.css",
"TAILWIND_DIST_CSS": "css/styles.css",
}
- Set
TAILWIND_VERSION
to the version of Tailwind you want to use. TAILWIND_CLI_PATH
defines where the CLI is installed. The default makes sense on macOS or Linux. On Windows it might helpful to pick a different path.TAILWIND_THEME_APP
defines the name of the theme application created by the management commandtailwind init
.TAILWIND_SRC_CSS
andTAILWIND_DIST_CSS
defines the internal structure of the theme app.TAILWIND_DIST_CSS
is a path always relative to thestatic
folder of the theme app.
Management Commands
Command | Description |
---|---|
tailwind installcli |
Download the CLI version TAILWIND_VERSION to TAILWIND_CLI_PATH . |
tailwind init |
Create a new theme app with the name TAILWIND_THEME_APP inside the settings.BASE_DIR of your project. |
tailwind watch |
Start the CLI in watch and incremental compilation mode. |
tailwind build |
Create a production ready build of the Tailwind stylesheet. You have to run this before calling the collectstatic command. |
Template Tags
This package provides a single template tag to include the Tailwind CSS. Depending on the value of settings.DEBUG
it activates preload or not.
{% load tailwind_cli %}
...
<head>
...
{% tailwind_css %}
...
</head>
DEBUG == False
creates the following output:
<link rel="preload" href="/static/css/styles.css" as="style">
<link rel="stylesheet" href="/static/css/styles.css">
DEBUG == True
creates this output:
<link rel="stylesheet" href="/static/css/styles.css">
License
This software is licensed under MIT license. Copyright (c) 2022 Oliver Andrich.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_tailwind_cli-1.2.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3f609de9d1207adbb51e8dcf7fb443f98297fdf504baacb2b4012d12ae603fd2 |
|
MD5 | 265ebd3a5fb8472df94f0e819c29b53a |
|
BLAKE2b-256 | 2b17f5354e211e91d5758211ae2292d362816049f731564ceb90fe7ec25d4e05 |
Hashes for django_tailwind_cli-1.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8672c039c16f2ab207d73deddd95595a2a2fe3b8f63e7a1e9b7566bab37c6850 |
|
MD5 | b634deb3befaf38ddd63cab86f323b28 |
|
BLAKE2b-256 | 556dc9811990b6653044f5a57495e2f0e1a083c78326441a41d28e4513da62b2 |