iconflow 2.1.0

Unified icon library for Rust GUI apps with 14 embedded icon packs (Bootstrap, Heroicons, Phosphor, Lucide, Tabler, and more). Type-safe API for egui, iced and more
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205

# iconflow

<p align="center">
  <img src="https://raw.githubusercontent.com/FerrisMind/iconflow/main/assets/icons/iconflow-color.png" alt="iconflow" width="200" />
</p>

<p align="center">
  <a href="https://crates.io/crates/iconflow">
    <img src="https://img.shields.io/crates/v/iconflow.svg" alt="crates.io version" />
  </a>
  <a href="https://github.com/FerrisMind/iconflow/blob/main/LICENSE">
    <img src="https://img.shields.io/crates/l/iconflow.svg" alt="license" />
  </a>
</p>

## Install

Enable at least one pack feature so the fonts and icon data are included.

```toml
[dependencies]
iconflow = { version = "2.1", features = ["all-packs"] }
```

## Quickstart guide

See [docs/quickstart.md](https://raw.githubusercontent.com/FerrisMind/iconflow/main/docs/quickstart.md) for a fast end-to-end setup guide and API overview.

## Core API

- `fonts()` returns the enabled font assets for registered packs.
- `try_icon(pack, name, style, size)` resolves an icon reference or returns `IconError`.
- `resolve_all(pack, style, size)` resolves every icon in a pack in `list` order (picker cold path).
- `list(pack)` returns the icon names for a pack.

## egui quickstart

<p align="center">
  <img src="https://raw.githubusercontent.com/FerrisMind/iconflow/main/examples/v2.0/egui_demo/egui_demo.png" alt="egui_demo" width="900" />
</p>

Register every `FontAsset` in `egui::FontDefinitions`, then render `IconRef.codepoint` with
`FontFamily::Name(icon.family)`:

```rust
use eframe::egui::{self, FontData, FontDefinitions, FontFamily, FontId, RichText};
use iconflow::{fonts, try_icon, Pack, Size, Style};
use std::sync::Arc;

fn install_icon_fonts(ctx: &egui::Context) {
    let mut definitions = FontDefinitions::default();
    let fallback_fonts: Vec<String> = definitions.font_data.keys().cloned().collect();

    for font in fonts() {
        definitions.font_data.insert(
            font.family.to_string(),
            Arc::new(FontData::from_static(font.bytes)),
        );
        let family = definitions
            .families
            .entry(FontFamily::Name(font.family.into()))
            .or_default();
        family.insert(0, font.family.to_string());
        for fallback in &fallback_fonts {
            if fallback != font.family {
                family.push(fallback.clone());
            }
        }
    }

    ctx.set_fonts(definitions);
}

fn icon_label(ui: &mut egui::Ui) {
    let samples = [
        (Pack::Bootstrap, "alarm", Style::Regular, Size::Regular),
        (Pack::Bootstrap, "alarm", Style::Filled, Size::Regular),
        (Pack::Heroicons, "academic-cap", Style::Filled, Size::Regular),
    ];

    for (pack, name, style, size) in samples {
        let icon = try_icon(pack, name, style, size).expect("icon missing");
        let glyph = char::from_u32(icon.codepoint).unwrap_or('?');
        let font_id = FontId::new(32.0, FontFamily::Name(icon.family.into()));

        ui.label(RichText::new(glyph.to_string()).font(font_id));
    }
}
```

Runnable example: `cargo run --example egui_demo --features all-packs`

## iced 0.14 quickstart

<p align="center">
  <img src="https://raw.githubusercontent.com/FerrisMind/iconflow/main/examples/v2.0/iced_demo/iced_demo.png" alt="iced_demo" width="900" />
</p>

In iced 0.14, fonts are loaded asynchronously via `Task`. Load the bytes from `fonts()` and
render a glyph with `Font::with_name` once loading completes.

```rust
use iced::{Task, font};
use iced::widget::text;
use iconflow::{fonts, try_icon, Pack, Size, Style};

#[derive(Debug, Clone)]
enum Message {
    FontLoaded(Result<(), font::Error>),
}

fn load_all_fonts() -> Task<Message> {
    Task::batch(fonts().iter().map(|font| {
        font::load(font.bytes).map(Message::FontLoaded)
    }))
}

fn icon_text() -> iced::widget::Text<'static> {
    let icon = try_icon(Pack::Bootstrap, "alarm", Style::Regular, Size::Regular)
        .expect("icon missing");
    let glyph = char::from_u32(icon.codepoint).unwrap_or('?');
    text(glyph.to_string())
        .size(48)
        .font(iced::font::Font::with_name(icon.family))
}
```

Runnable example: `cargo run --example iced_demo --features all-packs`

Example READMEs: `examples/v2.0/egui_demo/README.md`, `examples/v2.0/iced_demo/README.md`.
Historical 1.0 demos (do not build on 2.x): `docs/historical/v1.0/`.

## FAQ

See [docs/faq.md](https://raw.githubusercontent.com/FerrisMind/iconflow/main/docs/faq.md).

## Development

- `cargo xtask gen` regenerates `src/generated/**` from `assets/maps/*.json`.
- `cargo xtask gen --check` verifies generated output without writing files.

## Icon Fonts and Licenses

iconflow includes icon fonts from 14 open-source icon packs. All fonts are distributed under permissive licenses (MIT, Apache-2.0, or ISC).

Granularity is **per pack**: enabling a feature embeds that pack’s TTF(s). There is no per-icon subsetting yet — enable only the packs you need. Unused `include_bytes!` fonts can still be dropped by the linker if nothing calls `fonts()` / resolve paths that reference them; worst case is the full enabled set below.

### Included Icon Packs (by font weight)

Font MiB = sum of TTFs under `assets/fonts/<pack>/` (measured on disk). Icon counts are generated `ICON_NAMES` lengths.

| Icon Pack | Feature | Icons | Fonts (MiB) | License | Source |
|-----------|---------|------:|------------:|---------|--------|
| [Fluent UI System Icons](https://github.com/microsoft/fluentui-system-icons) | `pack-fluentui` | 2 839 | 6.30 | MIT | [microsoft/fluentui-system-icons](https://github.com/microsoft/fluentui-system-icons) |
| [Phosphor Icons](https://github.com/phosphor-icons/web) | `pack-phosphor` | 9 072 | 2.93 | MIT | [phosphor-icons/web](https://github.com/phosphor-icons/web) |
| [Tabler Icons](https://github.com/tabler/tabler-icons) | `pack-tabler` | 4 964 | 1.47 | MIT | [tabler/tabler-icons](https://github.com/tabler/tabler-icons) |
| [Devicon](https://github.com/devicons/devicon) | `pack-devicon` | 1 201 | 1.43 | MIT | [devicons/devicon](https://github.com/devicons/devicon) |
| [Remix Icon](https://github.com/Remix-Design/remixicon) | `pack-remixicon` | 1 493 | 0.56 | Apache-2.0 | [Remix-Design/remixicon](https://github.com/Remix-Design/remixicon) |
| [Bootstrap Icons](https://github.com/twbs/icons) | `pack-bootstrap` | 1 409 | 0.46 | MIT | [twbs/icons](https://github.com/twbs/icons) |
| [Lucide](https://github.com/lucide-icons/lucide) | `pack-lucide` | 1 665 | 0.41 | ISC | [lucide-icons/lucide](https://github.com/lucide-icons/lucide) |
| [Iconoir](https://github.com/iconoir-icons/iconoir) | `pack-iconoir` | 1 383 | 0.41 | MIT | [iconoir-icons/iconoir](https://github.com/iconoir-icons/iconoir) |
| [Lobe Icons](https://github.com/lobehub/lobe-icons) | `pack-lobe` | 538 | 0.29 | MIT | [lobehub/lobe-icons](https://github.com/lobehub/lobe-icons) |
| [Ionicons](https://github.com/ionic-team/ionicons) | `pack-ionicons` | 1 356 | 0.28 | MIT | [ionic-team/ionicons](https://github.com/ionic-team/ionicons) |
| [Heroicons](https://github.com/tailwindlabs/heroicons) | `pack-heroicons` | 324 | 0.26 | MIT | [tailwindlabs/heroicons](https://github.com/tailwindlabs/heroicons) |
| [Octicons](https://github.com/primer/octicons) | `pack-octicons` | 348 | 0.15 | MIT | [primer/octicons](https://github.com/primer/octicons) |
| [Feather Icons](https://github.com/feathericons/feather) | `pack-feather` | 287 | 0.06 | MIT | [feathericons/feather](https://github.com/feathericons/feather) |
| [Carbon Icons](https://github.com/carbon-design-system/carbon-icons) | `pack-carbon` | 145 | 0.03 | Apache-2.0 | [carbon-design-system/carbon-icons](https://github.com/carbon-design-system/carbon-icons) |

**Total:** 34 TTF files · ~15.0 MiB fonts on disk · 27 024 icon names across 14 packs (`all-packs`).

### Trademarks

Some packs (notably **Devicon** and **Lobe Icons**) include glyphs that depict third-party brand marks.
Upstream licenses cover the font/SVG artwork; they do **not** grant trademark rights to those brands.
Using a logo glyph in a product UI may still require permission from the mark owner — treat brand
icons as a separate compliance question from MIT/Apache/ISC.

### Acknowledgments

iconflow is built on top of these excellent open-source icon libraries. We are grateful to all the contributors and maintainers of these projects:

- **Bootstrap Icons** by Bootstrap team
- **Carbon Icons** by IBM Carbon Design System
- **Devicon** by Devicon and contributors
- **Feather Icons** by Cole Bemis and contributors
- **Fluent UI System Icons** by Microsoft
- **Heroicons** by Tailwind Labs
- **Iconoir** by Luca Burgio and contributors
- **Ionicons** by Ionic team
- **Lobe Icons** by LobeHub
- **Lucide** by Lucide contributors
- **Octicons** by GitHub (Primer)
- **Phosphor Icons** by Phosphor Icons team
- **Remix Icon** by Remix Design
- **Tabler Icons** by codecalm and contributors

All icon fonts are converted from their original SVG sources and embedded as TTF files in this project. The fonts are included in the crate binary when corresponding feature flags are enabled.

## License

This project is licensed under MIT License.

Third-party dependencies and fonts have their own licenses. See:
- [THIRD_PARTY_LICENSES_CRATES.html](https://raw.githubusercontent.com/FerrisMind/iconflow/main/THIRD_PARTY_LICENSES_CRATES.html) for Rust crate licenses
- [THIRD_PARTY_LICENSES_FONTS.md](https://raw.githubusercontent.com/FerrisMind/iconflow/main/THIRD_PARTY_LICENSES_FONTS.md) for font licenses