rlugojr / bootswatch

Themes for Bootstrap

Bootswatch

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

Usage

Download the bootstrap.min.css file associated with a theme and replace Bootstrap's default stylesheet.

The themes are also hosted on BootstrapCDN.

Rails users should check out:

• twitter-bootswatch-rails if using LESS.
• bootswatch-rails if using SASS.

Customization

Bootswatch is open source and you’re welcome to modify the themes.

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

These files are also available in SASS.

Check out the Help page for more details on building your own theme.

API

A simple API is available for integrating your platform with Bootswatch. Send your request to http://api.bootswatch.com/3/.

The swatch objects are returned in an array called themes, each one with the following properties: name, description, preview, thumbnail, css, cssMin, less, and lessVariables.

More info at http://bootswatch.com/help/#api

Contributing

It's through your contributions that Bootswatch will continue to improve. You can contribute in several ways.

Bug Reports: Provide a detailed report of any bugs you encounter and open an issue on GitHub.

Documentation: If you'd like to fix a typo or beef up the docs, you can fork the project, make your changes, and submit a pull request.

Fixes: You're more than welcome to make a fix and submit it as a pull request. When making changes, it's important to keep the CSS, LESS and SASS versions in sync. To do this, be sure to edit the LESS source files for the particular theme, then run the tasks grunt swatch and grunt:convert_less to build the CSS and LESS.

Author

Thomas Park

• http://github.com/thomaspark
• http://thomaspark.co

Thanks

Mark Otto and Jacob Thornton for Bootstrap.

Jenil Gogari for his contributions to the Flatly theme.

James Taylor for cors-lite.

Corey Sewell for SASS conversion.

Copyright and License

Copyright 2014 Thomas Park

Code released under the MIT License.