
RMWC - React Material Web Components
A React (15 / 16) wrapper for the official Material Design (Web) Components v0.35.0
https://jamesmfriedman.github.io/rmwc/
RMWC is tested in all versions of React ranging from 15.5.x to 16.3.x;
Recent updates
RMWC is moving towards a direct implementation with MDC's Foundation classes. This means direct code reuse from the material-components-web implementation which will result in better performance, reliability, less bugs, and easier releases for RMWC. These will be rolled out a few at a time every release and will contain minimal breaking changes.
RMWC has been upgraded to use MDC 0.35.0
For MDC 35, the team at google has refactored Typography and Themes. Make sure to view the Changelog for more details.
BREAKING CHANGES
New Features
- A new a Shape component
- A new ImageList component
- A new TopAppBar component
- 100% Flow code compliance. Should expose some flow auto-complete and type checking if you're using it.
- More testing around server-side-rendering
View the changelog for detailed updates: https://github.com/jamesmfriedman/rmwc/blob/master/CHANGELOG.md
Goals
- To create the thinnest, lightest, and spec compliant wrapper around Google
Material Design Components for the Web
https://material.io/components/web/
- To utilize the Foundation javascript classes and expose their api for
consumption
- To be as unobtrusive and sensible as possible.
Installation
Required steps
npm i rmwc --save
or yarn add rmwc
- material-components-web should be installed automatically as a peer dependency. Include
node_modules/material-components-web/dist/material-components-web.min.css
in your project via your method of choice (using a link tag, a css-loader, etc.).
Optional steps
- If you would like to use the default Roboto font:
- add
<link href="https://fonts.googleapis.com/css?family=Roboto:300,400,500" rel="stylesheet" />
- add the class
mdc-typography
to the body <body className="mdc-typography">...</body>
- If you would like to use the material-icons font:
- add
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
- Add global settings by using the optional
<RMWCProvider />
component at the root of your project. See the 'Provider' section for more info.
Additional information is available in the Installation Guide
Usage
Read the docs on how to Usage
Why?
Read the docs on Methodology
About Breaking Changes
Read the docs on Methodology
To run the tests
- On MacOS Sierra and higher, install watchman to fix a filesystem issue with
Jest.
brew install watchman
npm test
To run the docs / contribute
git clone https://github.com/jamesmfriedman/rmwc.git
cd rmwc
npm install
npm start