Skip to content

railsadminteam/rails_admin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f4cf4b6 · Dec 8, 2024
Nov 23, 2024
Oct 6, 2024
Aug 18, 2024
Nov 23, 2024
Dec 8, 2024
Nov 23, 2024
Sep 1, 2024
Dec 5, 2022
Jun 19, 2022
Jun 19, 2022
Nov 28, 2021
Aug 18, 2024
Aug 18, 2024
Jul 28, 2014
May 6, 2011
Nov 23, 2024
Dec 8, 2024
Nov 23, 2022
Nov 23, 2024
Jan 3, 2016
Jul 28, 2014
Aug 6, 2023
Feb 27, 2022
Dec 8, 2024
Nov 23, 2024

Repository files navigation

RailsAdmin

Gem Version Build Status Coverage Status Code Climate SemVer

RailsAdmin is a Rails engine that provides an easy-to-use interface for managing your data.

Getting started

Features

  • 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

Installation

  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)

Upgrading from 2.x

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.

Configuration

Global

In config/initializers/rails_admin.rb:

Details

To begin with, you may be interested in setting up Devise, CanCanCan or Papertrail!

Per model

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

Support

If you have a question, please check this README, the wiki, and the list of known issues.

If you still have a question, you can ask the official RailsAdmin mailing list.

If you think you found a bug in RailsAdmin, you can submit an issue.

Supported Ruby Versions

This library aims to support and is tested against the following Ruby implementations:

  • Ruby 2.6
  • Ruby 2.7
  • Ruby 3.0
  • Ruby 3.1
  • Ruby 3.2
  • JRuby