This is a convenient CLI and Python lib wrapper for html-minifier-terser Tailwind v4 CLI
I recommend you use uv:
uv tool install --upgrade tminify
Run --help for details:
$ tminify --help usage: tminify [-h] [--version] [--no_minify] [--preflight] [--tailwind] [--verbose] src_html dest_html HTML minification with Tailwind CSS v4 compilation positional arguments: src_html Input HTML file. dest_html Output HTML file. options: -h, --help show this help message and exit --version show program's version number and exit --no_minify Skip HTML minification (only compile Tailwind if present). --preflight Enable Tailwind's preflight CSS reset (disabled by default to preserve custom styles). --tailwind Force Tailwind CSS compilation even if CDN script is not present. --verbose, -v Enable verbose logging. CLI for HTML minification with Tailwind CSS v4 compilation. This script can be used for general HTML minification (including inline CSS/JS) and/or Tailwind CSS v4 compilation and inlining (replacing CDN script with compiled CSS). Minification includes: - HTML structure: whitespace removal, comment removal - Inline CSS: all <style> tags and style attributes are minified - Inline JavaScript: all <script> tags are minified (not external JS files) tminify v0.1.3.dev4+d976d28Minification of Static HTML/CSS/JavaScript Pages
The first use case for tminify is as a CLI or Python function to minify HTML, CSS, and JavaScript using html-minifier-terser, the highly configurable, well-tested, JavaScript-based HTML minifier.
It makes this minifier quick to install with uv. You can then use it as a CLI tool or it can be added as a PyPI dependency to a project and used as a minification library from Python. It then internally handles (and caches) the Node dependencies.
Once it is installed, you can just use it on static files with a single command, with no package.json or npm project setup!
Internally, it checks for an npm installation and uses that, raising an error if not available. Once it finds npm, it does its own internal npm install of required tools so it’s self-contained. The required npm packages are installed locally within the Python site-packages directory.
In addition to general minification, tminify also compiles Tailwind CSS v4 standalone, without other project config or setup.
You might think Tailwind v4 compilation would be as simple as a single CLI command, but it seems like it’s not, since the modern Tailwind CLI seems developed around the use case of a full hot-reloading JavaScript app setup. This is fine if that’s the use case, but quite inconvenient if you don’t to set up a package.json and other things and just want to compile and minify a static HTML page.
With Tailwind, simple zero-build page development is easy via the Play CDN. To do this, you put a tag like <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script> in your code.
However, that setup is not recommended by Tailwind for production use due to its poor performance (scanning the whole page at load time to find Tailwind classes). This tool lets you use any Play CDN link so you can “drop in” Tailwind on static web pages during development. Once you want to minify before publishing it, run tminify, and will detect the Tailwind CDN script and compile and inline the production Tailwind CSS necessary for your page (and then minify everything else, including HTML and JavaScript).
Previously I had been using the minify-html (which has a convenient Python package) for general minification. It is great and fast. But I found I kept running into issues and in any case wanted proper Tailwind v4 compilation, so switched to this of combining Tailwind compilation with robust HTML/CSS/JS minification.
Take a file you want to minimize. Let’s put this file into page.html. Note we are using the Play CDN for simple zero-build development:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Test HTML</title>
<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
<style>
/* Custom CSS that will be minified alongside Tailwind */
.custom-shadow {
box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
}
</style>
</head>
<body class="m-0 p-5 bg-gray-50">
<div class="custom-shadow bg-gray-100 p-4 m-2 rounded-lg">
<h1 class="text-2xl font-bold text-blue-600 mb-3">Test Header</h1>
<p class="text-gray-700 mb-4">This is a test paragraph with some content.</p>
<button
onclick="testFunction()"
class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded transition-colors duration-200">
Click Me
</button>
</div>
<script>
// This JavaScript should get minified
function testFunction() {
console.log('Hello from test function!');
alert('Button was clicked!');
return 'Some return value';
}
</script>
</body>
</html>
If you want to minify it and compile all Tailwind CSS:
$ tminify page.html page.min.html --verbose
Tailwind v4 CDN script detected: will compile and inline Tailwind CSS
Found 1 <style> tags in body size 1091 bytes, returning CSS of size 245 bytes
Tailwind input CSS:
@import "tailwindcss";
@source "/Users/levy/wrk/github/tminify/page.html";
/* Custom CSS that will be minified alongside Tailwind */
.custom-shadow {
box-shadow:…
Tailwind config: /Users/levy/wrk/github/tminify/tmp4g35wsgu/tailwind.config.js:
module.exports = {
"content": [
"page.html"
],
"corePlugins": {
"preflight": false
},
"theme": {
"extend": {}
},
"plugins": []
};
Running: npx @tailwindcss/cli --input - --output /Users/levy/wrk/github/tminify/tmp4g35wsgu/tailwind.min.css --config /Users/levy/wrk/github/tminify/tmp4g35wsgu/tailwind.config.js --minify
Tailwind stderr: ≈ tailwindcss v4.1.8
Done in 54ms
Tailwind CSS v4 compiled and inlined successfully
Minifying HTML (including inline CSS and JS)...
Running: npx html-minifier-terser --collapse-whitespace --remove-comments --minify-css true --minify-js true -o /Users/levy/wrk/github/tminify/page.min.htmlk5geeie0v48wv.partial /Users/levy/wrk/github/tminify/page.mindwa99o7p.html
HTML minified and written: page.min.html
Tailwind CSS compiled, HTML minified: 1091 bytes → 6893 bytes (+531.8%) in 1s
$ cat page.min.html
<!DOCTYPE html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Test HTML</title><style>/*! tailwindcss v4.1.8 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,::backdrop,:after,:before{--tw-font-weight:initial;--tw-duration:initial}}}@layer theme{:host,:root{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-blue-500:oklch(62.3% .214 259.815);--color-blue-600:oklch(54.6% .245 262.881);--color-blue-700:oklch(48.8% .243 264.376);--color-gray-50:oklch(98.5% .002 247.839);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-700:oklch(37.3% .034 259.733);--color-white:#fff;--spacing:.25rem;--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--font-weight-bold:700;--radius-lg:.5rem … .custom-shadow{box-shadow:0 4px 8px #0000001a}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}</style></head><body class="m-0 p-5 bg-gray-50"><div class="custom-shadow bg-gray-100 p-4 m-2 rounded-lg"><h1 class="text-2xl font-bold text-blue-600 mb-3">Test Header</h1><p class="text-gray-700 mb-4">This is a test paragraph with some content.</p><button onclick="testFunction()" class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded transition-colors duration-200">Click Me</button></div><script>function testFunction(){return console.log("Hello from test function!"),alert("Button was clicked!"),"Some return value"}</script></body></html>…
(Last output truncated for clarity.)
Note because of the Tailwind compilation this page actually grew because we’ve compiled in the CSS for instant loading (for large pages it is more likely to shrink).
As a library: uv add tminify (or pip install tminify etc.). Then:
from pathlib import Path
from tminify import tminify
tminify(Path("page.html"), Path("page.min.html"))
For how to install uv and Python, see installation.md.
For development workflows, see development.md.
For instructions on publishing to PyPI, see publishing.md.
This project was built from simple-modern-uv.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4