/fluent-ui-react

An ecosystem for building highly customizable enterprise class user interfaces.

Primary LanguageTypeScriptMIT LicenseMIT

Fluent UI

Gitter Circle Codecov David npm

Hey, we're in development:

  1. MINOR versions represent breaking changes
  2. PATCH versions represent fixes and features
  3. There are no deprecation warnings between releases
  4. Consult the CHANGELOG and related issues/PRs for more information

Fluent UI React represents a set of specifications and tools for building UI libraries.

How Can I Help?

Voice Your Opinion

Help shape this library by weighing in on our RFC (request for comments) issues.

Contribute

Our CONTRIBUTING.md is a step-by-step setup and development guide.

Good First Issue

Issues labeled good first issue are a great way to ease into development on this project.

New Components

There is an issue for every new component labeled new component. Just comment on the issue you'd like to take.

Help Wanted Label

Any other issue labeled help wanted is also ready for a PR.

Why?

There are a number of packages that a UI library needs to create great UI components. Take a look at SUIR's /src/utils as an example. This core library enables the SUIR features we love today such as shorthand props, event stack handling, auto controlled state, controlling the rendered component, and more.

Other libraries in the wild have some of these features and some of their own. It is our desire that the community share the best UI component practices in a core library to the greater benefit of the web.

A shared library means more great ideas and more engineering support for features and bug fixes. More importantly, it means more consistency in UI components on the web. We're really excited to see just how far we can take this aspect of collaboration.

Scope

You can think of Fluent UI as the internals of a good component library. This encompasses everything that one UI library may need, starting from the common UI component available on the web, custom theming, accessibility and rtl. Currently there is an React implementation of it, available here: microsoft/fluent-ui-react.

Contributing Organizations

Currently, these teams are actively participating in Fluent UI's specifications and development:

If you own or are building a UI component library, we'd love to have your input. Post an issue introducing yourself and your team and join us today.

You can actively contribute to Fluent UI by referring to the Contributing documentation.

Usage examples

You can find Fluent UI usage examples by accessing the doc site