Keen UI is a Vue.js UI library with a simple API, inspired by Google's Material Design.
Keen UI is not a CSS framework. Therefore, it doesn't include styles for a grid system, typography, etc. Instead, the focus is on interactive components that require Javascript. You should be able to use Keen UI with any page layout, structure, or CSS framework.
http://josephuspaye.github.io/Keen-UI/
- Vue.js (v3)
- use keen-ui@0.8.9 for Vue 1.x support.
- use keen-ui@1.x for Vue 2.x support.
Optional
Keen UI supports browsers with native ES2015 support (same as Vue 3).
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 set on <html> can be customized to globally resize the components.
Use as a Vue plugin (globally registers all components):
import { createApp } from "vue";
import * as KeenUI from "keen-ui";
import "keen-ui/keen-ui.css";
const app = createApp();
app.use(KeenUI);Use individual components:
import { createApp } from "vue";
import { UiAlert, UiButton } from "keen-ui";
import "keen-ui/keen-ui.css";
const app = createApp({
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.
The library is made available globally via window.KeenUI so that you can use it on your app instance.
Example:
<!-- Place this in <head> -->
<link rel="stylesheet" href="path/to/keen-ui.min.css" />
<!-- Place this in <body> -->
<div id="app">
<ui-button>{{ message }}</ui-button>
</div>
<script src="path/to/vue.global.prod.js"></script>
<script src="path/to/keen-ui.min.js"></script>
<script>
const app = Vue.createApp({
data() {
return {
message: "Hello world!",
};
},
});
app.use(KeenUI);
app.mount("#app");
</script>You can customize many aspects of Keen UI, including theme colors, component sizes, default props, and more.
See Customization.
Each component is built into a standalone file with all its dependencies included. You can use these 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 many contain overlapping dependencies. As a result, using multiple standalone files may increase the size of your bundle due to duplicate code.
import { createApp } from "vue";
import "keen-ui/src/bootstrap"; // Required when using standalone components, should be imported only once in your project
import UiButton from "keen-ui/lib/UiButton";
import "keen-ui/css/UiButton.css";
const app = createApp({
components: {
UiButton,
},
});Keen UI is open source and released under the MIT Licence.
Copyright (c) 2023 Josephus Paye II.
PS: Made something cool with Keen UI? I would love to know! Tweet to me at @JosephusPaye.