Built according to Cubefuse branding on top of Bootstrap (4.1.3), Qube provides a solid foundation for web projects, while being lightweight with a stylesheet weighing just 13.5kb.
### Getting Started
Qube can be installed with `npm` or `yarn`
```bash
npm install --save @cubefuse/qube bootstrap
yarn add @cubefuse/qube bootstrap
```
The distributed Qube assets are also available via CDN through [unpkg](https://unpkg.com/@cubefuse/qube@latest/) and [jsDelivr](https://cdn.jsdelivr.net/npm/@cubefuse/qube@latest/).
### Dependencies
The only hard dependency is Bootstrap 4 (final) which needs to be included in your HTML document before Qube. Datepickers and slider controls also require the Qube JavaScript dependency.
### Quick Start
If you're using a bundler like `webpack`, you should skip to [Usage with Bundlers](#usage-with-bundlers).
In order to take advantage of both Bootstrap and Qube' features you may want to use the following starter template that includes all dependencies.
```html
Hello, world!
```
### Usage with Bundlers
If you're using a bundler like [`webpack`](https://webpack.js.org) (with [`style-loader`](https://github.com/webpack-contrib/style-loader)/[`css-loader`](https://github.com/webpack-contrib/css-loader)) or [`parcel`](https://parceljs.org), you can [install `qube` with `npm`](#getting-started) and import it:
```javascript
// app.js
import 'bootstrap/dist/css/bootstrap.min.css';
import '@cubefuse/qube/dist/css/qube.min.css';
// Optional JavaScript
// JavaScript Dependencies: jQuery, Popper.js, Bootstrap JS, Qube JS
// Install them with `npm` as well
import 'jquery/dist/jquery.slim.min';
import 'popper.js/dist/umd/popper.min';
import 'bootstrap/dist/js/bootstrap.min';
import '@cubefuse/qube/dist/js/qube.min';
```
### Built using
* [Shards by DesignRevision (MIT License)](https://designrevision.com/downloads/shards/)
* [Bootstrap by Bootstrap team (MIT License)](https://getbootstrap.com)
* [Bootstrap Datepicker by Stefan Petre and Andrew Rowls (Apache 2.0)](https://github.com/uxsolutions/bootstrap-datepicker)
* [noUiSlider by Léon Gersen (WTFPL License)](https://refreshless.com/nouislider/download/)
* [Material Icons](http://material.io/icons)
* [FontAwesome Icons](http://fontawesome.io)
### Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
### Acknowledgments
While building this project we used various free resources built and made
available by some wonderful people around the world. See the [ATTRIB.md](ATTRIB.md) file for details.
### Changelog
[View notable changes.](CHANGELOG.md)
