mindsmash-ui v0.3.4
mindsmash-ui
A Bootstrap 3 UI Kit by mindsmash.
Contents
- Change log
- Install with bower
- Use in an SCSS project
- Use in a CSS project
- Change and publish mindsmash-ui itself
Change log
Release | What's new |
---|---|
0.2.4 | Fix rounded corners on panel header image |
0.2.3 | Small fixes, improved README |
0.2.0 | Load other fonts. Please update the google font <link> |
Add color classes, button sizes and first panels | |
Add documentation (see dist/docs/) |
Heads up! This theme uses a non-default font called "Source Sans Pro". Please add the following line of code to your
<head>
:<link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,400italic" rel="stylesheet">
Install with bower to use the theme (CSS or SCSS version)
$ bower install mindsmash-ui
Use in a Sass (SCSS) project
Include the theme variables before adding any bootstrap files
You need to install boostrap yourself (
$ bower install bootstrap-sass
), as it is no dependency of this project (the css version already includes bootstrap).
@import "path/to/mindsmash-ui/dist/scss/variables"; // to override bootstrap's variables
@import "/path/to/bootstrap-sass/assets/stylesheets/bootstrap"; // load original bootstrap
@import "path/to/mindsmash-ui/dist/scss/mindsmash-ui"; // then load our own styles
Use with pure CSS
Include the mindsmash-ui.css to your website, it includes the complete bootstrap css files:
<head>
<!-- add the mindsmash-ui theme -->
<link rel="stylesheet" href="path/to/mindsmash-ui/css/mindsmash-ui.css">
<!-- then add your custom styles -->
<link rel="stylesheet" href="path/to/custom.css">
</head>
Install with npm to change and deploy the theme
You need:
- node.js with npm
- gulp
Clone the project, then follow the instructions below.
Development mode
$ npm install
Install all dependencies
$ gulp dev
Start development mode: a demo page is started. Edit html or scss and see updates in realtime
Publish a new version
$ gulp build
Create new release files in dist/
.
$ npm login
Login as npm project owner (if you work for mindsmash, look in the project wiki for credentials).
$ npm version <patch|minor|major>
Automatically update package.json and create a git tag.
$ npm publish
Publish the new version on npm
$ git push --follow-tags
Push the tagged version, this creates a new bower version.
Contribute
If you want to contribute to this project, simply fork it on Github, do your changes and create a pull request that describes your changes. If it's all nice and clean, it might get merged.