InfiniLore.Lucide 0.576.0

InfiniLore.Lucide

InfiniLore.Lucide lets you integrate Lucide Icons into Blazor apps with a simple Razor component that renders SVG markup with configurable styling.

This package is developed as an independent project and is not affiliated, associated, or endorsed by the creators or maintainers of the Lucide library. It is built to enhance the experience of using Lucide's open-source icon set within Blazor applications.

This package uses the Minor section of semantic versions (0.x.0) to denote which Lucide version is used to build the current package.

Features

• Reusable Components: Add icons via Razor components.
• Icon Customization: Configure size, fill, stroke, and related SVG styling.
• Dynamic Icons: Change the icon name on the fly using <LucideIcon Name="..."/>.
• Static Icons: Prefer static markup? Use <Li.../> components with baked-in SVG data.
• WASM Support: Use the same components and services on server and client.

Getting Started

Install the Package

Make sure you have .NET 9.0 installed. Then install InfiniLore.Lucide:

dotnet add package InfiniLore.Lucide

Usage

Register Services (for LucideIcon)

LucideIcon uses ILucideService to resolve SVG data. Register the service once at startup. Li... components do not depend on this service.

Program.cs

builder.Services.AddLucideIcons();

_Imports.razor

@using InfiniLore.Lucide

Add the Component

LucideIcon refreshes its SVG when Name changes. Li... components are static and must be swapped to change icons at runtime.

The naming convention for Li... components is Li{LucideName.ToPascalCase()} with dashes removed. The LucideIcon.Name parameter accepts common variations like arrow-big-down-dash, arrowbigdowndash, or ArrowBigDownDash.

class is supported on both LucideIcon and Li... components.

<LucideIcon Name="signature" />


<LucideIcon Name="arrow-right"
           Size="48"
           Fill="none"
           Stroke="black"
           StrokeWidth="2"
           StrokeLineCap="round"
           StrokeLineJoin="round" />


<LiSignature />
<LiDam class="some-red-class" />

Parameters (LucideIcon)

Integration Details

This library:

• Uses lucide-static for icon definitions during package development.
• Exposes ILucideIconData for SVG data encapsulation.

Dependencies

• Lucide-Static for icon SVG content.
• CodeOfChaos.GeneratorTools for generator tooling in source generation scenarios.

Supported Platforms

• .NET 9.0 Blazor Server and WebAssembly.
• .NET 10.0 Blazor Server and WebAssembly.

Development Notes

This project follows a modular structure for maintainability:

• InfiniLore.Lucide: Blazor components and service logic.
• InfiniLore.Lucide.Data: Handles icon definitions and metadata, data provided by InfiniLore.Lucide.Generators.Raw.
• InfiniLore.Lucide.Generators.Raw: Implements tooling via Roslyn to read data from lucide-static package.
• Tools.InfiniLore.Lucide: A set of development tools, like the Razor file generator.

License

InfiniLore.Lucide is built on Lucide, which is distributed under the ICS license:

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

For full license details, see Lucide License.

Contributions

Contributions are welcome! To get started:

1. Fork the repository.
2. Create a new branch for your feature or fix.
3. Submit a pull request with a detailed description of your changes.

For further development or issues, feel free to raise a GitHub issue or suggest improvements.

Enjoy using InfiniLore.Lucide in your Blazor projects.