thomaspark/bootswatch

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.