Heroicons for Rust

A Rust crate providing access to the beautiful hand-crafted SVG icons from Heroicons, created by the makers of Tailwind CSS.

This crate offers Heroicons through a structured Icon system:

• Icon struct - Represent icons with IconName and Variant
• String conversion - Convert icons to SVG strings using to_string()
• Hypertext components - Ready-to-use components for the hypertext framework

Icon Variants

All icons are available in multiple variants:

• Outline (24×24px) - Outlined icons with 2px stroke
• Solid (24×24px) - Filled icons
• Mini (20×20px) - Smaller solid icons
• Micro (16×16px) - Tiny solid icons

Usage

Icon Struct

use heroicons::{Icon, icon_name::*, icon_variant::*};

// Create icons with different variants
let home_icon = Icon {
    name: Home,
    variant: Outline,
    ..Default::default()
};

let user_icon = Icon {
    name: User,
    variant: Solid,
    ..Default::default()
};

// Convert to SVG string
let svg_string = home_icon.to_string();
// Use the SVG string in HTML templates, web frameworks, etc.

Hypertext Components

The hypertext feature is enabled by default. Use the <Icon> component with the rsx! macro:

use heroicons::{Icon, icon_name::*, icon_variant::*};
use hypertext::prelude::*;

let page = rsx! {
    <div>
        <Icon name=(Home) variant=(Outline) ../>
        <Icon name=(User) variant=(Solid) ../>
    </div>
}.render();

Or with the maud! macro:

use heroicons::{Icon, icon_name::*, icon_variant::*};
use hypertext::prelude::*;

let page = maud! {
    div {
        Icon name=(Home) variant=(Outline) ..;
        Icon name=(User) variant=(Solid) ..;
    }
}.render();

Features

• Default: Includes hypertext feature for component support
• hypertext: Adds component functions in the hypertext module
• simd: Enables SIMD optimizations for HTML parsing