Installation

uv add django-iconx

Add django_iconx to your INSTALLED_APPS and configure STATICFILES_DIRS:

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

STATICFILES_DIRS = [BASE_DIR / "static"]

Add an icon package and generate the CSS:

python manage.py iconx add lucide

This downloads Lucide icons to static/icons/lucide/ and generates static/iconx/icons.css. Include the CSS in your templates or Tailwind entry point:

<i class="icon icon-search"></i>

See Icon Packages for other icon sets and custom SVGs. See Configuration for all available settings.