ActiveBootstrapSkin (emjot's Fork)

Bootstrap skin for Active Admin.

This fork vendors Bootstrap 3.4.1 SCSS directly into the gem (no bootstrap-sass dependency) and uses the modern Sass module system (@use / @forward) for compatibility with dartsass-rails.

Installation

Add the gem to your Gemfile:

gem 'active_bootstrap_skin',
  git:    'https://github.com/emjot/active_bootstrap_skin',
  branch: 'emjot' # or e.g. tag: 'emjot-3.0.0'

bootstrap-sass is not required — Bootstrap styles are included in this gem.

Usage

In active_admin.scss, use active_bootstrap_skin. If you use dartsass-rails, include bootstrap-sprockets-dartsass before it (sprockets-rails >= 3.4.2 is expected). Comment out or remove the default Active Admin stylesheets.

// Active Admin's got SASS!
// @import "active_admin/mixins";
// @import "active_admin/base";

// Active Bootstrap
@use "bootstrap-sprockets-dartsass"; // only if you use dartsass-rails
@use "active_bootstrap_skin";

In active_admin.js, require active_bootstrap_skin for the mobile nav toggle. Bootstrap's JavaScript is not required.

//= require active_admin/base
//= require active_bootstrap_skin

Upgrading

Upgrading from emjot-2.3.2? See UPGRADING-emjot-3.0.md.

Testing

For gem development, compile the skin the same way a consuming app would (Dart Sass via sass-embedded):

bundle install
bundle exec rake test

Optional:

bundle exec rake compile                       # write CSS to tmp/compile/
FATAL_DEPRECATIONS=1 bundle exec rake test     # fail on Sass deprecation warnings

CI runs rake test on pull requests and on pushes to emjot (Ruby 3.2 and 3.3).

Screens