No commit activity in last 3 years
No release in over 3 years
Flattens the Active Admin interface, and allows easy customisation of your Admin backends
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 3.2.0
 Project Readme

Flattened Active Admin

A customized (and customizable) update to the Active Admin interface

Active Admin is great, but can be a little difficult to customize. The aim of Flattened Active admin is to give the interface a facelift, as well as make it easier to give it that personal touch.

Examples

Look at how good your Active Admin can look!

Example #1

Example #2

Release Notes:

0.0.3

  • Added the ability to set the default font for the interface.
  • Added the ability to change the text colour for action item text in various states.
  • Added the ability to set the font-weight on the title bar.

Installation

Flattened Active Admin has been built to work with the pre-release of Active Admin 1.0 using >= Rails 4. In order to use this gem, please make sure that you are using Active Admin from their Github repo:

gem 'activeadmin', github: 'activeadmin/activeadmin'

Currently Flattened Active Admin does not support earlier versions of Active Admin.

gem 'flattened_active_admin'

and then the usual

bundle install

Usage

Once you have installed the gem, all you have to do is change the hooks in assets/stylesheets/active_admin.scss to point to Flattened Active Admin.

Change:

@import "active_admin/mixins";
@import "active_admin/base";

to:

@import "flattened_active_admin/mixins";
@import "flattened_active_admin/base";

And that's it, welcome to your new interface!

Customisation

Flattened Active Admin allows you to change the color schemes of Activbe Admin with ease, create a completely different look and feel to your interface.

Once you have the flattened interface working, you can include the customisations by running the generator:

rails g flattened_active_admin:variables

This will generate a new SASS file in assets/stylesheets/flattened_active_admin called variables.scss

In order to make these work, add this line TO THE TOP of your active_admin.scss

@import "flattened_active_admin/variables";

Once you have done this you can customise the variables you your hearts content. Anything changed here will override the Active Admin Defaults.

Important

This new line needs to go above all other Active Admin and Flattened Active Admin @import calls, or else they will not work

To Do

  • Test with older versions of active admin
  • Make initialisation of the variables one step less

Contributing

Fork the Repo, and open a pull request.

Please test if your changes require testing

Thanks

A massive thank you to the entire team at Active Admin. They are doing some great things over there, and making a lot of our jobs a lot easier.