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("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.