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.
<img src=“http://travis-ci.org/gregbell/active_admin.png” />
-
Documentation & Guides: activeadmin.info/documentation.html
-
Mailing list: groups.google.com/group/activeadmin
-
Bug reports: github.com/gregbell/active_admin/issues
-
RDoc: rubydoc.info/github/gregbell/active_admin/master/frames
-
Live demo: demo.activeadmin.info/admin
-
Website: www.activeadmin.info
-
Allow developers to quickly create gorgeous administration interfaces <strong>(Not Just CRUD)</strong>
-
Build a DSL for developers and an interface for businesses.
-
Ensure that developers can easily customize every nook and cranny of the interface.
-
Build common interfaces as shareable gems so that the entire community benefits.
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:
# Gemfile in Rails <= 3.1 gem 'activeadmin'
If you are using Rails >= 3.1, you must also include a beta version of MetaSearch and sass-rails:
# Gemfile in Rails >= 3.1 gem 'activeadmin' gem 'sass-rails'
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: [email protected]
-
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.
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
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
We are using the awesome Github issues! Please submit bugs or features to github.com/gregbell/active_admin/issues
-
Fork the project.
-
Make a NEW TOPIC BRANCH, then make your feature addition or bug fix
-
Add specs and cukes for it. This is important so I don’t break it in a future version unintentionally.
-
Commit, do not mess with rakefile, version, or history.
-
Send a pull request.
Copyright © 2010 Greg Bell, VersaPay Corporation. See LICENSE for details.