0.0
There's a lot of open issues
Reuses your ActiveAdmin registrations and controllers to serve a JSON API, an OpenAPI document and an MCP server, and to host a React admin client.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

>= 3.5, < 4
>= 8.1
 Project Readme

ReactiveAdmin

ReactiveAdmin serves your existing ActiveAdmin registrations as a JSON API with an OpenAPI description and an MCP server, and it ships a React admin client that renders them. Your ActiveAdmin resources stay the source of truth: ReactiveAdmin reuses their controllers, filters, scopes, forms, actions and authorization, and adds the API and the UI on top.

Website and docs: https://formhealth.github.io/reactiveadmin/, with a demo that runs on sample data and a Storybook of the client's components.

Status

Version 0.2.0. This is early software: interfaces may change before 1.0. See the changelog.

Requirements

Tool Version
Ruby 3.4 or later
Rails 8.1 or later
ActiveAdmin 3.5 or later in the 3.x line (ActiveAdmin 4 isn't supported yet)
Node.js 24, only to build the client from a source checkout (.nvmrc)
pnpm 8.14.1, likewise (corepack enable)

The released gem ships the client prebuilt, so a host installed from RubyGems needs no Node.js. Only a source checkout builds it.

The client bundles its own React 19.2 or later, so a host that runs React 18 elsewhere is unaffected. React 18 isn't supported: see Custom components.

Install

bundle add reactiveadmin

The gem ships a prebuilt client, so the host needs no Node.js.

Quick start

bin/rails generate reactiveadmin:install

The generator writes config/initializers/reactive_admin.rb with secure defaults (config.expose = :listed, implicit_defaults = :secure), adds ReactiveAdmin.routes(self) after ActiveAdmin.routes(self) in config/routes.rb, and prints the next steps. Running it again changes nothing. With expose = :listed, the API serves only the resources you place in ReactiveAdmin.menu or list in config.exposed_resources; see Security.

With your app on port 3003 and a signed-in classic admin session, http://localhost:3003/api/admin/_manifest lists every resource the API serves. Add reactive do ... end blocks to resources that need hints; see the DSL reference.

Build and serve the client

For development, run the client against your app:

pnpm install
pnpm dev   # http://localhost:5174, proxying to localhost:3003

In production the gem serves the prebuilt client at your classic admin's URLs, switched per person by a cookie, once you set config.ui.available. Roll out the new admin covers the configuration and ramp-up. From a source checkout, build the client first:

bin/rails reactiveadmin:client:build

Documentation

Security notes

ReactiveAdmin keeps ActiveAdmin's authentication and authorization and adds guards of its own, but it exposes your data through a new API surface. Before you serve a resource that holds sensitive data, read the security guide: set config.expose = :listed, declare explicit index and show blocks, mask credentials, and subscribe to the audit events. Report vulnerabilities privately; see SECURITY.md.

License

MIT