Integrate Tailwind CSS without JavaScript or npm.
Project description
plain.tailwind
Integrate Tailwind CSS without JavaScript or npm.
Overview
This package allows you to use Tailwind CSS in your Plain project without requiring Node.js or npm. It uses the Tailwind standalone CLI, which is automatically downloaded and managed for you.
First, initialize Tailwind in your project:
plain tailwind init
This creates a tailwind.config.js file in your project root and a source CSS file.
Then compile your CSS:
plain tailwind build
For development, use watch mode to automatically recompile when files change:
plain tailwind build --watch
Include the compiled CSS in your templates:
{% tailwind_css %}
Basic Usage
Commands
The plain tailwind command provides several subcommands:
$ plain tailwind
Usage: plain tailwind [OPTIONS] COMMAND [ARGS]...
Tailwind CSS
Options:
--help Show this message and exit.
Commands:
build Compile a Tailwind CSS file
init Install Tailwind and create tailwind.css
install Install the Tailwind standalone CLI
update Update the Tailwind CSS version
init- Sets up Tailwind in your project, creating necessary config filesbuild- Compiles your Tailwind CSS (use--watchfor auto-compilation,--minifyfor production)update- Updates to the latest version of Tailwind CSSinstall- Manually install the Tailwind CLI (usually automatic)
Template Tag
The tailwind_css template tag includes the compiled CSS file in your templates. Place it in your base template's <head>:
<!DOCTYPE html>
<html>
<head>
{% tailwind_css %}
</head>
<body>
<!-- Your content -->
</body>
</html>
Configuration
Updating Tailwind
The package tracks the Tailwind version in your pyproject.toml:
# pyproject.toml
[tool.plain.tailwind]
version = "3.4.1"
When you run plain tailwind build, it automatically checks if your local installation matches this version and updates if needed.
To update to the latest version:
plain tailwind update
This downloads the latest version and updates your pyproject.toml.
Adding Custom CSS
Custom CSS should be added to your source CSS file (by default at the root of your project as tailwind.css):
@import "tailwindcss";
@import "./.plain/tailwind.css";
/* Add your custom styles here */
.btn-primary {
@apply bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded;
}
.custom-gradient {
background: linear-gradient(to right, #4f46e5, #7c3aed);
}
The @import "./.plain/tailwind.css" line includes styles from all your installed Plain packages.
Read the Tailwind docs for more about using custom styles →
Deployment
For production deployments:
- Add
app/assets/tailwind.min.cssto your.gitignore - Run
plain tailwind build --minifyas part of your deployment process
The build command automatically installs the Tailwind CLI if it's not present, making deployments seamless.
When using Plain on Heroku, the Plain buildpack handles this automatically.
Installation
Install the plain.tailwind package from PyPI:
uv add plain.tailwind
Then add to your INSTALLED_PACKAGES:
# settings.py
INSTALLED_PACKAGES = [
# ...
"plain.tailwind",
]
The package stores the Tailwind CLI binary and version information in a .plain directory. Add this to your .gitignore:
.plain/
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file plain_tailwind-0.15.2.tar.gz.
File metadata
- Download URL: plain_tailwind-0.15.2.tar.gz
- Upload date:
- Size: 7.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.8.23
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2f26a8809d1f31319f8404c27b82994aff6dc3b652ef63770c368fa5956c9d4a
|
|
| MD5 |
f8f7a4f4de38696506bf64fb4b2af6f6
|
|
| BLAKE2b-256 |
0dba0d62f72178b631dd0f5cc1ec648384fe2698c0510e61a9243364fe033d28
|
File details
Details for the file plain_tailwind-0.15.2-py3-none-any.whl.
File metadata
- Download URL: plain_tailwind-0.15.2-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.8.23
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
52d27160f442ac6beb4924552f9cd465688b18be795552bb9ce84d0dcbfa1011
|
|
| MD5 |
7f00a4b9b5dec7d60276040980495843
|
|
| BLAKE2b-256 |
4387176bf331fe6c615a1c98d64daca7e7dc37afa461e2007d624393918650c1
|
