admin_resources 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3be67639f99785b3922b74d53915eb671d2bd18e9f9f29e2f4b176229b8ec37e
+  data.tar.gz: 581deeb6b0c2202bf2db8bddb021606aa804ed9eb44f386958480c5d56c84e1d
+SHA512:
+  metadata.gz: b27b897928284a64a6d8f5e4bf733feea84508d72f41235187e45fa048004d6ea1ac4b0f2732cbf64fc86a179ba6776b785cda9db3b2d7cf600a1f9255a9360a
+  data.tar.gz: a469f701fde5346d425bea3fa7a8fa4dff3a656006abdb4a822cc0747488f617655c8bf46d7b7143e1eb00acd39383c3b007cbb96781dbcd4866695e1a1f4d1c

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark Rosenberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,208 @@
+# AdminResources
+
+A mountable Rails engine that automatically generates a full admin dashboard for your models. Register the models you want to manage, mount the engine, and you get a complete CRUD interface with zero boilerplate controllers or views in your app.
+
+**Features:**
+- Auto-generated index, show, new, edit, and delete for every registered model
+- Dashboard with record counts for all registered models
+- Built-in admin authentication via Devise (own `AdminUser` model, own table)
+- Smart field rendering: JSON/JSONB pretty-printed, foreign keys linked to related admin pages, booleans as Yes/No, datetimes formatted
+- Smart form generation: checkboxes for booleans, dropdowns for foreign keys, textareas for JSON, etc.
+- `has_one` and `has_many` associations shown inline on show pages
+- Your own styling — dark sidebar, clean table layout, no external CSS dependencies
+
+---
+
+## Requirements
+
+- Rails 7.0+
+- Ruby 3.0+
+- Devise 4.0+
+- PostgreSQL (for array column support) — other databases work but array columns won't be handled
+
+---
+
+## Installation
+
+Add to your `Gemfile`:
+
+```ruby
+gem "admin_resources", github: "doeswork/admin_resources"
+```
+
+Or for local development:
+
+```ruby
+gem "admin_resources", path: "../admin_resources"
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+---
+
+## Setup
+
+### 1. Run the migration
+
+Copy and run the engine's migration to create the `admin_resources_admin_users` table:
+
+```bash
+rails admin_resources:install:migrations
+rails db:migrate
+```
+
+### 2. Mount the engine
+
+In `config/routes.rb`:
+
+```ruby
+Rails.application.routes.draw do
+  mount AdminResources::Engine, at: "/admin"
+
+  # ... rest of your routes
+end
+```
+
+### 3. Configure your models
+
+Create `config/initializers/admin_resources.rb`:
+
+```ruby
+AdminResources.configure do |config|
+  # Register with specific index columns:
+  config.register "User",     columns: %w[id email created_at]
+  config.register "Post",     columns: %w[id title user_id published_at]
+
+  # Register without columns — defaults to first 6 columns:
+  config.register "Comment"
+  config.register "Tag"
+end
+```
+
+### 4. Create your first admin user
+
+Open a Rails console and create an `AdminResources::AdminUser`:
+
+```ruby
+AdminResources::AdminUser.create!(
+  email: "admin@example.com",
+  password: "yourpassword",
+  password_confirmation: "yourpassword"
+)
+```
+
+Then visit `/admin` and sign in.
+
+---
+
+## Configuration reference
+
+`config.register` accepts:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `columns` | `Array<String>` | first 6 columns | Column names to display in the index table |
+
+```ruby
+AdminResources.configure do |config|
+  config.register "ModelName", columns: %w[col1 col2 col3]
+end
+```
+
+Model names must be strings matching the exact class name (e.g. `"WorkflowStep"`, not `"workflow_step"`).
+
+---
+
+## What gets generated automatically
+
+For each registered model, the engine provides:
+
+| Route | Description |
+|-------|-------------|
+| `GET /admin/users` | Index — paginated table of all records |
+| `GET /admin/users/new` | New form |
+| `POST /admin/users` | Create |
+| `GET /admin/users/:id` | Show — all columns + associations |
+| `GET /admin/users/:id/edit` | Edit form |
+| `PATCH /admin/users/:id` | Update |
+| `DELETE /admin/users/:id` | Destroy |
+
+Route helpers follow the pattern `admin_resources_<plural>_path` and `admin_resources_<singular>_path`.
+
+---
+
+## How field rendering works
+
+### Index + show pages
+
+| Value type | Rendered as |
+|------------|-------------|
+| `nil` | *nil* (italic, grey) |
+| JSON / JSONB column | `<pre>` with pretty-printed JSON |
+| Column named `params` or `data` | Same as JSON |
+| Foreign key (`*_id`) pointing to a registered model | Clickable link to that record's admin show page |
+| `Boolean` | Yes / No |
+| `Time` / `DateTime` | `YYYY-MM-DD HH:MM:SS` |
+| Everything else | Plain text (truncated to 50 chars on index) |
+
+### Forms
+
+| Column type | Field rendered |
+|-------------|----------------|
+| `:boolean` | Checkbox |
+| `:text` | Textarea (4 rows) |
+| `:integer`, `:decimal`, `:float` | Number input |
+| `:date` | Date picker |
+| `:datetime` | Datetime-local picker |
+| `:json`, `:jsonb` | Textarea (serialized to JSON) |
+| `*_id` foreign key | Dropdown (`collection_select`) populated with all records of the associated model |
+| Column name contains `password` | Password input |
+| Column name contains `email` | Email input |
+| Everything else | Text input |
+
+### Show page associations
+
+The show page automatically renders:
+
+- **`has_one`** associations: shown as a detail card below the main record, with View/Edit links if the associated model is also registered
+- **`has_many`** associations: shown as a table (limited to 20 rows) with a count and "New" link if the associated model is registered
+
+---
+
+## Authentication
+
+The engine bundles its own `AdminResources::AdminUser` model with Devise. It lives in a separate table (`admin_resources_admin_users`) and is completely independent from any `User` model in your app.
+
+Devise modules included: `database_authenticatable`, `recoverable`, `rememberable`, `validatable`.
+
+All admin routes require a signed-in `AdminResources::AdminUser`. Unauthenticated requests are redirected to the admin login page.
+
+---
+
+## Development
+
+Clone the repo and install dependencies:
+
+```bash
+git clone https://github.com/doeswork/admin_resources
+cd admin_resources
+bundle install
+```
+
+To install onto a local Rails app for testing, add `gem "admin_resources", path: "/path/to/admin_resources"` to that app's Gemfile.
+
+To release a new version, update `lib/admin_resources/version.rb` and run:
+
+```bash
+bundle exec rake release
+```
+
+---
+
+## Contributing
+
+Bug reports and pull requests are welcome at https://github.com/doeswork/admin_resources.

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/app/controllers/admin_resources/application_controller.rb

@@ -0,0 +1,26 @@
+module AdminResources
+  class ApplicationController < ActionController::Base
+    before_action :authenticate_admin_resources_admin_user!
+    layout "admin_resources/admin"
+
+    helper_method :admin_models, :admin_path_for
+
+    def admin_models
+      AdminResources.model_names
+    end
+
+    def admin_path_for(model_name, action = :index, resource = nil)
+      route_name = model_name.underscore.pluralize
+      case action
+      when :index
+        send("admin_resources_#{route_name}_path")
+      when :new
+        send("new_admin_resources_#{route_name.singularize}_path")
+      when :show
+        send("admin_resources_#{route_name.singularize}_path", resource)
+      when :edit
+        send("edit_admin_resources_#{route_name.singularize}_path", resource)
+      end
+    end
+  end
+end

data/app/controllers/admin_resources/dashboard_controller.rb

@@ -0,0 +1,10 @@
+module AdminResources
+  class DashboardController < ApplicationController
+    def index
+      puts "[AdminResources::DashboardController] index - showing dashboard"
+      @model_counts = AdminResources.model_names.each_with_object({}) do |model_name, hash|
+        hash[model_name] = model_name.constantize.count
+      end
+    end
+  end
+end

data/app/controllers/admin_resources/resources_controller.rb

@@ -0,0 +1,127 @@
+module AdminResources
+  class ResourcesController < ApplicationController
+    before_action :set_model_class
+    before_action :set_resource, only: %i[show edit update destroy]
+
+    helper_method :model_class, :model_name, :index_columns, :form_columns, :admin_value_display
+
+    def index
+      puts "[AdminResources::ResourcesController] index for #{model_name}"
+      @resources = model_class.all.order(id: :desc)
+    end
+
+    def show
+      puts "[AdminResources::ResourcesController] show #{model_name}##{@resource.id}"
+    end
+
+    def new
+      puts "[AdminResources::ResourcesController] new #{model_name}"
+      @resource = model_class.new
+    end
+
+    def create
+      puts "[AdminResources::ResourcesController] create #{model_name}"
+      @resource = model_class.new(resource_params)
+      if @resource.save
+        redirect_to admin_path_for(model_name, :show, @resource), notice: "#{model_name} was successfully created."
+      else
+        render :new, status: :unprocessable_entity
+      end
+    end
+
+    def edit
+      puts "[AdminResources::ResourcesController] edit #{model_name}##{@resource.id}"
+    end
+
+    def update
+      puts "[AdminResources::ResourcesController] update #{model_name}##{@resource.id}"
+      if @resource.update(resource_params)
+        redirect_to admin_path_for(model_name, :show, @resource), notice: "#{model_name} was successfully updated."
+      else
+        render :edit, status: :unprocessable_entity
+      end
+    end
+
+    def destroy
+      puts "[AdminResources::ResourcesController] destroy #{model_name}##{@resource.id}"
+      @resource.destroy
+      redirect_to admin_path_for(model_name, :index), notice: "#{model_name} was successfully deleted."
+    end
+
+    private
+
+    def set_model_class
+      model_param = params[:model]
+      unless AdminResources.model_names.include?(model_param)
+        raise ActiveRecord::RecordNotFound, "Model '#{model_param}' not registered in AdminResources"
+      end
+      @model_class = model_param.constantize
+    end
+
+    def set_resource
+      @resource = model_class.find(params[:id])
+    end
+
+    def model_class
+      @model_class
+    end
+
+    def model_name
+      model_class.name
+    end
+
+    def index_columns
+      config = AdminResources.models[model_name]
+      config&.dig(:columns) || model_class.column_names.first(6)
+    end
+
+    def form_columns
+      model_class.column_names - %w[id created_at updated_at]
+    end
+
+    # Returns [display_text, link_path_or_nil]
+    def admin_value_display(resource, column)
+      unless resource.respond_to?(column)
+        return ["[invalid column: #{column}]", nil]
+      end
+
+      value = resource.send(column)
+      return [nil, nil] if value.nil?
+
+      if column.end_with?("_id") && value.present?
+        assoc_name = column.sub(/_id$/, "")
+        association = resource.class.reflect_on_association(assoc_name.to_sym)
+
+        if association && association.macro == :belongs_to
+          assoc_class = association.klass
+          assoc_model = assoc_class.name
+
+          if AdminResources.model_names.include?(assoc_model)
+            associated_record = assoc_class.find_by(id: value)
+            if associated_record
+              display = "#{assoc_model} ##{value}"
+              display = associated_record.name    if associated_record.respond_to?(:name) && associated_record.name.present?
+              display = associated_record.version if associated_record.respond_to?(:version) && associated_record.version.present?
+              display = associated_record.email   if associated_record.respond_to?(:email) && associated_record.email.present?
+              return [display, admin_path_for(assoc_model, :show, associated_record)]
+            end
+          end
+        end
+      end
+
+      [value, nil]
+    end
+
+    def resource_params
+      permitted = form_columns.map do |col|
+        column = model_class.columns_hash[col]
+        if column&.array?
+          { col.to_sym => [] }
+        else
+          col.to_sym
+        end
+      end
+      params.require(model_class.model_name.param_key).permit(*permitted)
+    end
+  end
+end

data/app/models/admin_resources/admin_user.rb

@@ -0,0 +1,7 @@
+module AdminResources
+  class AdminUser < ApplicationRecord
+    self.table_name = "admin_resources_admin_users"
+
+    devise :database_authenticatable, :recoverable, :rememberable, :validatable
+  end
+end

data/app/views/admin_resources/dashboard/index.html.erb

@@ -0,0 +1,13 @@
+<div class="admin-header">
+  <h1>Dashboard</h1>
+</div>
+
+<div class="admin-grid">
+  <% @model_counts.each do |model_name, count| %>
+    <div class="admin-card admin-stat">
+      <div class="admin-stat-value"><%= count %></div>
+      <div class="admin-stat-label"><%= model_name.pluralize %></div>
+      <%= link_to "View all", admin_path_for(model_name), class: "admin-btn admin-btn-secondary" %>
+    </div>
+  <% end %>
+</div>

data/app/views/admin_resources/resources/_form.html.erb

@@ -0,0 +1,54 @@
+<%= form_with model: @resource, url: (@resource.new_record? ? admin_path_for(model_name, :index) : admin_path_for(model_name, :show, @resource)), class: "admin-form" do |form| %>
+  <% if @resource.errors.any? %>
+    <div class="admin-flash alert">
+      <strong><%= pluralize(@resource.errors.count, "error") %> prohibited this <%= model_name.downcase %> from being saved:</strong>
+      <ul>
+        <% @resource.errors.full_messages.each do |message| %>
+          <li><%= message %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <% form_columns.each do |col| %>
+    <% column = model_class.columns_hash[col] %>
+    <div class="field">
+      <%= form.label col %>
+      <% case column&.type %>
+      <% when :boolean %>
+        <%= form.check_box col %>
+      <% when :text %>
+        <%= form.text_area col, rows: 4 %>
+      <% when :integer, :decimal, :float %>
+        <%= form.number_field col, step: (column.type == :integer ? 1 : 'any') %>
+      <% when :date %>
+        <%= form.date_field col %>
+      <% when :datetime %>
+        <%= form.datetime_local_field col %>
+      <% when :json, :jsonb %>
+        <%= form.text_area col, rows: 4, value: @resource.send(col)&.to_json %>
+      <% else %>
+        <% if col.end_with?('_id') %>
+          <% assoc_name = col.sub(/_id$/, '').classify %>
+          <% assoc_class = assoc_name.safe_constantize %>
+          <% if assoc_class && assoc_class < ActiveRecord::Base %>
+            <%= form.collection_select col, assoc_class.all, :id, :to_s, include_blank: true %>
+          <% else %>
+            <%= form.number_field col %>
+          <% end %>
+        <% elsif col.include?('password') %>
+          <%= form.password_field col %>
+        <% elsif col.include?('email') %>
+          <%= form.email_field col %>
+        <% else %>
+          <%= form.text_field col %>
+        <% end %>
+      <% end %>
+    </div>
+  <% end %>
+
+  <div class="field">
+    <%= form.submit class: "admin-btn admin-btn-primary" %>
+    <%= link_to "Cancel", (@resource.new_record? ? admin_path_for(model_name) : admin_path_for(model_name, :show, @resource)), class: "admin-btn admin-btn-secondary" %>
+  </div>
+<% end %>

data/app/views/admin_resources/resources/edit.html.erb

@@ -0,0 +1,5 @@
+<div class="admin-header">
+  <h1>Edit <%= model_name %> #<%= @resource.id %></h1>
+</div>
+
+<%= render "form" %>

data/app/views/admin_resources/resources/index.html.erb

@@ -0,0 +1,38 @@
+<div class="admin-header">
+  <h1><%= model_name.pluralize %></h1>
+  <%= link_to "New #{model_name}", admin_path_for(model_name, :new), class: "admin-btn admin-btn-primary" %>
+</div>
+
+<table class="admin-table">
+  <thead>
+    <tr>
+      <% index_columns.each do |col| %>
+        <th><%= col.titleize %></th>
+      <% end %>
+      <th>Actions</th>
+    </tr>
+  </thead>
+  <tbody>
+    <% @resources.each do |resource| %>
+      <tr>
+        <% index_columns.each do |col| %>
+          <td>
+            <% display, link = admin_value_display(resource, col) %>
+            <% column_type = model_class.columns_hash[col]&.type %>
+            <% if %w[params data].include?(col) || column_type == :json || column_type == :jsonb %>
+              <pre style="margin: 0; font-size: 0.75rem; max-width: 300px; overflow-x: auto; white-space: pre-wrap;"><%= JSON.pretty_generate(display.is_a?(String) ? JSON.parse(display) : display) rescue display %></pre>
+            <% elsif link %>
+              <%= link_to truncate(display.to_s, length: 50), link %>
+            <% else %>
+              <%= truncate(display.to_s, length: 50) %>
+            <% end %>
+          </td>
+        <% end %>
+        <td class="admin-actions">
+          <%= link_to "View", admin_path_for(model_name, :show, resource), class: "admin-btn admin-btn-secondary" %>
+          <%= link_to "Edit", admin_path_for(model_name, :edit, resource), class: "admin-btn admin-btn-secondary" %>
+        </td>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/app/views/admin_resources/resources/new.html.erb

@@ -0,0 +1,5 @@
+<div class="admin-header">
+  <h1>New <%= model_name %></h1>
+</div>
+
+<%= render "form" %>

data/app/views/admin_resources/resources/show.html.erb

@@ -0,0 +1,133 @@
+<div class="admin-header">
+  <h1><%= model_name %> #<%= @resource.id %></h1>
+  <div class="admin-actions">
+    <%= link_to "Edit", admin_path_for(model_name, :edit, @resource), class: "admin-btn admin-btn-primary" %>
+    <%= link_to "Back to list", admin_path_for(model_name), class: "admin-btn admin-btn-secondary" %>
+    <%= button_to "Delete", admin_path_for(model_name, :show, @resource),
+        method: :delete,
+        class: "admin-btn admin-btn-danger",
+        data: { turbo_confirm: "Are you sure you want to delete this #{model_name.downcase}?" } %>
+  </div>
+</div>
+
+<div class="admin-card">
+  <% model_class.column_names.each do |col| %>
+    <div class="admin-detail-row">
+      <div class="admin-detail-label"><%= col.titleize %></div>
+      <div class="admin-detail-value">
+        <% display, link = admin_value_display(@resource, col) %>
+        <% column_type = model_class.columns_hash[col]&.type %>
+        <% if display.nil? %>
+          <em style="color: #999;">nil</em>
+        <% elsif %w[params data].include?(col) || column_type == :json || column_type == :jsonb %>
+          <pre style="margin: 0; font-size: 0.85rem; background: #f5f5f5; padding: 0.5rem; border-radius: 4px; overflow-x: auto;"><%= JSON.pretty_generate(display) rescue display %></pre>
+        <% elsif display.is_a?(Time) || display.is_a?(DateTime) %>
+          <%= display.strftime("%Y-%m-%d %H:%M:%S") %>
+        <% elsif display.is_a?(TrueClass) || display.is_a?(FalseClass) %>
+          <%= display ? "Yes" : "No" %>
+        <% elsif link %>
+          <%= link_to display, link %>
+        <% else %>
+          <%= display %>
+        <% end %>
+      </div>
+    </div>
+  <% end %>
+</div>
+
+<%# Display has_one associations %>
+<% model_class.reflect_on_all_associations(:has_one).each do |assoc| %>
+  <% record = @resource.send(assoc.name) %>
+  <% next if record.nil? %>
+
+  <div style="margin-top: 2rem;">
+    <div class="admin-header">
+      <h2><%= assoc.name.to_s.titleize %></h2>
+      <% if AdminResources.model_names.include?(assoc.klass.name) %>
+        <div class="admin-actions">
+          <%= link_to "View", admin_path_for(assoc.klass.name, :show, record), class: "admin-btn admin-btn-secondary" %>
+          <%= link_to "Edit", admin_path_for(assoc.klass.name, :edit, record), class: "admin-btn admin-btn-secondary" %>
+        </div>
+      <% end %>
+    </div>
+
+    <div class="admin-card">
+      <% assoc.klass.column_names.each do |col| %>
+        <div class="admin-detail-row">
+          <div class="admin-detail-label"><%= col.titleize %></div>
+          <div class="admin-detail-value">
+            <% display, link = admin_value_display(record, col) %>
+            <% if display.nil? %>
+              <em style="color: #999;">nil</em>
+            <% elsif display.is_a?(Time) || display.is_a?(DateTime) %>
+              <%= display.strftime("%Y-%m-%d %H:%M:%S") %>
+            <% elsif display.is_a?(TrueClass) || display.is_a?(FalseClass) %>
+              <%= display ? "Yes" : "No" %>
+            <% elsif link %>
+              <%= link_to display, link %>
+            <% else %>
+              <%= truncate(display.to_s, length: 100) %>
+            <% end %>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  </div>
+<% end %>
+
+<%# Display has_many associations %>
+<% model_class.reflect_on_all_associations(:has_many).each do |assoc| %>
+  <% associated_records = @resource.send(assoc.name) %>
+  <% next if associated_records.empty? %>
+
+  <div style="margin-top: 2rem;">
+    <div class="admin-header">
+      <h2><%= assoc.name.to_s.titleize %> (<%= associated_records.count %>)</h2>
+      <% assoc_model = assoc.klass.name %>
+      <% if AdminResources.model_names.include?(assoc_model) %>
+        <%= link_to "New #{assoc_model}", admin_path_for(assoc_model, :new), class: "admin-btn admin-btn-secondary" %>
+      <% end %>
+    </div>
+
+    <table class="admin-table">
+      <thead>
+        <tr>
+          <% assoc.klass.column_names.first(6).each do |col| %>
+            <th><%= col.titleize %></th>
+          <% end %>
+          <th>Actions</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% associated_records.limit(20).each do |record| %>
+          <tr>
+            <% assoc.klass.column_names.first(6).each do |col| %>
+              <td>
+                <% display, link = admin_value_display(record, col) %>
+                <% column_type = assoc.klass.columns_hash[col]&.type %>
+                <% if col == "id" && AdminResources.model_names.include?(assoc.klass.name) %>
+                  <%= link_to record.id, admin_path_for(assoc.klass.name, :show, record) %>
+                <% elsif %w[params data].include?(col) || column_type == :json || column_type == :jsonb %>
+                  <pre style="margin: 0; font-size: 0.75rem; max-width: 300px; overflow-x: auto; white-space: pre-wrap;"><%= JSON.pretty_generate(display) rescue display %></pre>
+                <% elsif link %>
+                  <%= link_to truncate(display.to_s, length: 50), link %>
+                <% else %>
+                  <%= truncate(display.to_s, length: 50) %>
+                <% end %>
+              </td>
+            <% end %>
+            <td class="admin-actions">
+              <% if AdminResources.model_names.include?(assoc.klass.name) %>
+                <%= link_to "View", admin_path_for(assoc.klass.name, :show, record), class: "admin-btn admin-btn-secondary" %>
+                <%= link_to "Edit", admin_path_for(assoc.klass.name, :edit, record), class: "admin-btn admin-btn-secondary" %>
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+    <% if associated_records.count > 20 %>
+      <p style="margin-top: 0.5rem; color: #666;">Showing 20 of <%= associated_records.count %> records</p>
+    <% end %>
+  </div>
+<% end %>

data/app/views/layouts/admin_resources/admin.html.erb

@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Admin - <%= content_for(:title) || "Admin" %></title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <style>
+      .admin-layout { display: flex; min-height: 100vh; }
+      .admin-sidebar { width: 220px; background: #1a1a2e; padding: 1rem; }
+      .admin-sidebar a { color: #eee; text-decoration: none; display: block; padding: 0.5rem; border-radius: 4px; }
+      .admin-sidebar a:hover { background: #16213e; }
+      .admin-sidebar a.active { background: #0f3460; }
+      .admin-sidebar h2 { color: #fff; font-size: 1.25rem; margin-bottom: 1rem; }
+      .admin-sidebar h3 { color: #888; font-size: 0.75rem; text-transform: uppercase; margin: 1rem 0 0.5rem; }
+      .admin-main { flex: 1; padding: 2rem; background: #f5f5f5; }
+      .admin-header { margin-bottom: 2rem; display: flex; justify-content: space-between; align-items: center; }
+      .admin-header h1 { margin: 0; }
+      .admin-table { width: 100%; border-collapse: collapse; background: #fff; border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+      .admin-table th, .admin-table td { padding: 0.75rem 1rem; text-align: left; border-bottom: 1px solid #eee; }
+      .admin-table th { background: #fafafa; font-weight: 600; }
+      .admin-table tr:hover { background: #fafafa; }
+      .admin-btn { display: inline-block; padding: 0.5rem 1rem; border-radius: 4px; text-decoration: none; font-size: 0.875rem; cursor: pointer; border: none; }
+      .admin-btn-primary { background: #0f3460; color: #fff; }
+      .admin-btn-secondary { background: #eee; color: #333; }
+      .admin-btn-danger { background: #dc3545; color: #fff; }
+      .admin-btn:hover { opacity: 0.9; }
+      .admin-form { background: #fff; padding: 1.5rem; border-radius: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); max-width: 600px; }
+      .admin-form .field { margin-bottom: 1rem; }
+      .admin-form label { display: block; margin-bottom: 0.25rem; font-weight: 500; }
+      .admin-form input[type="text"], .admin-form input[type="email"], .admin-form input[type="number"], .admin-form input[type="password"], .admin-form textarea, .admin-form select { width: 100%; padding: 0.5rem; border: 1px solid #ddd; border-radius: 4px; font-size: 1rem; }
+      .admin-form input[type="checkbox"] { width: auto; }
+      .admin-flash { padding: 1rem; border-radius: 4px; margin-bottom: 1rem; }
+      .admin-flash.notice { background: #d4edda; color: #155724; }
+      .admin-flash.alert { background: #f8d7da; color: #721c24; }
+      .admin-card { background: #fff; padding: 1.5rem; border-radius: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+      .admin-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 1rem; }
+      .admin-stat { text-align: center; }
+      .admin-stat-value { font-size: 2rem; font-weight: bold; color: #0f3460; }
+      .admin-stat-label { color: #666; }
+      .admin-detail-row { display: flex; border-bottom: 1px solid #eee; padding: 0.75rem 0; }
+      .admin-detail-label { width: 200px; font-weight: 500; color: #666; }
+      .admin-detail-value { flex: 1; }
+      .admin-actions { display: flex; gap: 0.5rem; }
+    </style>
+  </head>
+
+  <body>
+    <div class="admin-layout">
+      <nav class="admin-sidebar">
+        <h2><%= link_to "Admin", admin_resources.root_path %></h2>
+
+        <h3>Resources</h3>
+        <% admin_models.each do |model_name| %>
+          <%= link_to model_name.pluralize, admin_path_for(model_name),
+              class: ('active' if params[:model] == model_name) %>
+        <% end %>
+
+        <h3>Account</h3>
+        <%= link_to "Sign Out", admin_resources.destroy_admin_user_session_path, data: { turbo_method: :delete } %>
+      </nav>
+
+      <main class="admin-main">
+        <% if notice %>
+          <div class="admin-flash notice"><%= notice %></div>
+        <% end %>
+        <% if alert %>
+          <div class="admin-flash alert"><%= alert %></div>
+        <% end %>
+
+        <%= yield %>
+      </main>
+    </div>
+  </body>
+</html>

data/config/routes.rb

@@ -0,0 +1,16 @@
+AdminResources::Engine.routes.draw do
+  devise_for :admin_users,
+             class_name: "AdminResources::AdminUser",
+             module: :devise,
+             path: "",
+             path_names: { sign_in: "login", sign_out: "logout" }
+
+  # Dynamically generate routes for every registered model
+  AdminResources.model_names.each do |model_name|
+    resources model_name.underscore.pluralize.to_sym,
+              controller: "resources",
+              defaults: { model: model_name }
+  end
+
+  root to: "dashboard#index"
+end

data/db/migrate/20240101000000_create_admin_resources_admin_users.rb

@@ -0,0 +1,16 @@
+class CreateAdminResourcesAdminUsers < ActiveRecord::Migration[7.0]
+  def change
+    create_table :admin_resources_admin_users do |t|
+      t.string :email, null: false, default: ""
+      t.string :encrypted_password, null: false, default: ""
+      t.string :reset_password_token
+      t.datetime :reset_password_sent_at
+      t.datetime :remember_created_at
+
+      t.timestamps null: false
+    end
+
+    add_index :admin_resources_admin_users, :email, unique: true
+    add_index :admin_resources_admin_users, :reset_password_token, unique: true
+  end
+end

data/lib/admin_resources/configuration.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AdminResources
+  class Configuration
+    attr_reader :models
+
+    def initialize
+      @models = {}
+    end
+
+    # Register a model for admin management
+    # Usage: config.register "User", columns: %w[id email created_at]
+    # Usage: config.register "User"  (defaults to first 6 columns)
+    def register(model_name, columns: nil)
+      name = model_name.to_s.classify
+      @models[name] = { columns: columns&.map(&:to_s) }
+    end
+
+    def model_names
+      @models.keys
+    end
+  end
+end

data/lib/admin_resources/engine.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "rails/engine"
+require "devise"
+
+module AdminResources
+  class Engine < ::Rails::Engine
+    isolate_namespace AdminResources
+
+    initializer "admin_resources.load_admin_user_migration" do |app|
+      # Add our migrations to the host app's migration path
+      config.paths["db/migrate"].expanded.each do |expanded_path|
+        app.config.paths["db/migrate"] << expanded_path
+      end
+    end
+
+    config.generators do |g|
+      g.test_framework nil
+    end
+  end
+end

data/lib/admin_resources/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AdminResources
+  VERSION = "0.1.0"
+end

data/lib/admin_resources.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "admin_resources/version"
+require_relative "admin_resources/configuration"
+require_relative "admin_resources/engine"
+
+module AdminResources
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    # Shorthand accessors used throughout the engine
+    def models
+      configuration.models
+    end
+
+    def model_names
+      configuration.model_names
+    end
+  end
+end

data/sig/admin_resources.rbs

@@ -0,0 +1,4 @@
+module AdminResources
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: admin_resources
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mark rosenberg
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-03-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: devise
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Mount AdminResources::Engine in your Rails app, configure which models
+  to expose, and get a full admin dashboard with zero boilerplate.
+email:
+- mark@does.work
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- app/controllers/admin_resources/application_controller.rb
+- app/controllers/admin_resources/dashboard_controller.rb
+- app/controllers/admin_resources/resources_controller.rb
+- app/models/admin_resources/admin_user.rb
+- app/views/admin_resources/dashboard/index.html.erb
+- app/views/admin_resources/resources/_form.html.erb
+- app/views/admin_resources/resources/edit.html.erb
+- app/views/admin_resources/resources/index.html.erb
+- app/views/admin_resources/resources/new.html.erb
+- app/views/admin_resources/resources/show.html.erb
+- app/views/layouts/admin_resources/admin.html.erb
+- config/routes.rb
+- db/migrate/20240101000000_create_admin_resources_admin_users.rb
+- lib/admin_resources.rb
+- lib/admin_resources/configuration.rb
+- lib/admin_resources/engine.rb
+- lib/admin_resources/version.rb
+- sig/admin_resources.rbs
+homepage: https://github.com/doeswork/admin_resources
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: Mountable Rails engine that auto-generates admin CRUD UI for registered models.
+test_files: []