janchou / uikit

A lightweight and modular front-end framework for developing fast and powerful web interfaces.

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+ Community - Share news and latest work

Join our developer chat. We are online 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 sync

After running gulp sync 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 and JavaScript files custom prefixed.

gulp -p 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).

Browser Support

Latest ✔	Latest ✔	9+ ✔	7.1+ ✔	Latest ✔

Tested with BrowserStack (thanks for sponsoring!).

Copyright and License

Copyright YOOtheme GmbH under the MIT license.