Protoadmin is ready to go out of the box without having to worry about finding / patching several of the things that it utilizes together yourself. The intention of this project isn't to provide a one size fits all sort of thing, and is more about providing an awesome starting point that you can easily utilize and that doesn't get in your way.
You can even drop it into an existing project and start getting benefits right away. It expects only that you start
adding some css classes to elements and
that it ships with.
Protoadmin is not an admin system like Rails Admin (also a great tool) that tries to render the database generically, but rather a framework that provides generators and the ability to follow your standard workflow with a Rails app.
It's not expected that everyone will agree on what Protoadmin provides, but if you're into these things it'll get you going quickly and without fuss.
Here's some of the great libraries that Protoadmin utilizes:
- Twitter Bootstrap (bootstap-sass)
- Font Awesome
- Devise (with an admin resource)
- Simple Form (with bootstrap support)
Include the gem in your Gemfile and bundle to install the gem.
Run the install generator.
rails g protoadmin:install
Migrate the database to get the admin table, and a default admin user (only in development).
Start, and navigate to your server (http://localhost:3000/admin)[http://localhost:3000/admin] and provide the credentials that you entered when you installed. The default credentials are:
Any controller that you want to be part of the admin interface should inherit from
class ArticlesController < Protoadmin::ApplicationController
The install generator puts a
protoadmin.rb file into your
config/initializers path. This file can be adjusted to
provide additional navigation as well providing the devise and simple_form configurations.
Licensed under the MIT License
Copyright 2012 Jeremy Jackson