administrate

A Rails engine that helps you put together a super-flexible admin dashboard.

5318
1000
Ruby

Administrate

CircleCI
Gem Version
Code Climate
Reviewed by Hound

A framework for creating flexible, powerful admin dashboards in Rails.
Try the demo.

Warning:

Administrate is still pre-1.0,
and there may be occasional breaking changes to the API.
Check the release notes for important updates.

administrate

What Is Administrate?

Administrate is a library for Rails apps
that automatically generates admin dashboards.
Administrate’s admin dashboards give non-technical users clean interfaces
that allow them to create, edit, search, and delete records
for any model in the application.

Administrate solves the same problem as Rails Admin and ActiveAdmin,
but aims to provide a better user experience for site admins,
and to be easier for developers to customize.

To accomplish these goals, Administrate follows a few guiding principles:

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

Documentation

To customize the appearance, behavior, and contents of the dashboard,
we publish a set of guides for the current release.

These guides are available as markdown files in the docs subdirectory of the
git repository, too.

We publish docs for the upcoming release, which you can find at our prerelease
app
.

Contributing

Please see CONTRIBUTING.md.

Administrate was originally written by Grace Youngblood and is now maintained by
Nick Charlton. Many improvements and bugfixes were contributed by the open
source
community
.

License

administrate is Copyright © 2015 thoughtbot.
It is free software, and may be redistributed under the terms specified in the
LICENSE file.

About thoughtbot

thoughtbot

This repo is maintained and funded by thoughtbot, inc.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software!
See our other projects.
We are available for hire.