lucide-fasthtml

lucide-fasthtml

Any use of the code retrieved from lucide.dev is subject to the terms of the Lucide license, found here.

A small package for FastHTML that allows you to use Lucide icons efficiently with fasthtml projects, avoiding cdn's and downloading entire static bundles. Features include:

• Full tree-shaking support - only saves the icons you use.
• Client-side script retrieval on cache-miss
• Streamlined attribute handling for full customization (mimics lucide-react)
• On-demand download/save of icons. Downloaded on first call and stored in a dict within the package.
• Immediate icon retrieval on cache-hit (SSR)

---

Table of Contents

• Installation
• Usage
• Customization
• License

Installation

pip install lucide-fasthtml

Usage

from lucide_fasthtml import Lucide

Lucide("sun") # or Lucide(icon="sun")

Customization

Supports all standard svg attributes. Defaults are set to the standard defaults found at lucide.dev. For ease of use, streamlined attributes used by lucide-react are also supported in a FastHTML-compatible format.

lucide-react	lucide-fasthtml	notes
color="red"	color="red"	Can be used instead of stroke. Sets the color of the icon stroke.
strokeWidth="2"	stroke_width="2"	Sets the stroke width of the icon.
absoluteStrokeWidth=True	absolute_sw=True	Calculates the stroke width based on the icon's size, to standardize the stroke width across different icon sizes.
size=16	size=16	Can be used instead of width and height properties. Sets the size (width and height) of the icon to the specified value.

Lucide("sun", color="red", stroke_width="1.5", absolute_sw=True, size=16)

All icon data can be found in the generated icons.py file within the package. You can manually add/remove icons as needed, or delete the entire file to re-download all used icons when started next.

License

lucide-fasthtml is distributed under the terms of the MIT license.