Skip to content

theblacksmith/sass-bootswatch

 
 

Repository files navigation

Bootswatch

Bootswatch is a collection of free themes for Twitter Bootstrap. Check it out at bootswatch.com.

Usage

Head over to Bootswatch and download the bootstrap.min.css file associated with a theme. Replace Bootstrap's stylesheet with this file.

The themes are also hosted on BootstrapCDN.

For use with Rails, check out bootswatch-rails (Sass) and twitter-bootswatch-rails (LESS).

Customization

Bootswatch is an open source project, and you’re welcome to modify the themes further. If you’re interested, fork or follow the GitHub repository. The files of interest are in the gh-pages branch.

Each raw theme consists of two LESS files. One is variables.less, which is included by default in Bootstrap and allows you to customize these settings. The other is called bootswatch.less and introduces more extensive structural changes.

Check out the README in the swatchmaker directory for step-by-step instructions on building your own swatch.

API

A simple API is available for integrating your platform with Bootswatch.

The swatch objects are housed in an array called themes, and each swatch has the following properties: name, description, preview, thumbnail, css, css-min, less, and less-variables.

CORS and JSONP are supported. Send your request to http://api.bootswatch.com.

A simple demo, using mustache.js for templating: http://jsbin.com/asowud/1/edit

Feedback

Please send feedback to [email protected]. For more information, visit http://thomaspark.me/2012/02/introducing-bootswatch/.

Author

Thomas Park

Thanks

Mark Otto and Jacob Thornton for Bootstrap.

James Taylor for cors-lite.

Zack Maril for bootswatch/swatchmaker/watcher.rb.

Copyright and License

Copyright 2012 Thomas Park

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Packages

No packages published

Languages

  • JavaScript 94.6%
  • Perl 4.8%
  • Ruby 0.6%