Project

super

0.03
There's a lot of open issues
No release in over a year
A simple, powerful, zero dependency Rails admin framework
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 5.0
 Project Readme

Super

Unit tests status Gem

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