README.md

March 11, 2021 ยท View on GitHub

Sha-el-design

Contributor Covenant CI codecov gziped size npm version weekly downloads

React components for easier customization and smooth development flow.

๐Ÿ”ฅ Features

  • ๐ŸŒน Material inspired design.
  • ๐Ÿ“ฆ A complete package of ui resource for any React project.
  • ๐Ÿ›ก Made with โค using Typescript.
  • ๐ŸŽจ Easy theme customization using ThemeContext.
  • ๐Ÿค Smaller Footprint @ 102kb GZIPED.

๐ŸŽ› Environment Support

IE / Edge
IE / Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
Electron
Electron
IE11, Edgelast 2 versionslast 2 versionslast 2 versionslast 2 versions

๐Ÿ”ง Installation

Sha-el-design is available as an npm package.

// with npm
npm install react-icons sha-el-design

// with yarn
yarn add react-icons sha-el-design

๐Ÿƒ Usage

Simple example for you to get started.

import React from 'react';
import ReactDOM from 'react-dom';
import {Button} from 'sha-el-design';

function App() {
  return (
    <Button primary>Hello World</Button>
  );
}

ReactDOM.render(<App />, document.querySelector('#app'));

๐Ÿ’ซ Examples

Check example folder.

โœ Documentation

Check out our Storybook.

๐ŸŽจ Theming

Sha-el-design supports Theming(DARK ๐Ÿ‘ป, LIGHT and more) out of box using ThemeContext.

import * as React from 'react';
import { BrowserRouter, Route, Switch } from 'react-router-dom';
import { ThemeProvider } from 'sha-el-design/lib/components/Theme/Theme';

export class App extends React.Component {
  public render() {
    return (
      <ThemeProvider theme="DARK">
        <BrowserRouter>
          <Switch>
            <Route path="/login">
              ...
            </Route>
            <Route path="/home">
              ...
            </Route>
          </Switch>
        </BrowserRouter>
      </ThemeProvider>
    );
  }
}

๐Ÿค Contributing

Just follow this and this.

Make sure coding quality is best you can come up with also please be polite to everyone.

We would love a PR from you (It should make sense though).

๐Ÿ›ฃ Roadmap

Check Milestone

License

This project is licensed under the terms of the MIT license.