fluentui README

The project's README from github.com/microsoft/fluentui. As one markdown file: README.md.

Fluent UI Web

Build Status GitHub contributors GitHub top language Twitter Follow

Fluent UI React is shipping its v9 final stable release. Visit the Fluent UI React v9 Release page on the wiki to learn more about the upcoming release schedule.

Fluent UI web represents a collection of utilities, React components, and Web Components for building web applications.

This repo is home to 3 separate projects today. Combining Fluent UI React v9 components with Fluent UI React v8 or v0 components is possible and allows gradual migration to Fluent UI v9.

The following table will help you navigate the 3 projects and understand their differences.

React Components (v9) React (v8) Web Components
Overview New, future-proof and forward looking Mature Web Component implementation of Fluent UI.
Used By Microsoft 365 Office Edge
Read Me README.md README.md README.md
Changelog CHANGELOG.md CHANGELOG.md CHANGELOG.md
Repo packages/react-components ./packages/react ./packages/web-components
Quick Start Quick Start Quick Start See README.md
Docs https://react.fluentui.dev/ aka.ms/fluentui-react aka.ms/fluentui-web-components
NPM @fluentui/react-components @fluentui/react @fluentui/web-components
Version npm version npm version npm version
Issues Fluent UI React Components GitHub Issues Fluent UI React GitHub Issues Fluent UI Web Components GitHub Issues

Why are there two React versions? Fluent UI v8 is still widely used. We encourage you to migrate to Fluent UI v9. See the Migration overview.

FluentUI Insights

Fluent UI Insights is a series that describes the design and decisions behind the Fluent UI design system.

EP01: Positioning EP02: Styling EP03: Griffel
Watch EP01: Positioning Watch EP02: Styling Watch EP03: Griffel
EP04: Foundational APIs EP05: Theming EP06: Accessible by default
Watch EP04: Foundational APIs Watch EP05: Theming Watch EP06: Accessible by default

Licenses

All files on the Fluent UI React GitHub repository are subject to the MIT license. Please read the License file at the root of the project.

Usage of the fonts and icons referenced in Fluent UI React is subject to the terms of the assets license agreement.

Changelog

You can view the complete list of additions, fixes, and changes in the CHANGELOG.md file for each package.

Looking for Office UI Fabric React?

The Office UI Fabric React project has evolved to Fluent UI.

The office-ui-fabric-react repo is now this repo (fluentui in the Microsoft organization)! The name change should not disrupt any current Fabric usage, repo clones, pull requests, or issue reporting. Links should redirect to the new location. The library formerly known as office-ui-fabric-react is now available as @fluentui/react (see above table for more information).

We have a lot in store for Fluent UI - Read our announcement here.

Looking for Fluent UI React Northstar?

Fluent UI React Northstar has been superseded by Fluent UI React Components v9 and reached End Of Life in July 2025.

For more details about Fluent UI React Northstar, see its source and README.md.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

fluentui (microsoft/fluentui)

Searching Database…

20.3K ·GitHub
Fluentui
Что это такое?Fluent UI web — это набор утилит, React-компонентов и веб-компонентов от Microsoft для создания веб-приложений, а также дизайн-система, на которой построены Microsoft 365, Office и Edge.
Это одна библиотека или три отдельные?Один репозиторий, три проекта: React-компоненты v9 (используются в Microsoft 365), React v8 (используется в Office) и Web Components (используются в Edge). Каждый поставляется как отдельный npm-пакет.
Как подключить её к своему приложению?Установите нужный пакет из npm: @fluentui/react-components для v9, @fluentui/react для зрелой v8 или @fluentui/web-components для веб-компонентов, не привязанных к фреймворку.
Обязательно использовать React?React-пакетам, естественно, нужен React. А пакет web-components построен на стандартных Web Components, поэтому работает и без React — в других фреймворках или на обычных страницах.
Вроде бы есть две версии для React. Какую выбрать?Есть два поколения React-компонентов: v8 — зрелая и всё ещё широко используемая, но v9 — финальный стабильный релиз, и Microsoft рекомендует переходить именно на неё.
Это только для веба или есть и нативная версия?Только веб. Вся коллекция ориентирована на веб-приложения; в этом репозитории нет нативных компонентов для iOS или Android.
Всем этим можно пользоваться по лицензии MIT?Код — под MIT, но шрифты и иконки — нет: их использование регулируется отдельным лицензионным соглашением на ассеты, так что перед поставкой проверьте эти условия.
Что случилось с Office UI Fabric и Northstar?Office UI Fabric React развился в Fluent UI: старый репозиторий теперь перенаправляет на microsoft/fluentui, а его библиотека живёт дальше как @fluentui/react. Northstar был заменён на v9 и в июле 2025 года достиг конца жизненного цикла (End Of Life).
Можно ли использовать компоненты v8 и v9 вместе при миграции?Да, в README прямо сказано, что v9 можно совмещать с v8 (и даже с v0), поэтому переходить на v9 можно постепенно, а не переписывать весь интерфейс за один раз.
Где узнать, почему компоненты устроены именно так?Об этом рассказывает серия видео FluentUI Insights из шести эпизодов: позиционирование, стилизация, Griffel, базовые API, темы и доступность по умолчанию.
Проект до сих пор активно поддерживается?Да. Для v9 вышел финальный стабильный релиз, в репозитории настроены CI-проверки bundle-size и package-check, а сами Microsoft 365 значатся среди потребителей компонентов v9.
What are similar projects?Semantic-UI-React, arc-library, base-ui, chakra-ui, shoelace, blueprint, react-icons, bootstrap-vue
Which topics is it in?fluent, web-components, react-components, icons, components, design-system, microsoft, accessibility, component-library, ui-components, ui, web-app
Creator
microsoft
Size
844.4 MB
Stars
20.3K
Updated
CommitOct 16Release@fluentui/utilities_v8.17.3Oct 01
Age
10y
Commits · 90 Days