Material Bread

Cross Platform React Native Material Design Components

Choose a platform to get started

Features

• Highly Customizable React Native Components.
• Cross platform support: React Native (iOS, Android), React-native-web (Browsers), Electron (Windows, Mac, Linux), react-native-windows, react-native-macos, Next.js, Expo, Vue Native
• Support for Material Design 2.0 components.
• Live react native demos you can edit in in your browser.
• Typescript support

Table of Contents

• Quick Start
• Documentation
• Getting Started
  • Guides
  • Example Repos
  • Usage
• Supported Components
• Contributing
  • Library
  • Docs
  • Easy Contribution
• Tests
• Accessibility
• Copyright and License

Quick Start

1. npm install material-bread or yarn add material-bread
2. Install and link react-native-vector-icons and react-native-svg
3. Wrap your root <App> with a <BreadProvider>

<BreadProvider>
  <Root />
</BreadProvider>

4. Start developing!

Read the getting started guides for your platform to learn more.

Documentation

The component API docs and curated demos can be found at material-bread.org. See the contributing section to learn how to run the docs locally.

More demos for each component can be found at the component Storybook. This environment is used for developing cross-platform, see the contributing section to learn how to set it up locally.

Getting Started

Guides

Getting Started with React Native

Getting Started with Web

Getting Started with Electron

Getting Started with MacOS

Getting Started with Windows

Getting Started with NextJS

Getting Started with Expo

Getting Started with Vue Native

Example Repos

Boilerplate projects with minimal configuration to get started on each platform.

React Native: material-bread-rn-example

React Web: material-bread-react-example

Electron: material-bread-electron-example

MacOS: material-bread-macos-example

Windows: material-bread-windows-example

NextJS: material-bread-next-example

Expo: material-bread-expo-example

Vue Native: material-bread-vue-native-example

Usage

import React from 'react';
import { Button } from 'material-bread';

function App() {
  return <Button type="contained">Click Me</Button>;
}

Supported Components

A major goal of this library is to match all the components found in the material docs or provide enough demos/instructions that a developer can create a non-supported component from supported components. Keep in mind this still a work in progress so not all functionality from the Material Docs is supported yet.

Currently there are 39 distinct components (though what is a full component and what is a subcomponent is somewhat arbitrary), each with many variations, and 4 utility components.

Utility components

Contributing

All contributions are welcome and encouraged. If you are reporting a bug, please follow the bug issue template. If you are proposing an enhancement, please first search the backlogs before creating a new issue.

Contribute to library

Storybook is used as the dev environment for all components on all platforms. You can learn about how to get the storybook environment running locally for all platforms here. Please follow the conventions already in place. For example, most components follow the made up "props for prebuilt, children for custom" pattern. Additionally, make sure you are testing your components across platforms before making a PR.

Contribute to docs

Documentation is built using GatsbyJs and all pages are built using react components. You can learn how to get the docs running locally here.

Easy first contribution

You can start contribute extremely easily by improving demos or adding more interesting demos to the docs or storybook. Interesting, useful, and plentiful demos is a major goal of the project, so any help in that regard would be greatly appreciated.

Tests

Jest is the current test framework for all components. You can see the result of each component test in our storybook environement under the "Tests" tab. Writing more comprehensive tests is on the roadmap, but please consider contributing to speed this process up.

You can run tests locally using npm test.

You can generate test coverage by running npm run test:generate-output, this will output a json file with coverage.

Accessibility

react-native-web describes how to write accessible react-native components on the web here. Additionally, the storybook addon, addon-a11y, runs some simple accessibility tests on each component story. You can see the output of each accessibility test on the Accessibility tab for each component. Please consider contributing to make accessibility even better.

Copyright and License

Copyright 2019 Material Bread. Code released under the MIT license.