
# kor
### Visit [www.kor-ui.com](https://www.kor-ui.com/) for samples, APIs and other design/development documentation
A design system / UI component library built with LitElement. Based on the web components standards, kor is browser-, framework- and OS-agnostic and can be used to build web, desktop and mobile applications using Angular, Vue, React, plain JS and so on.
## Installation
Install the library through npm:
```
npm install @kor-ui/kor --save
```
---
## Integration of Components
### Load the whole bundle
The most simple and common way of including the components into an application is by loading the core bundle:
```js
// include bundle through module import
import '@kor-ui/kor'
// if using JS, css can also be imported. if using TS, use html stylesheet as shown below
import '@kor-ui/kor/kor-styles.css'
```
*or*
```html
```
### Load single components
As an alternative, you can also load individual components to reduce loading time. Be aware that components are inter-dependent and should be imported independently:
```js
// include individual components and styles through module import
import '@kor-ui/kor/components/button'
import '@kor-ui/kor/components/text'
// if using JS, css can also be imported. if using TS, use html stylesheet as shown below
import '@kor-ui/kor/kor-styles.css'
```
*or*
```html
```
---
## Usage
Use the kor components as if they were native HTML tags. All components allow one and two-way data binding and the attributes fire an `-changed` event when modified:
```html
```