Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rahul-baberwal/django-var-cms/llms.txt

Use this file to discover all available pages before exploring further.

The optional [tailwind] extra registers django-tailwind-cli in your project, giving you a Tailwind CSS v3 toolchain driven entirely by a standalone CLI binary — no Node.js or npm required.

​
Installation

Install django-var-cms with the [tailwind] extra alongside the required media and static-file dependencies: 
pip install django-var-cms[tailwind] pillow whitenoise

​
What the extra provides

Installing the [tailwind] extra pulls in django-tailwind-cli>=2.0 as declared in pyproject.toml:
pyproject.toml
[project.optional-dependencies]
tailwind = ["django-tailwind-cli>=2.0"]
This adds two management commands to your project:
CommandPurpose
python manage.py tailwind buildCompile a minified production CSS bundle
python manage.py tailwind startStart the Tailwind dev server with hot reload
Run the build command before deploying to generate your final stylesheet: 
python manage.py tailwind build
During local development, use start to get instant class-change feedback: 
python manage.py tailwind start

​
Important: the CMS UI does not use Tailwind

The CMS itself does not use Tailwind CSS for its own interface. Its glassmorphic styles (navigation sidebar, forms, modals, media previews) are self-contained and ship with the var_cms package. The [tailwind] extra is purely for your project’s custom frontend templates, landing pages, or dashboard layouts — not for overriding CMS internals.

​
Mixing CMS pages with Tailwind-styled views

You can freely mix CMS-registered admin views with Tailwind-styled public frontend views in the same Django project. The two styling systems are completely independent — CMS routes live under /var-cms/ while your Tailwind templates handle everything else.
A typical project structure looks like this: 
myproject/
├── var_cms_admin.py        # CMS registrations (glassmorphic UI)
├── templates/
│   ├── base.html           # Tailwind base layout for public frontend
│   ├── home.html
│   └── articles/
│       └── detail.html
└── static/
    └── css/
        └── output.css      # compiled by `tailwind build`

​
Further reading

For full configuration options — including custom TAILWIND_CLI_SRC_CSS, output paths, and version pinning — refer to the official django-tailwind-cli documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us