crispy-tailwind

What it is and what it does

Crispy-Tailwind is a template pack that bridges django-crispy-forms and Tailwind CSS, letting you style Django forms with Tailwind utility classes instead of Bootstrap or other frameworks. It works by providing Tailwind-compatible HTML templates that crispy-forms uses when you apply the `|crispy` filter or `{% crispy %}` tag to your form objects.

The package is still in early development stages and supports Django 4.2 and 5.0 on Python 3.8–3.12. It includes default styles for Django's built-in form widgets and allows further customization via widget attributes. Installation is straightforward—add it to INSTALLED_APPS, set the template pack to "tailwind" in settings, and use the filter or tag in your templates.

Use it for:

• Render Django forms with Tailwind CSS styling in new Django projects using Tailwind for the UI framework.
• Migrate existing django-crispy-forms projects from Bootstrap to Tailwind without rewriting form templates.
• Style custom form widgets by combining Tailwind classes with widget.attrs in form field definitions.
• Use FormHelper and Layout from crispy-forms to control form structure while Tailwind handles visual styling.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Tailwind CSS styling templates for django-crispy-forms, allowing you to render Django forms with Tailwind utility classes using the `|crispy` filter or `{% crispy %}` tag.

Yes, if you are using django-crispy-forms and Tailwind CSS together. The package has low install friction, permissive licensing, no known vulnerabilities, and is actively maintained. However, be aware that development is still in early stages—test thoroughly in your project and check the documentation for any limitations with advanced crispy-forms features or custom widgets before relying on it in production.

Install

crispy-tailwind on PyPI

pip install crispy-tailwind

uv add crispy-tailwind

poetry add crispy-tailwind

Installing crispy-tailwind

Before you install

Low friction install with only two runtime dependencies (django and django-crispy-forms). Maintenance status is aging—last commit was 2025-03-22 and the latest release was 2024-02-13, so updates are infrequent but the repository remains active and not archived.

License in practice

MIT license is permissive, allowing free use, modification, and distribution with minimal restrictions—suitable for most commercial and open-source projects.

Quickstart

pip install crispy-tailwind

# In settings.py
INSTALLED_APPS = [
    "crispy_forms",
    "crispy_tailwind",
]
CRISPY_ALLOWED_TEMPLATE_PACKS = "tailwind"
CRISPY_TEMPLATE_PACK = "tailwind"

# In template
{% load tailwind_filters %}
{{ form|crispy }}

Verify before relying

• Extent of Tailwind CSS version compatibility and whether specific Tailwind versions are required.
• Level of widget customization support beyond Django's built-in widgets.
• Whether FormHelper and Layout features from crispy-forms are fully supported.

Package facts

Evidence: crispy_tailwind-1.0.3-py3-none-any.whl

Tags

More Python Modules packages