UIkit
UIkit is a lightweight and modular front-end framework for developing fast and powerful web interfaces.
- Homepage - Learn more about UIkit
- @getuikit - Get the latest buzz on Twitter
- Google+ - Share news and latest work
- Issues - Report bugs
- Developer Chat - Every work day between 8:00 and 18:00 UTC
Getting started
You have following options to get UIkit:
- Download the latest release
- Clone the repo,
git clone git://github.com/uikit/uikit.git. - Install with Bower:
bower install uikit
You find the compiled UIkit distribution in its own repo.
Developers
First of all, install Node. We use Gulp to build UIkit. If you haven't used Gulp before, you need to install the gulp package as a global install.
npm install --global gulp
If you haven't done so already, clone the UIkit git repo.
git clone git://github.com/uikit/uikit.git
Install the Node dependencies.
cd uikit
npm install
Run gulp to lint, build and minify the release.
gulp [-t themename]
The built version of UIkit will be put in the /dist subdirectory. Pass a theme name parameter to only build the specified theme.
Browsersync
gulp watch
After running gulp watch a new browser instance will open, pointing to the uikit folder - http://localhost:3000/. The browser window will reload anytime you modify a source file.
Custom prefix
Run gulp with your own prefix parameter -p to have all classes custom prefixed.
gulp -p myprefix
To use JavaScript with your custom build just call the noConflict method with your prefix as a parameter after including UIkit.
var myUIkit = UIkit.noConflict('myprefix');
Contributing
UIkit follows the GitFlow branching model. The master branch always reflects a production-ready state while the latest development is taking place in the develop branch.
Each time you want to work on a fix or a new feature, create a new branch based on the develop branch: git checkout -b BRANCH_NAME develop. Only pull requests to the develop branch will be merged.
Versioning
UIkit is maintained by using the Semantic Versioning Specification (SemVer).
Credits
We built UIkit using popular open source projects.
- jQuery (MIT License)
- normalize.css (MIT License)
- FontAwesome (CC BY 3.0 License)
Copyright and license
Copyright 2014 YOOtheme GmbH under the MIT license.