thoughtbot/administrate
Administrate
Administrate is a Rails engine that generates full CRUD admin interfaces for any model in a Rails application, providing create, read, update, delete, search, and pagination capabilities out of the box. It functions as a convention-based dashboard generator that maps model attributes to default field types and views, while supporting customization through standard Rails controller and view overrides.
The framework distinguishes itself through a field type abstraction layer that encapsulates data display and input logic into reusable classes, and a hook-point content injection system that allows custom HTML to be inserted into named regions of admin pages. It integrates with Pundit for authorization, enabling role-based access control and record scoping per user, while also supporting custom authorization logic for applications that don't use Pundit.
Administrate provides extensive customization capabilities, including the ability to create custom field types, override default sorting, customize post-action redirects, and inject content into page regions. It supports resource-scoped view templates that allow per-model customizations without affecting other dashboards, and enables developers to add custom stylesheets and scripts that load across all admin pages.
Features
- Admin Dashboard Generators - Generates full admin interfaces for any model in a Rails application with CRUD, search, and pagination.
- Rails Engine Mounting Patterns - Mounts as a self-contained Rails engine within a host application for admin functionality.
- Admin Field Type Abstractions - Encapsulates data display and input logic into reusable field classes for admin dashboards.
- Database Record Management - Generates admin dashboards that let users create, edit, search, and delete database records.
- CRUD Interfaces - Generates full CRUD interfaces for any model in a Rails application out of the box.
- Admin Record Searchers - Filters and finds records across any model using a search field that queries the database.
- Data Record Editing - Updates existing entries for any model via an inline form that saves changes directly to the database.
- Record Deletion - Removes a record from any model with a single action, including a confirmation step.
- Dashboard Generation Conventions - Generates admin dashboards by mapping model attributes to field types using naming conventions.
- Admin Record Creators - Adds new entries to any model through a generated form with fields matching the model's attributes.
- Admin Dashboard Frameworks - A framework for building admin dashboards in Rails that supports custom field types, layouts, and authorization.
- Admin Interface Customizations - Overrides default views, controllers, and layouts with standard Rails tools to tailor the admin dashboard.
- Admin Interface Customizers - Overrides default views and controllers to tailor the admin dashboard to specific needs.
- Admin Table Browsers - Displays a paginated, sortable table of all records for any model in the application.
- Admin View Overriders - Overrides default admin views and controllers using standard Rails generators and partials for minimal custom code.
- CRUD Generators - Generates create, read, update, and delete interfaces for database models with pagination, sorting, and search.
- Page Content Injections - Inserts custom HTML into named regions of admin pages via partials.
- Controller Override Patterns - Provides a pattern for overriding default admin controllers and views using standard Rails tools.
- Custom Field Type Definitions - Builds custom field classes and associated views to display nonstandard data types across the admin dashboard.
- Post-Creation Callback Hooks - Executes custom code after a record is successfully created in the admin dashboard.
- Admin Index Sort Overrides - Sets default sort column and direction for the admin index view via controller overrides.
- Pundit Policy Integrations - Integrates with Pundit to authorize admin dashboard actions using existing application policies.
- Controller Method Access Restrictions - Overrides controller methods to check user permissions before granting access to any record or action.
- User-Scoped Admin Visibility - Limits visible records in the admin interface to only those belonging to the current user through custom authorization logic.
- Custom Authorization Logic - Overrides specific controller methods to implement a custom authorization solution without Pundit.
- Pundit Authorization Integrations - Integrates with Pundit and custom authorization logic to restrict admin dashboard access by user role or record scope.
- User-Scoped Record Views - Limits visible records in the admin interface to only those belonging to the current user.
- Pundit Policy Integrations - Uses existing Pundit policies from the main application to authorize admin dashboard actions.
- Post-CRUD Redirect Hooks - Allows custom redirects after creating, updating, or destroying records in the admin dashboard.
- Per-Model View Templates - Generates view templates scoped to a single model for per-resource admin customizations.
- Custom Page Views - Overrides default dashboards with standard Rails controllers and views for minimal custom code.
- Admin CSS and JS Injections - Registers custom CSS and JavaScript files that load on every admin page.
- Per-Model Dashboard Overrides - Generates view templates scoped to a single resource for per-model admin customizations.
- Field Type Rendering Overrides - Overrides default field type rendering across all dashboards via view partials.
- Admin Layout Override Patterns - Sets a custom layout for the entire admin dashboard via view generator configuration.
- Post-CRUD Redirect Customizations - Redirects to custom paths after creating, updating, or destroying records in the admin dashboard.
- Admin Interfaces - A flexible engine for building custom admin dashboards.
- Admin Panels - Flexible admin dashboard engine.
