1 | <div align="center">
|
2 | <a href="https://orbit.kiwi" target="_blank">
|
3 | <img alt="orbit-components" src="https://orbit.kiwi/files/orbit-components.png" srcset="https://orbit.kiwi/files/orbit-components@2x.png 2x" height="150px" />
|
4 | </a>
|
5 | </div>
|
6 |
|
7 | <br />
|
8 |
|
9 | <div align="center">
|
10 | <strong>Orbit-components is a React component library which provides developers with the easiest possible way of building Kiwi.com’s products.</strong>
|
11 | </div>
|
12 |
|
13 | ---
|
14 |
|
15 | ## Orbit Mission
|
16 |
|
17 | Orbit aims to bring order and consistency to all of our products and processes. We elevate user experience and increase the speed and efficiency of how we design and build products.
|
18 |
|
19 | ## Installation
|
20 |
|
21 | `orbit-components` are served as an [npm package](https://www.npmjs.com/package/@kiwicom/orbit-components).
|
22 |
|
23 | Add them to your project by running:
|
24 |
|
25 | ```bash
|
26 | // with npm
|
27 | npm install @kiwicom/orbit-components
|
28 |
|
29 | // with yarn
|
30 | yarn add @kiwicom/orbit-components
|
31 | ```
|
32 |
|
33 | Don't forget to install the [styled-components](https://github.com/styled-components/styled-components/) `^4.0.0` also.
|
34 |
|
35 | ## Usage
|
36 |
|
37 | 1. Import fonts that are used in orbit-components:
|
38 |
|
39 | ```html
|
40 | <link
|
41 | href="https://fonts.googleapis.com/css?family=Roboto:400,400i,500,500i,700"
|
42 | rel="stylesheet"
|
43 | />
|
44 | ```
|
45 |
|
46 | Or via CSS:
|
47 |
|
48 | ```css
|
49 | @import url("https://fonts.googleapis.com/css?family=Roboto:400,400i,500,500i,700");
|
50 | ```
|
51 |
|
52 | 2. Include any of our components in your project and use it:
|
53 |
|
54 | ```jsx
|
55 | import Alert from "@kiwicom/orbit-components/lib/Alert";
|
56 |
|
57 | <Alert>Hello World!</Alert>;
|
58 | ```
|
59 |
|
60 | If you want to use custom theme or dictionary inside your project, it's necessary to wrap your app into `<ThemeProvider>`. See [this document](https://github.com/kiwicom/orbit-components/tree/master/src/ThemeProvider/README.md) for more information.
|
61 |
|
62 | For live preview check out [Storybook](https://kiwicom.github.io/orbit-components/) or [orbit.kiwi](https://orbit.kiwi).
|
63 |
|
64 | You can also try `orbit-components` live on [CodeSandbox](https://codesandbox.io/s/github/designkiwicom/orbit-sandbox).
|
65 |
|
66 | ## Main Sections:
|
67 |
|
68 | - [Components](https://github.com/kiwicom/orbit-components/tree/master/src/)
|
69 | - [Icons](https://github.com/kiwicom/orbit-components/tree/master/src/Icon/README.md)
|
70 | - [Right to left languages](https://github.com/kiwicom/orbit-components/tree/master/src/utils/rtl/README.md)
|
71 | - [Theming](https://github.com/kiwicom/orbit-components/tree/master/.github/theming.md)
|
72 | - [Dictionary](https://github.com/kiwicom/orbit-components/tree/master/.github/dictionary.md)
|
73 |
|
74 | ## Contributing
|
75 |
|
76 | We are working on making this project fully open source. We appreciate any contributions you might make.
|
77 |
|
78 | [Bug reports](https://github.com/kiwicom/orbit-components/issues/new?template=bug_report.md) and [feature request](https://github.com/kiwicom/orbit-components/issues/new?template=feature_request.md) are welcome but, please use the correct template.
|
79 |
|
80 | Please check out our [Contribution Guide](https://github.com/kiwicom/orbit-components/tree/master/.github/contribution/README.md). It includes contribution guidelines and information on how to run and develop the project.
|
81 |
|
82 | ## Feedback
|
83 |
|
84 | We want to provide only components of the highest quality. We can’t do that without your feedback. If you have any suggestions about what we can do to improve components, please report it directly as an [issue](https://github.com/kiwicom/orbit-components/issues/new/choose) or write to us at **#orbit-components** on Slack.
|