Keen UI is a lightweight Vue.js UI library with a simple API. The design is inspired by Google's Material Design. However, Keen UI is not meant to be a full implementation of the Material Design spec.
Keen UI is not a CSS framework. As such, it doesn't include a grid system, typography styles, etc. Instead, the focus is on interactive components that require Javascript.
http://josephuspaye.github.io/Keen-UI/
- Vue.js (^v2.1.4) - use [email protected] for Vue 1.x support.
Optional
- Roboto font (Normal 400, Medium 500)
- Material Icons font
IE 10+ (due to Flexbox support).
npm install keen-ui --saveBefore using Keen UI, ensure that the following CSS resets are applied to your site.
*,
*::before,
*::after {
box-sizing: border-box;
}
html {
font-size: 100%;
}You can add the reset to your stylesheet (before other styles). If you are using a CSS framework, check to see if the framework already includes a reset (most CSS frameworks do). The root font size can be customized to globally resize the components.
Use as a plugin (registers all components with Vue globally):
import Vue from 'vue';
import KeenUI from 'keen-ui';
import 'keen-ui/dist/keen-ui.css';
Vue.use(KeenUI);
new Vue({
components: {
// all Keen UI components already registered
}
});Use individual components:
import Vue from 'vue';
import { UiAlert, UiButton } from 'keen-ui';
new Vue({
components: {
UiAlert,
UiButton
}
});First, add a stylesheet link to the Keen UI CSS file in dist/keen-ui.min.css. Then, add a script tag pointing to dist/keen-ui.min.js after adding Vue.
If Keen UI detects Vue globally, all the components will be registered automatically. The components will also be made available globally via window.KeenUI.
Example:
<!-- Place this in the <head> -->
<link rel="stylesheet" href="path/to/keen-ui.min.css">
<!-- Place this in the <body> -->
<div id="app">
<ui-button>Hello world!</ui-button>
</div>
<script src="path/to/vue.js"></script>
<script src="path/to/keen-ui.min.js"></script>
<script>
new Vue({
el: '#app',
components: {
// all Keen UI components already registered
}
});
</script>Each component has been built into a standalone file with CSS included. You can use individual standalone components without importing the rest of the library. The standalone components are located in the lib/ folder.
NOTE: Standalone component files each contain their own dependencies and a lot them contain overlapping dependencies. As such, using multiple standalone files could significantly increase the size of your bundle due to duplicate code, and is not recommended unless you are using only a handful of components.
import Vue from 'vue';
import 'keen-ui/src/bootstrap'; // Required when using standlone components, should be imported only once in your project
import UiButton from 'keen-ui/lib/UiButton';
new Vue({
components: {
UiButton
}
});- Test browser compatibility (IE 10+)
- Chrome, IE, Edge, Firefox on Windows
- Chrome, Safari, Firefox on macOS
- Add new components
- Tooltip
- Slider
- Select
- Datepicker
- File upload
- Add customization guide
- Add automated tests
Keen UI is open source and released under the MIT Licence.
Copyright (c) 2016-2017 Josephus Paye II.
PS: I would love to know how you're using Keen UI. Tweet to me at @JosephusPaye.