/active_admin

The administration framework for Ruby on Rails applications.

Primary LanguageRubyOtherNOASSERTION

Active Admin

Active Admin is a Ruby on Rails framework for creating elegant backends for website administration.

Version Dependencies Travis CI Quality Coverage Gittip

State of the project

We're currently working on 1.0.0, which as far as dependencies, moves us from meta_search to Ransack and adds Rails 4 support. Until it's ready, you can get Rails 4 support today by tracking master:

gem 'activeadmin', github: 'gregbell/active_admin'

On Rails 4.1, you'll also need to declare the following dependencies:

gem 'polyamorous', github: 'activerecord-hackery/polyamorous'
gem 'ransack', github: 'activerecord-hackery/ransack', branch: 'rails-4.1'
gem 'formtastic', github: 'justinfrench/formtastic'

The plan is to follow semantic versioning as of 1.0.0. The 0.6.x line will still be maintained, and we will backport bug fixes into future 0.6.x releases. If you don't want to have to wait for a release, you can track the branch instead:

gem 'activeadmin', github: 'gregbell/active_admin', branch: '0-6-stable'

Please note that http://activeadmin.info is out of date. For the latest docs, check out the Github repo itself.

Links

Goals

  1. Allow developers to quickly create gorgeous administration interfaces (Not Just CRUD)
  2. Build a DSL for developers and an interface for businesses.
  3. Ensure that developers can easily customize every nook and cranny of the interface.
  4. Build common interfaces as shareable gems so that the entire community benefits.

Getting started

Check out the docs!

Need help?

Ask us in IRC (#activeadmin), on the mailing list, or on Stack Overflow.

Want to contribute?

The contributing guide is a good place to start. If you have questions, feel free to ask @seanlinsley.

Dependencies

We try not to reinvent the wheel, so Active Admin is built with other open source projects:

Tool Description
Arbre Ruby -> HTML, just like that.
Devise Powerful, extensible user authentication
Formtastic A Rails form builder plugin with semantically rich and accessible markup
Iconic Icons An excellent SVG icon set designed by P.J. Onori
Inherited Resources Simplifies controllers with pre-built RESTful controller actions
Kaminari Elegant pagination for any sort of collection
Ransack Provides a simple search API to query your data