##### The JavaScript front-end framework for building experiences for Office and Office 365.
Fabric JS is a JavaScript front-end framework which provides visuals-focused components to extend, re-work and use in your Office and Office 365 experiences. Fabric JS uses styles from the Office UI Fabric Core project. Fabric JS is a collection of responsive, mobile-first styles and tools designed to make it quick and simple for you to create web experiences using the Office Design Language.
Latest version: Fabric JS 1.5.0, which uses Fabric Core 5.0.1.
This repository contains simple, visuals-focused components that don't require a framework. For the entire list of components available in Fabric JS, see the component list.
> Note: For more information on Office UI Fabric version 2.6.1, which combined Fabric core and Fabric’s components together, see Get started with Fabric 2.6.1.
Get started
For a quick start, you can reference the latest release of Fabric from a CDN or clone and build locally. Once you've got Fabric JS added to your project, look at the component list for documentation pertaining to each available component.
If you'd like to get Fabric through a package manager such as Bower, npm, or NuGet, check out the package manager docs.
$3
Include the following references in the of your page:
``html
`
Note: You may notice an additional reference to the Fabric Core. The components of Fabric JS use styles from Fabric Core.
All releases of Fabric JS are available on the CDN, with new versions typically added within a week of the release. To reference a specific version, update the version number in the URL to match the one you want.
Before you get started, make sure you have node.js, gulp, and git installed. To build Fabric:
1. Clone the repo
2. Navigate to the folder that contains the gulpfile.js file (Fabric JS's root).
3. npm install 4. gulp watch
The built files will be in the /dist/` folder. You can then add these built files directly to your project.
You can also navigate to http://localhost:2020 to see the local docs site where you can test out the components' responsive behavior and see the samples.
New to Fabric? Although the project's site contains lots of great info about its purpose and what's included, most of Fabric JS's documentation is contained in this repository.
Fabric JS contains a variety of components that are a part of the Office / Office 365 design language. If you're not seeing a component here that you'd like, first check out the Office UI Fabric JS Requests board and upvote it there (if it exists), or file an issue on Fabric JS's issue tracker to kick off a new request.
Contribute to Fabric JS
Bug reports, feature requests, and questions are posted on the issue tracker. For details on our contribution process and how we label issues, see our contributing page.
If you have any style issues - icons, typography, fonts, colors, the grid, etc. - please file them in the Office UI Fabric Core repository.
Licenses
All files in this GitHub repository are subject to the MIT license. This project also references fonts and icons from a CDN, which are subject to a separate asset license.
Changelog
We use GitHub Releases to manage our releases, including the changelog between every release. View a complete list of additions, fixes, and changes since 1.0 on the releases page.