Super
Super is an admin framework for Ruby on Rails applications. It helps you make admin pages quickly, and it provides a powerful interface for admins to use.
Check out the demo / Read the docs
Features
Ease of use and setup
- Configurable display pages
- Advanced filtering and sorting
- Supports showing computed values that aren't backed by database fields
- Configurable form pages
- Supports nested attributes using
accepts_nested_attributes_for
- Supports having different forms for new and edit pages
- Supports nested attributes using
- Controllers that can automatically configure itself for any ActiveRecord model
- Compatible with Sprockets, Webpacker, jsbundling, and cssbundling
- Responsive and mobile-friendly web pages
Ease of customization
- Plenty of escape hatches for those very customized pages
- Builds on top of standard Rails controllers and ERB views
- No DSL. Configure your admin pages by setting attributes and returning objects
Ease of long-term maintainability
Each gem in your Gemfile requires some maintenance around keeping dependencies up to date. Super works hard to keep its maintenance as simple as possible.
Note: Super is under active development and will likely have a few more breaking changes before 1.0.
- Only depends on code that comes with Rails or Ruby. There are no other third-party dependencies
- Includes pre-built frontend assets. Super doesn't depend on Sass, PostCSS, Babel, etc
- Supports Rails 5.0+, 6.0+, 7.0+
- Supports Ruby 2.3+, 3.0+
See the demo and its source for an example of some of its features. See the docs for a walkthrough.
Quick start
Install Super by running:
bundle add super
bin/rails g super:install
You can create admin pages by running this for all the models you want:
bin/rails g super:resource ModelName
Contributing
See CONTRIBUTING
License
The gem is available under the terms of the GNU LGPLv3.