A Rails engine that helps you put together a super-flexible admin dashboard. Try the demo.
Administrate is heavily inspired by projects like Rails Admin and ActiveAdmin, but aims to provide a better user experience for site admins, and to be easier for developers to customize.
To do that, Administrate follows a few simple rules:
- No DSLs (domain-specific languages)
- Support the simplest use cases, and let the user override defaults with standard tools such as plain Rails controllers and views.
- Break up the library into core components and plugins, so each component stays small and easy to maintain.
Add Administrate to your Gemfile:
# Gemfile
gem "administrate"Re-bundle, then run the installer:
$ rails generate administrate:installRestart your server, and visit http://localhost:3000/admin to see your new dashboard in action.
To customize the appearance, behavior, and contents of the dashboard, see the guides at http://administrate-docs.herokuapp.com.
This repository contains both the source code for Administrate, and a demo Rails app that uses Administrate. The demo app is hosted publicly on Heroku.
- The gem's source code lives in the
administratesubdirectory. - The demo app is at the repository root, in order to support deployment on Heroku.
With this structure, developing a typical feature looks like:
- Add tests in
spec/ - Implement a feature in
administrate/ - Exercise the feature using the root-level rails app (
app/)
Use the following guides for getting things done, programming well, and programming in style.