Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The administration framework for Ruby on Rails applications.
Ruby CSS JavaScript

This branch is 2554 commits behind activeadmin:master

Failed to load latest commit information.
app Removing deprecated .scopes styling; hiding .table_tools except for a…
docs Added docs for the updated to the menu system
features Completely refactored the menu system to work with i18n
lib Added docs for the updated to the menu system
script rake tests:major_supported_rails now runs on a fresh gemset
spec Created our own subclass of ActiveModel::Name to work across rails ve…
tasks Set Rails 3.2.0 as default testing rails. Include in major versions.
.document Initial commit to active_admin.
.gitignore rake tests:major_supported_rails now runs on a fresh gemset
.travis.yml Update rubygems on travis before running for Rails 3.2
.yardopts Fixed indentation issue in IndexAsBlog docs
CHANGELOG.md Added docs for the updated to the menu system
CONTRIBUTING.md Quickly fixed a typo in CONTRIBUTING.md
Gemfile Completely refactored the menu system to work with i18n
Guardfile Add guard-rspec and Guardfile.
LICENSE We're in 2011 now, time to update the Copyright year?
README.rdoc Remove step "register ActiveAdmin assets" from README. [ci-skip]
Rakefile More robust scripts, rake tasks and gemfile to run tests against majo…
activeadmin.gemspec Allow any version of inherited resources
cucumber.yml ActiveAdmin::Resource looks up classes at runtime using their name

README.rdoc

Active Admin

Active Admin is a framework for creating administration style interfaces. It abstracts common business application patterns to make it simple for developers to implement beautiful and elegant interfaces with very little effort.

Documentation & Support

Bugs & Feature Requests

Goals

  1. Allow developers to quickly create gorgeous administration interfaces <strong>(Not Just CRUD)</strong>

  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

Active Admin is released as a Ruby Gem. The gem is to be installed within a Ruby on Rails 3 application. To install, simply add the following to your Gemfile:

gem 'activeadmin'

After updating your bundle, run the installer

$> rails generate active_admin:install

The installer creates an initializer used for configuring defaults used by Active Admin as well as a new folder at app/admin to put all your admin configurations.

Migrate your db and start the server:

$> rake db:migrate
$> rails server

Visit localhost:3000/admin and log in using:

  • User: admin@example.com

  • Password: password

Voila! You're on your brand new Active Admin dashboard.

To register your first model, run:

$> rails generate active_admin:resource [MyModelName]

This creates a file at app/admin/my_model_names.rb for configuring the resource. Refresh your web browser to see the interface.

Upgrading

When upgrading to a new version of ActiveAdmin you may need to run

$> rails generate active_admin:assets

Next Steps

The best place to get documentation is at activeadmin.info/documentation.html.

To view a sample Active Admin application, checkout demo.activeadmin.info

If you have any questions, please email the mailing list at groups.google.com/group/activeadmin

Tools Being Used

We believe strongly in not writing code unless we have to, so Active Admin is built using many other open source projects:

InheritedResources

Inherited Resources speeds up development by making your controllers inherit all restful actions so you just have to focus on what is important.

Formtastic

A DSL for semantically building amazing forms.

Devise

User authentication is done using Devise

Kaminari

Pagination for rails apps

Iconic Icons

Excellent SVG icon set designed by P.J. Onori: somerandomdude.com/projects/iconic

Copyright

Copyright © 2011 Greg Bell, VersaPay Corporation. See LICENSE for details.

Something went wrong with that request. Please try again.