Guide · Open source

How to use fluentui-system-icons: install for Android, iOS and Flutter

Updated 2026-10-29 · written with AI from the project's own documentation and checked against our catalogue data

fluentui-system-icons is Microsoft's open-source collection of familiar, friendly and modern Fluent icons, offered in regular and filled styles. It is a developer asset library, not an end-user app. This guide shows you how to add it to Android, iOS/macOS and Flutter projects, or use the SVG files directly, so you can start using the icons in your own app.

Fluent UI System Iconsmicrosoft/fluentui-system-icons · ★ 10.9k · MIT Install options & downloads

Quick start

1Pick your platform. Decide whether you need Android, iOS/macOS, Flutter or plain SVG. Each route has its own install method.
2Add Maven Central (Android). Make sure mavenCentral() is in the root build.gradle file.
3Add the Android dependency. Add implementation 'com.microsoft.design:fluent-system-icons:1.1.344@aar' to your build.gradle.
4Add the iOS pod or Carthage entry. Use pod "FluentIcons", "1.1.344" with CocoaPods, or the Carthage git line from the README.
5Add the Flutter dependency. Add fluentui_system_icons: ^1.1.344 under dependencies in pubspec.yaml.
6Browse and pick icons. Open icons_regular.md or icons_filled.md to find the icon you need, then use it in your project.

Choose the platform you are building for

The README provides the icons as packaged libraries for Android, iOS/macOS and Flutter, and as inline SVG. Pick the route that matches your project. Each platform has its own library docs linked from the README: android/README.md, ios/README.md, flutter/README.md and packages/svg-icons/README.md.

Android: Gradle dependency from Maven Central
iOS and macOS: CocoaPods or Carthage
Flutter: pub package via pubspec.yaml
Any web or other project: inline SVG

Install Fluent System Icons on Android

The library is published via Maven Central. Make sure the mavenCentral() repository is in the root build.gradle file, then add the dependency to your project's build.gradle.

repositories {
    ...
    mavenCentral()
}

implementation 'com.microsoft.design:fluent-system-icons:1.1.344@aar'

Install Fluent System Icons on iOS and macOS

The README documents two options. With CocoaPods, add the pod to your Podfile. With Carthage, use the git line shown below. For library-specific docs, see ios/README.md.

CocoaPods: use_frameworks! and the FluentIcons pod at version 1.1.344
Carthage: point it at the microsoft/fluentui-system-icons git repository at the same version

use_frameworks!

pod "FluentIcons", "1.1.344"

Install Fluent System Icons in a Flutter project

In the pubspec.yaml of your Flutter project, add the fluentui_system_icons dependency under dependencies. The README lists the Flutter SDK as the prerequisite for Flutter projects.

dependencies:
  ...
  fluentui_system_icons: ^1.1.344

Use the SVG icons directly

If you do not want a platform package, the README says you can inline the SVG directly. The README does not describe a separate web package beyond this. See packages/svg-icons/README.md for details. Browse the full regular and filled icon lists in the repository to find the icon you need.

Regular icon list: icons_regular.md
Filled icon list: icons_filled.md

Handle right-to-left layouts with directionType

Each icon's metadata.json file has a directionType property. A value of unique means the icon has a specific RTL and LTR version. A value of mirror means it can be mirrored for RTL or LTR languages. The singleton property indicates the default direction to use for the icon.

Run the demo apps

To try the libraries, the README describes building the Android sample. Run the importer command yarn deploy:android, open the android directory in Android Studio, select sample-showcase in the build configuration dropdown and click run. For Flutter, open the flutter directory in Android Studio, select example and click run. Flutter requires a configured Flutter setup in Android Studio.

yarn deploy:android

What people use it for

Android apps that need Fluent-style icons pulled in through Gradle from Maven Central
iOS and macOS apps that use CocoaPods or Carthage to bring in the Fluent icon set
Flutter apps that need a ready-made Fluent icon package via pubspec.yaml
Teams that want consistent Microsoft-style icons across Android, iOS and Flutter
Projects that copy individual SVG icons inline

Frequently asked questions

Is fluentui-system-icons free to use?

The repository is licensed under the MIT licence, as listed in the project's details. Check the LICENSE file in the repository for the full terms before you ship.

How do I install fluentui-system-icons on Android?

Add mavenCentral() to the root build.gradle, then add implementation 'com.microsoft.design:fluent-system-icons:1.1.344@aar' to your project's build.gradle. The library is published on Maven Central.

How do I install it with CocoaPods?

Add use_frameworks! and pod "FluentIcons", "1.1.344" to your Podfile. The README also documents a Carthage option using the git repository at the same version.

How do I add it to a Flutter project?

In pubspec.yaml, add fluentui_system_icons: ^1.1.344 under dependencies. The README lists the Flutter SDK as a prerequisite.

Can I use these icons on the web without a package?

The README describes inline SVG as the plain option and does not describe a web package beyond that. You can inline the SVG directly, following packages/svg-icons/README.md.

What are the alternatives to Fluent System Icons?

Comparable icon projects include Material Icons, Phosphor Icons, Feather Icons and Tabler Icons. Choose one of these if you need an icon style that is not Fluent-based.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Fluent System Icons suit Android, iOS/macOS and Flutter developers who want Microsoft-style icons delivered as a package, and teams that need consistency across those platforms. Pick something else if you need a non-Fluent visual style, a drop-in web icon font or an end-user app.

Install options & downloads