Install

Installing MahApps.Metro.IconPacks

MahApps.Metro.IconPacks provides a wide selection of icon packs for WPF and UWP. You can install all icon packs at once, or just the ones you need to keep your app lightweight.

---

Types of Installation

There are two main ways to install icon packs:

• All-in-one: Installs every icon pack (easy, but increases app size).
• Selective: Installs only the icon packs you want (recommended for most users).

---

1. All-in-one: Install Every Icon Pack

If you want access to all available icon packs, install the main meta-package:

Using NuGet Package Manager Console:

Install-Package MahApps.Metro.IconPacks

• Adds all icon packs as dependencies.
• Best for: Prototyping or if you need most icon sets.
• Note: This may increase your application size significantly.

Using Visual Studio GUI:

1. Right-click your project in Solution Explorer and select Manage NuGet Packages...
2. Go to the Browse tab.
3. Search for MahApps.Metro.IconPacks.
4. Select the package and click Install.

---

2. Selective: Install Only What You Need (Recommended)

This approach keeps your app size minimal by adding only the icon packs you actually use.

a) Install the Core Library

Console:

Install-Package MahApps.Metro.IconPacks.Core

GUI:

1. Open Manage NuGet Packages...
2. Search for MahApps.Metro.IconPacks.Core and install it.

b) Install Specific Icon Packs

Add only the icon packs you need. For example, to install Material and FontAwesome:

Console:

Install-Package MahApps.Metro.IconPacks.Material
Install-Package MahApps.Metro.IconPacks.FontAwesome

GUI:

1. Open Manage NuGet Packages...
2. Search for each specific icon pack (e.g., MahApps.Metro.IconPacks.Material).
3. Click Install for each.

List of Available Icon Packs:

Pack Name	NuGet Package Name
BoxIcons	MahApps.Metro.IconPacks.BoxIcons
Entypo	MahApps.Metro.IconPacks.Entypo
EvaIcons	MahApps.Metro.IconPacks.EvaIcons
FeatherIcons	MahApps.Metro.IconPacks.FeatherIcons
FontAwesome	MahApps.Metro.IconPacks.FontAwesome
Ionicons	MahApps.Metro.IconPacks.Ionicons
JamIcons	MahApps.Metro.IconPacks.JamIcons
Material	MahApps.Metro.IconPacks.Material
MaterialDesign	MahApps.Metro.IconPacks.MaterialDesign
MaterialLight	MahApps.Metro.IconPacks.MaterialLight
Microns	MahApps.Metro.IconPacks.Microns
Modern	MahApps.Metro.IconPacks.Modern
Octicons	MahApps.Metro.IconPacks.Octicons
PicolIcons	MahApps.Metro.IconPacks.PicolIcons
RPGAwesome	MahApps.Metro.IconPacks.RPGAwesome
SimpleIcons	MahApps.Metro.IconPacks.SimpleIcons
Typicons	MahApps.Metro.IconPacks.Typicons
Unicons	MahApps.Metro.IconPacks.Unicons
WeatherIcons	MahApps.Metro.IconPacks.WeatherIcons
Zondicons	MahApps.Metro.IconPacks.Zondicons

Repeat the install steps for each pack you want to include.

---

3. GUI Installation: Step-by-Step

1. Right-click your project in Solution Explorer and select Manage NuGet Packages...
2. Go to the Browse tab.
3. Search for either:
   • MahApps.Metro.IconPacks (for all icon packs)
   • or a specific pack name (e.g., MahApps.Metro.IconPacks.Material)
4. Select the package you want and click Install.
5. Repeat for each additional icon pack you need.

---

4. Migrating from All-in-one to Selective Install

If you previously installed the all-in-one package but want to reduce your app size:

1. Uninstall the meta-package and its dependencies:

   Uninstall-Package MahApps.Metro.IconPacks -RemoveDependencies

2. Install the core and only the packs you need:

   Install-Package MahApps.Metro.IconPacks.Core
   Install-Package MahApps.Metro.IconPacks.Material

3. Update your code references where necessary (for example, change control names in XAML).

---

Troubleshooting

“Could not load file or assembly” Error

If you encounter this error after installing a NuGet package, simply build your solution to resolve it.

---

TL;DR

• Need all icons fast?
  Install-Package MahApps.Metro.IconPacks
• Want a minimal app?
  Install-Package MahApps.Metro.IconPacks.Core
  plus
  Install only the icon packs you need (see list above).