React-Material is available as an npm package.
npm install @6thquake/react-material
Pre-release channel (v1-beta) (Recommended for new projects.)
npm install @6thquake/react-material@next
v0.x(http://react-material.fat0.qa.nt.ctripcorp.com/)
// with npm
npm install @6thquake/react-material
// with yarn
yarn add react-material
Please note that @next
will only point to pre-releases; to get the latest stable release use @latest
instead.
React-Material is an MIT-licensed open source project. It's an independent project with ongoing development made possible thanks to the support of these awesome backers.
Your contributions, donations, and sponsorship allow us to build a sustainable organization. They directly support office hours, continued enhancements, great documentation and learning materials!
Here is a quick example to get you started, it's all you need:
import React from 'react';
import { render } from 'react-dom';
import Button from '@6thquake/react-material/Button';
function App() {
return (
<Button variant="raised" color="primary">
Hello World
</Button>
);
}
render(<App />, document.querySelector('#app'));
We often get this question:
Should I start with v1-beta? Beta is beta, so it's not a final product and I'm not guaranteed anything.
Yes, you should.
Some users are starting projects with v0.x which given the quality and stability of v1 they shouldn't be. They are just creating extra work for themselves as they will have to transition at some point.
The v1-beta effort started in May 2016, and it resolves many of the issues with v0. Many of us are already using v1-beta in production with no problems, and resolving the occasional breaking change is less hassle than upgrading from v0.x to v1 would be.
React-Material will never be a final product, you will never be guaranteed anything whether with v0.x, v1, or any future release. We are keeping v1 in beta so we can release breaking changes without having them slow us down.
The release notes always describe the breaking changes introduced with each release.
Bite the bullet and go for v1-beta.
For how-to questions and other non-issues, please use StackOverflow instead of Github issues. There is a StackOverflow tag called "material-ui" that you can use to tag your questions.
Are you looking for an example project to get started? We host some.
Check out our documentation website.
We'd greatly appreciate any contribution you make. :)
Recently Updated? Please read the changelog.
The future plans and high priority features and enhancements can be found in the ROADMAP.md file.
Thank you to React-Material for providing the infrastructure that allows us to expand based on it, with standard specifications, and clear path.
Thank you to BrowserStack for providing the infrastructure that allows us to test in real browsers.
This project is licensed under the terms of the MIT license.