fasthtml-lucide — typed Lucide icons for FastHTML

[SpaceShaman]

Hi everyone! I’d like to share fasthtml-lucide, a small library for using Lucide SVG icons in FastHTML.

Installation

Using uv:

uv add fasthtml-lucide

Or pip:

pip install fasthtml-lucide

Usage

from fasthtml.common import Button
from fasthtml_lucide import Icon

Button(Icon("sun", cls="size-5 text-yellow-500"), "Light mode")

Icon renders an inline SVG and accepts a kebab-case icon name, CSS classes, and an optional size:

Icon("settings", size=20)
Icon("heart", cls="text-red-500")

The SVG files are bundled in the Python package, so your application doesn’t need Node.js, client-side JavaScript, or a CDN. Icons inherit their color through currentColor.

Typed icon names

The package generates an IconName type containing every available icon name. This provides editor autocomplete and lets type checkers catch misspelled names.

You can also use the type in your own components:

from fasthtml_lucide import Icon, IconName

def IconButton(icon: IconName, label: str):
    return Button(Icon(icon), label)

Icons are decorative (aria-hidden="true"), so icon-only buttons should have an accessible label on the button itself.

Automatic updates

A daily workflow checks for new lucide-static releases on npm and automatically builds, tests, and publishes updates to PyPI.

The PyPI version matches the bundled npm version. Python-only fixes use a .postN suffix, such as 1.61.0.post1, while keeping the same Lucide icons.

Links

• GitHub repository
• PyPI package

Feedback and suggestions are welcome!