django-iconx

CSS-only icon system for Django.

Generates a single CSS file from SVG icon sources. No JavaScript or icon fonts needed. Built-in support for Lucide, Heroicons, Tabler, Phosphor, Bootstrap Icons, and Remix.

<i class="icon icon-search"></i>
<i class="icon icon-check text-2xl text-green-500"></i>

Mono icons use mask-image with currentColor, so they inherit text color and scale with font size via Tailwind text-* classes. Multi-color icons use background-image to preserve original SVG colors.

Quick start

uv add django-iconx

INSTALLED_APPS = [
    # ...
    "django_iconx",
]

STATICFILES_DIRS = [BASE_DIR / "static"]

python manage.py iconx add lucide

That downloads the icons and generates the CSS. Include it in your template or Tailwind entry point:

@import "tailwindcss";
@import "./static/iconx/icons.css";

See Installation for the full setup guide.