Quick Start

Using the themes is as easy as downloading a CSS file and replacing the one that comes with Bootstrap.

You can install as a package via npm with the command npm install bootswatch.

You can also hotlink the themes via CDN at BootstrapCDN.

Customization

To modify a theme or create your own, follow the steps below in your terminal. You'll need to have Git and Node installed.

Download the repository: git clone https://github.com/thomaspark/bootswatch.git
Install dependencies: npm install
Make sure that you have grunt available in the command line. You can install grunt-cli as described on the Grunt Getting Started page.
In /dist, modify _variables.scss and _bootswatch.scss in one of the theme directories, or duplicate a theme directory to create a new one.
Type grunt swatch:[theme] to build the CSS for a theme, e.g., grunt swatch:flatly for Flatly. Or type grunt swatch to build them all at once.
You can run grunt to start a server, watch for any changes to the SASS files, and automatically build a theme and reload it on change. Run grunt server for just the server, and grunt watch for just the watcher.

Here are additional tips for customizing Bootstrap.

API

You can use the API to integrate the themes with your platform. Get:

https://bootswatch.com/api/4.json

This returns an object with a version and a themes property. themes is an array with the following properties:

name
description
preview
thumbnail
css
cssMin
cssCdn
scss
scssVariables

Here's a demo of the API in action.

Tools

GlyphSearch is a tool for searching icons from Glyphicons, Font Awesome, and other popular icon font libraries.

FontCDN is a tool for searching web fonts from Google Fonts.

Donate

Donations are gratefully accepted via PayPal and Bitcoin at 1EMqwwjqJrfyoPqmxNM7buzU6DmySZnHBK.

You can also show your support for Bootswatch by buying official gear. T-shirts based on several themes including Cyborg, Flatly, and Slate are available at Spreadshirt.

Stickers are available at Sticker Mule.