bootstrap_sb_admin_base_v2
bootstrap_sb_admin_base_v2 copied to clipboard
Rails gem of the Bootstrap based admin theme SB Admin 2.
About
bootstrap_sb_admin_base_v2 is a (work in progress) Rails gem of the Bootstrap based admin theme SB Admin 2. Originally created by Start Bootstrap, all the credits of the development of the Bootstrap admin theme are of them. This is just and adaptation into Rails gem in order to make it easier to integrate all the assets (fonts, images, css and js) into a Rails application.
You can check the original Bootstrap admin theme repository here.
Installation
Add this line to your application's Gemfile:
gem 'bootstrap_sb_admin_base_v2'
And then execute:
$ bundle
Or install it yourself as:
$ gem install bootstrap_sb_admin_base_v2
Usage
Version 0.2.x and below
After install the gem, the only thing you should do in your Rails application is add some lines into your manifests files. Add this into your application.js
file:
//= require bootstrap_sb_admin_base_v2
and this line into you application.css
file:
*= require bootstrap_sb_admin_base_v2
Version 0.3.x and above
On version 0.3.x or above has been added two dependencies: jquery-rails
and font-awesome-rails
in order to keep updated the versions of jQuery and font-awesome, so be sure to require jquery-rails
on your application.js
before require the bootstrap_sb_admin_base_v2
file like so:
//= require jquery
//= require jquery_ujs
//= require bootstrap_sb_admin_base_v2
and on the application.css
file, be sure to require the font-awesome-rails
file:
*= require font-awesome
*= require bootstrap_sb_admin_base_v2
RTL Version
If you need the RTL version of the template, add this line into you application.css
instead of the previous one:
*= require bootstrap_sb_admin_base_v2_rtl
You can check the RTL version I've used to add this adaptation here.
And you're ready to use the HTML structure of the Bootstrap based admin theme SB Admin 2 on your Rails application. All the details and documentation about this are here.
If you need an example to see how to integrate the gem into your Rails project, I've developed a simple Rails application in order to test the gem, you can check this app here: https://sensor-admin-panel-testing.herokuapp.com (test email: [email protected], password: 123456example), and here you have the Github repo to be able to check the code: https://github.com/dreamingechoes/sensors_admin_panel.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/dreamingechoes/bootstrap_sb_admin_base_v2. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.