File Structure
The compiled library contains the necessary files to get up and running:
wvus.uikit/
├── css/
│ ├── wvus.uikit.css
│ ├── wvus.uikit.css.map
│ └── wvus.uikit.min.css
├── js/
│ ├── wvus.uikit.js
│ └── wvus.uikit.min.js
├── img/
│ └── ico/
│ └── (favicons)
| └── checkbox-radio
| └── sector
| └── play
├── less/
│ ├── variables.less
│ └── mixins.less
│ └── mixins/
│ └── (mixins in module files)
└── fonts/
├── (Bootstrap Glyphicon)
└── (Font Awesome)
Include
Including the UiKit is simple:
Add the CSS files:
<!DOCTYPE html>
<html>
<head>
<!-- CSS (use minified versions on production sites) -->
<link rel="stylesheet" type="text/css" href="/path/to/uikit/css/wvus.uikit.min.css">
</head>
<body>
...
Add the JavaScript files:
...
<script src="/path/to/uikit/js/jquery.min.js"></script>
<script src="/path/to/uikit/js/wvus.uikit.min.js"></script>
</body>
</html>
Add the CSS namespace:
<!DOCTYPE html>
<html class="wvusUikit">
<head>
...
Note: the UiKit uses a CSS and JavaScript namespace. See namespace section.
Responsive
Tell browsers how they should scale to your site by including a <meta name="viewport">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
Project Use
If the compiled CSS doesn’t provide enough flexibility for your project, we have that covered. The variables.less and mixins.less have been extracted to be included in a projects stylesheet.
- Variables.less contains all of the colors, fonts, and basic sizing
- Mixins.less contains mixins for easily creating background effects, applying border radius, gradients, etc
Include both of these in a LESS file to use with custom styles for a site. A starter.less can be found in the less folder.
Example less file:
/* Start a less file by importing the variables.less and mixins.less */
@import "/path/to/uikit/less/variables.less";
@import "/path/to/uikit/less/mixins.less";
/* Start LESS code */
FYI: Be sure to checkout the LESS docs for more help