The administration framework for Ruby on Rails applications.
Ruby Cucumber CSS HTML CoffeeScript
Pull request Compare This branch is 96 commits behind activeadmin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
config/locales
docs
features
lib
script
spec
tasks
.gitignore
.hound.yml
.travis.yml
.yardopts
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Gemfile
Guardfile
LICENSE
README.md
Rakefile
activeadmin.gemspec
cucumber.yml

README.md

Active Admin

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

Version         Travis CI       Quality         Coverage        Inch CI

State of the project

1.0.0

We're currently working on 1.0.0, which as far as dependencies, moves us from meta_search to Ransack and adds Rails 4 & 5 support.

You can get it by tracking master:

gem 'activeadmin', github: 'activeadmin'

Or you can using rubygems:

gem 'activeadmin', '~> 1.0.0.pre2'

Keep in mind that during the time where we use pre-release label, things can break in each release!

Rails 5

Active Admin master has preliminary support for Rails 5. To give it a try, these Gemfile changes may be needed:

gem 'devise',      '> 4.x'
gem 'rspec-rails', '>= 3.5.0.beta1'
gem 'ransack',    github: 'activerecord-hackery/ransack'
gem 'kaminari',   github: 'amatsuda/kaminari', branch: '0-17-stable'
gem 'formtastic', github: 'justinfrench/formtastic'
gem 'draper',     github: 'audionerd/draper', branch: 'rails5', ref: 'e816e0e587'
# To fix a Draper deprecation error
gem 'activemodel-serializers-xml', github: 'rails/activemodel-serializers-xml'
# Optional -- only if you already include these gems
gem 'rack-mini-profiler',          github: 'MiniProfiler/rack-mini-profiler'
gem 'database_cleaner',            github: 'pschambacher/database_cleaner', branch: 'rails5.0', ref: '8dd9fa4'
# Only for JRuby:
gem 'activerecord-jdbc-adapter',   github: 'jruby/activerecord-jdbc-adapter', platforms: :jruby

If something isn't working for you please report it on #4177.

0.6.x

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: 'activeadmin', branch: '0-6-stable'

Documentation

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

Links

Goals

  1. Enable developers to quickly create good-looking administration interfaces.
  2. Build a DSL for developers and an interface for businesses.
  3. Ensure that developers can easily customize every nook and cranny.

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 or @captainhagbard.

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
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