CodeLifter.Iconizit 7.1.0

CodeLifter.Iconizit

A C# mapping of Font Awesome 7 Pro icons for use in MudBlazor, MAUI, or any other .NET framework that supports icon fonts.

Installation

dotnet add package CodeLifter.Iconizit

Or via NuGet Package Manager:

Install-Package CodeLifter.Iconizit

Features

• Complete Font Awesome 7 Pro mapping - All icon styles and variants
• Strongly-typed icon constants - IntelliSense support and compile-time checking
• Pro and Free attributes - Easily identify which icons are available in the free tier
• Search service - Programmatically browse and filter available icons

Supported Icon Styles

• Brands - Brand and logo icons
• Duotone - Two-tone icons (Pro)
• DuotoneThin - Thin two-tone icons (Pro)
• Light - Light weight icons (Pro)
• Regular - Regular weight icons
• Sharp - Sharp style icons (Pro)
• SharpLight - Sharp light icons (Pro)
• Solid - Solid weight icons
• Thin - Thin weight icons (Pro)

Usage

Basic Usage

using Iconizit;

// Access icons via strongly-typed constants
string twitterIcon = FontAwesome.Brands.Twitter;
string checkIcon = FontAwesome.Solid.Check;
string heartIcon = FontAwesome.Regular.Heart;

With MudBlazor

@using Iconizit

<MudIcon Icon="@FontAwesome.Solid.Home" />
<MudIcon Icon="@FontAwesome.Brands.Github" />
<MudIcon Icon="@FontAwesome.Duotone.Bell" />

With MAUI

<Label FontFamily="FontAwesome.Solid" Text="{x:Static iconizit:FontAwesome.Solid.Star}" />

Using the Search Service

using Iconizit;

var searchService = new SearchService();

// Get all available icon style classes
var iconClasses = searchService.GetFontAwesomeClasses();
// Returns: ["Brands", "Duotone", "DuotoneThin", "Light", "Regular", ...]

// Get icons from a specific style with optional filtering
var icons = searchService.GetPagedFilteredIconsByClass(
    typeof(FontAwesome.Solid), 
    filter: "arrow",
    excludePro: true  // Only show free icons
);

foreach (var icon in icons)
{
    Console.WriteLine($"{icon.Name}: {icon.Value} (Pro: {icon.Pro})");
}

Icon Attributes

Each icon has attributes indicating its availability:

• [Pro] - Icon is part of Font Awesome Pro
• [Free] - Icon is also available in Font Awesome Free

// Check if an icon is Pro-only at runtime
var field = typeof(FontAwesome.Solid).GetField("Check");
bool isPro = Attribute.IsDefined(field, typeof(ProAttribute));
bool isFree = Attribute.IsDefined(field, typeof(FreeAttribute));

Requirements

• .NET 8.0 or later
• Font Awesome 7 font files (not included - must be licensed separately from Font Awesome)

Font Setup

To use the icons, you must:

1. Obtain Font Awesome font files (Free or Pro) from Font Awesome
2. Include the appropriate OTF/TTF files in your project
3. Register the fonts in your application (varies by framework)

License

This library is licensed under the MIT License. See LICENSE for details.

Note: Font Awesome fonts and icons are subject to their own license. Please review the Font Awesome License for usage terms.

Links

• NuGet Package
• Font Awesome