https://github.com/maxim/bootswatch-rails
Bootswatches converted to SCSS ready to use in Rails asset pipeline.
https://github.com/maxim/bootswatch-rails
bootstrap-sass bootswatch templates
Last synced: about 2 months ago
JSON representation
Bootswatches converted to SCSS ready to use in Rails asset pipeline.
- Host: GitHub
- URL: https://github.com/maxim/bootswatch-rails
- Owner: maxim
- License: mit
- Archived: true
- Created: 2012-03-16T01:30:44.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2019-01-09T20:09:54.000Z (about 7 years ago)
- Last Synced: 2025-11-12T15:13:06.897Z (about 2 months ago)
- Topics: bootstrap-sass, bootswatch, templates
- Language: Ruby
- Homepage:
- Size: 557 KB
- Stars: 485
- Watchers: 16
- Forks: 81
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ruby - bootswatch-rails
README
# Looking for contributors
If you'd like to try your hand at maintaining this project, I'm happy to give you commit access.
# bootswatch-rails
[](http://badge.fury.io/rb/bootswatch-rails)
This gem is meant to be used with
[bootstrap-sass](https://github.com/thomas-mcdonald/bootstrap-sass). It gives
you complete scss versions of [bootswatches](http://bootswatch.com) for use in
your Rails asset pipeline, just like bootstrap-sass gives you scss version of
bootstrap itself.
## Installation
Add this line to your application's Gemfile, in assets group:
gem 'bootswatch-rails'
And then execute:
$ bundle
## Usage
When using bootstrap-sass, it's recommended to avoid sprockets in your
stylesheets. In order to do that you simply rename your `application.css` file
to `application.css.scss`, remove all sprockets comments, and instead use sass
`@import` commands. These commands are smart enough to fully support asset
pipeline load paths, thanks to `sass-rails` gem.
Here's approximately how your `application.css.scss` file should look like,
considering that you're using
[bootstrap-sass](https://github.com/thomas-mcdonald/bootstrap-sass).
````sass
// Example using 'Cerulean' bootswatch
//Import bootstrap-sprockets
@import "bootstrap-sprockets";
// Import cerulean variables
@import "bootswatch/cerulean/variables";
// Then bootstrap itself
@import "bootstrap";
// Bootstrap body padding for fixed navbar
body { padding-top: 60px; }
// And finally bootswatch style itself
@import "bootswatch/cerulean/bootswatch";
// Whatever application styles you have go last
@import "base";
````
### Overriding bootswatch variables
Since version 3.1 it's possible to override variables.
````sass
// First set or import your overrides
$textColor: #000;
// Then load variables
@import "bootswatch/journal/variables";
// Then the rest as shown above...
````
## Bootswatches
Included bootswatches
* Amelia
* [Cerulean](http://bootswatch.com/cerulean/)
* [Cosmo](http://bootswatch.com/cosmo/)
* [Cyborg](http://bootswatch.com/cyborg/)
* [Darkly](http://bootswatch.com/darkly/)
* [Flatly](http://bootswatch.com/flatly/)
* [Journal](http://bootswatch.com/journal/)
* [Lumen](http://bootswatch.com/lumen/)
* [Paper](http://bootswatch.com/paper/)
* [Readable](http://bootswatch.com/readable/)
* [Sandstone](http://bootswatch.com/sandstone/)
* [Simplex](http://bootswatch.com/simplex/)
* [Slate](http://bootswatch.com/slate/)
* [Spacelab](http://bootswatch.com/spacelab/)
* [Superhero](http://bootswatch.com/superhero/)
* [United](http://bootswatch.com/united/)
* [Yeti](http://bootswatch.com/yeti/)
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
Please see [CONTRIBUTING](https://github.com/maxim/bootswatch-rails/blob/master/CONTRIBUTING.md) for more detail. (Dont change the scss files by hand, use the converter and rearranger first, and make your changes in those if possible)
#### Note about converter
I am trying to automate this project as much as possible, so I wrote a script
that does most of the work converting less to scss. If you want to contribute a
fix that's easily automatable and you know ruby, please add a processor to the
converter.
## Credits
Big thanks to these guys.
* [Thomas Park](http://github.com/thomaspark) for [bootswatch](http://bootswatch.com/)
* [Thomas McDonald](http://github.com/thomas-mcdonald) for [bootstrap-sass](https://github.com/thomas-mcdonald/bootstrap-sass)