Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/availity/availity-uikit

Availity UI Kit powered by Bootstrap 4
https://github.com/availity/availity-uikit

availity availity-uikit bootstrap css css-framework ui uikit

Last synced: about 9 hours ago
JSON representation

Availity UI Kit powered by Bootstrap 4

Awesome Lists containing this project

README

        

# availity-uikit

> Availity UI Kit powered by [Bootstrap 4](http://v4-alpha.getbootstrap.com/) with modifications to match Availity style guidelines

[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge&logo=MIT)](http://opensource.org/licenses/MIT)
[![NPM](http://img.shields.io/npm/v/availity-uikit.svg?style=for-the-badge&&logo=npm)](https://npmjs.org/package/availity-uikit)

## Table of Contents

- [Demo](#demo)
- [Supported Browsers](#supported-browsers)
- [Quickstart](#quickstart)
- [Icon Fonts](#icon-fonts)
- [Contributing](#contributing)
- [Authors](#authors)
- [Disclaimer](#disclaimer)
- [License](#license)

## Demo

[http://availity.github.io/availity-uikit/v4](http://availity.github.io/availity-uikit/v4)

## Supported Browsers

- Google Chrome
- Mozilla Firefox
- Microsoft Edge

## Installation

Add the `availity-uikit` with the package manager of your choice

npm

```bash
npm install availity-uikit --save
```

or

Yarn

```bash
yarn add availity-uikit
```

## Icon Fonts

Availity uses [Fontello](http://fontello.com/) to manage icon fonts. Our [font configuration](./packages/uikit/fonts/config.json) can be used on Fontello to edit the font catalog.

### Updating Fonts

- Upload configuration to [Fontello](http://fontello.com/)
- After making changes, download zip and extract `font` folder into the uikit [font](./packages/uikit/fonts/)
- Replace the [font configuration](./packages/uikit/fonts/config.json) with the new one
- `yarn update-fonts` and commit changes

You can find more information on this process [here](https://github.com/fontello/fontello/wiki/How-to-save-and-load-projects)

## Contributing

This monorepo is managed with `yarn workspaces`. If you do not have `yarn` installed already then you will need to install it globally

```bash
npm i -g yarn
```

Install the dependencies

```bash
yarn install
```

Run the development server. Once running, it can be located at [http://localhost:8000](http://localhost:8000)

```bash
yarn start
```

Once the code has been merged into `master`, then you will need to publish the package to `npm`

```bash
yarn release
```

With the code published and the changes in GitHub, we will then need to deploy to `gh-pages`

```bash
yarn deploy
```

## Disclaimer

Open source software components distributed or made available in the Availity Materials are licensed to Company under the terms of the applicable open source license agreements, which may be found in text files included in the Availity Materials.

## License

[MIT](./LICENSE)