Skip to content

Commit a2f0e5e

Browse files
Merge pull request #13 from EOS-uiux-Solutions/readme
Readme
2 parents f1d0dec + 77447fb commit a2f0e5e

File tree

1 file changed

+70
-2
lines changed

1 file changed

+70
-2
lines changed

README.md

Lines changed: 70 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,74 @@
11
# eos-icons-react
22
[![Open Source Love svg2](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
33

4+
## Using eos-icons-react in your projects
5+
Refer to [EOS Icons](https://eos-icons.com/) for more details about all the icons that are supported by EOS-Icons React
6+
7+
[Storybook EOS-Icons React](https://storybook.eos-icons.com/), checkout storybook for an in-depth look at the various different icons that are provided by EOS-Icons React as well the props available for configuring icons.
8+
9+
### Installation
10+
```
11+
# yarn
12+
yarn add eos-icons-react
13+
# npm
14+
npm install eos-icons-react
15+
```
16+
17+
### Usage
18+
#### common icons usage
19+
```
20+
import { EOS_STAR } from 'eos-icons-react';
21+
22+
<EOS_STAR />
23+
```
24+
#### Filled/Outlined icons usage
25+
```
26+
import { EOS_STAR_FILLED, EOS_STAR_OUTLINED } from 'eos-icons-react';
27+
28+
<EOS_STAR_FILLED />
29+
<EOS_STAR_OUTLINED />
30+
```
31+
#### Animated icons usage
32+
```
33+
import { EOS_LOADING_ANIMATED } from 'eos-icons-react';
34+
35+
<EOS_LOADING_ANIMATED />
36+
```
37+
38+
### Props
39+
#### Prop usage
40+
```
41+
import { EOS_LOADING_ANIMATED } from 'eos-icons-react';
42+
43+
# The below icons will have the color #FF5733, size xxl and a rotation of 45 degree
44+
<EOS_LOADING_ANIMATED color="#FF5733" size="xxl" rotate={45}/>
45+
```
46+
47+
#### Prop Details
48+
| Name | Type | Default | Description |
49+
|:-----|:-----|:--------|:------------|
50+
| size | string, number | 'm' | sets the size of icon * |
51+
| color | string | black | sets the color of icon |
52+
| rotate | string, number | 0 | sets the rotation degree of icon |
53+
| horizontalFlip | boolean | false | Flips icon horizontally |
54+
| verticalFlip | boolean | false | Flips icon vertically |
55+
| theme | string | 'filled' | sets icon theme (only available for common components)** |
56+
57+
> (*) Size can be provided using either string or number. Pre-Defined size list
58+
59+
| Size Name | Size Value |
60+
|:-----|:-----|
61+
| xs | 4 |
62+
| s | 8 |
63+
| base | 14 |
64+
| m | 18 |
65+
| l | 24 |
66+
| xl | 32 |
67+
| xxl | 48 |
68+
| xxxl | 64 |
69+
70+
> (**) The theme prop is only available for common icon component. Eos-Icons React has 4 different types of icon components (common / filled / outlined / animated). The common icon component contains both filled and outlined version of the icon. For switching between the two types of version you can either supply 'outlined' or 'filled' to the theme prop.
71+
472
## Development of EOS icons React
573
- Cloning the repo:
674
```
@@ -26,14 +94,14 @@ Follow the above steps before running the test command. The test sequence requir
2694
npm run test
2795
```
2896

29-
## Build process
97+
### Build process
3098
![Untitled-2021-07-18-1339](https://user-images.githubusercontent.com/54861487/126060393-13098cd1-e7aa-4fb7-8634-b15e3369f7ff.png)
3199

32100
# Learn more about the EOS Design System
33101

34102
- [EOS Design System](https://www.eosdesignsystem.com/)
35103

36-
- [EOS Icons](eos-icons.com)
104+
- [EOS Icons](https://eos-icons.com/)
37105

38106
- [Follow us on Twitter](https://twitter.com/eosdesignsystem)
39107

0 commit comments

Comments
 (0)