gitwtfhub

wtf is bootswatch?

thomaspark/bootswatch — explained in plain English

Analysis updated 2026-06-24

14,763JavaScriptAudience · developerComplexity · 1/5LicenseSetup · easy

TL;DR

Collection of drop-in open-source themes for Bootstrap, swap one CSS file (or two Sass files) to restyle a Bootstrap site.

Mindmap

mindmap
  root((bootswatch))
    Inputs
      Bootstrap site
      Sass variables
      Theme choice
    Outputs
      bootstrap.min.css per theme
      Sass files
      Live previews
    Use Cases
      Restyle a Bootstrap project
      Customize via Sass
      Use via npm or gem or CDN
    Tech Stack
      Bootstrap
      Sass
      CSS
      npm

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Swap a Bootstrap site's default CSS for a Bootswatch theme via CDN

REASON 2

Customize a theme by editing _variables.scss and rebuilding with Sass

REASON 3

Install a theme via npm into a create-react-app project

What's in the stack?

BootstrapSassCSSJavaScriptnpm

How it stacks up

thomaspark/bootswatchhapijs/hapibrowserify/browserify
Stars14,76314,78314,718
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity1/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min
MIT: free to use, modify, and redistribute with attribution, no warranty.

Wtf does this do

Bootswatch is a collection of open-source themes for Bootstrap, the popular CSS framework from Twitter that gives a website a set of ready-made styles for buttons, forms, navigation bars, and so on. Each Bootswatch theme is a drop-in restyling of Bootstrap. Instead of writing CSS to make a Bootstrap site look different, you use one of these themes and the same Bootstrap components take on a new look. Live previews of every theme are at bootswatch.com. The README walks through several ways to use the themes. The simplest is to download a pre-compiled bootstrap.min.css file for the theme you want and use it in place of Bootstrap's default stylesheet, while still loading Bootstrap's JavaScript for things like dropdowns and modals to keep working. A jsDelivr CDN URL is offered for people who prefer not to host the file themselves. For projects that build CSS from Sass source, the README shows how to import the theme's _variables.scss before Bootstrap's own bootstrap.scss and then import _bootswatch.scss after it, which is the order needed for variable overrides to take effect. There is also an npm install path with a note for React projects built with create-react-app on how to import the chosen theme's CSS in index.js or App.js. A Ruby gem version is described for Ruby and Rails projects, and a small JSON API exists for platforms that want to query Bootswatch programmatically. Each theme is made up of two Sass files: _variables.scss for setting customizations and _bootswatch.scss for more structural changes. The project is by Thomas Park, with code released under the MIT License and ongoing maintenance help from XhmikosR.

Yoink these prompts

Prompt 1
Swap my existing Bootstrap site to the Bootswatch Cosmo theme via jsDelivr CDN
Prompt 2
Set up a Sass build that imports a Bootswatch theme's _variables.scss and _bootswatch.scss correctly
Prompt 3
Add a Bootswatch theme to a create-react-app project and switch themes at runtime
Prompt 4
Compare two Bootswatch themes side-by-side for a finance dashboard look

Frequently asked questions

wtf is bootswatch?

Collection of drop-in open-source themes for Bootstrap, swap one CSS file (or two Sass files) to restyle a Bootstrap site.

What language is bootswatch written in?

Mainly JavaScript. The stack also includes Bootstrap, Sass, CSS.

What license does bootswatch use?

MIT: free to use, modify, and redistribute with attribution, no warranty.

How hard is bootswatch to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bootswatch for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.