RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.
![Gem Version][gem]
![Build Status][ghactions]
![Coverage Status][coveralls]
![Code Climate][codeclimate]
![SemVer][semver]
[gem]: https://rubygems.org/gems/rails_admin
[ghactions]: https://github.com/railsadminteam/rails_admin/actions/workflows/test.yml
[coveralls]: https://coveralls.io/r/railsadminteam/rails_admin
[codeclimate]: https://codeclimate.com/github/railsadminteam/rails_admin
[semver]: https://dependabot.com/compatibility-score.html?dependency-name=rails_admin&package-manager=bundler&version-scheme=semver
RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.
- Check out [the docs][docs].
- Try the [live demo][demo]. ([Source code][dummy_app])
[demo]: https://rails-admin.fly.dev/admin/
[dummy_app]: https://github.com/railsadminteam/rails_admin/tree/master/spec/dummy_app
[docs]: https://github.com/railsadminteam/rails_admin/wiki
- CRUD any data with ease
- Custom actions
- Automatic form validation
- Search and filtering
- Export data to CSV/JSON/XML
- Authentication (via Devise or other)
- Authorization (via CanCanCan or Pundit)
- User action history (via PaperTrail)
- Supported ORMs
- ActiveRecord
- Mongoid
1. On your gemfile: gem 'rails_admin', '~> 3.0'
2. Run bundle install
3. Run rails g rails_admin:install
4. Provide a namespace for the routes when asked
5. Start a server rails s and administer your data at /admin. (if you chose default namespace: /admin)
Due to introduction of Webpack/Webpacker support, some additional dependency and configuration will be needed.
Running rails g rails_admin:install will suggest you some required changes, based on current setup of your app.
In config/initializers/rails_admin.rb:
To begin with, you may be interested in setting up Devise, CanCanCan or Papertrail!
``ruby
class Ball < ActiveRecord::Base
validates :name, presence: true
belongs_to :player
rails_admin do
configure :player do
label 'Owner of this ball: '
end
end
end
``
Details: Models, Groups, Fields
If you have a question, please check this README, the wiki, and the [list of
known issues][troubleshoot].
[troubleshoot]: https://github.com/railsadminteam/rails_admin/wiki/Troubleshoot
If you still have a question, you can ask the [official RailsAdmin mailing
list][list].
[list]: http://groups.google.com/group/rails_admin
If you think you found a bug in RailsAdmin, you can submit an issue.
This library aims to support and is [tested against][ghactions] the following Ruby implementations:
- Ruby 2.6
- Ruby 2.7
- Ruby 3.0
- Ruby 3.1
- Ruby 3.2
- [JRuby][]
[jruby]: http://jruby.org/