js_admin 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b816de43bee7878c7eccf7acb2a158b304cbfbbb80bd65566329303fea76c0e2
+  data.tar.gz: 5c760edf388ea5dfc66985197ca48f99d79cfd4af9923635c98e4d93217856fc
+SHA512:
+  metadata.gz: 753fd6b7de19253fc292b4f32654231cda74211c131a07080128cdd3290b9acd8229b3c7f320c5bb32a7248113bff3b04062cf4bbcfc1d4b5d39bcbbd6de57a3
+  data.tar.gz: 1b26bb7126e1404f1bd0d85f8ab6693eee2b94c029e9c0e4c0a5775d7b921af3e0d68407b22ba7c3e7c41fbb17e63852f6b83a43a9bc24972f46798a906279b0

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.0.1 - 2026-07-12
+
+- Initial release for RubyGems publishing test.

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright TODO: Write your name
+
+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,76 @@
+# JSAdmin
+
+JSAdmin is a mountable Rails engine that exposes Active Record models through
+a generic CRUD UI. It discovers models from the host Rails application and builds
+forms from database column metadata.
+
+> 2026-07-12 기준 RubyGems API에서 `js_admin`은 등록되지 않은 이름으로 확인했습니다. 공개 배포 직전에는 다시 한 번 점유 여부를 확인하세요.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "js_admin", path: "../js_admin"
+```
+
+And then execute:
+
+```bash
+bundle install
+bin/rails generate js_admin:install
+bin/rails tailwindcss:engines
+```
+
+The install generator mounts the engine at `/js_admin` and imports the engine
+Tailwind entrypoint when `app/assets/tailwind/application.css` exists.
+
+## Usage
+
+Open:
+
+```text
+/js_admin
+```
+
+By default, JSAdmin lists every concrete Active Record model with an existing
+database table. No per-model field setup is required.
+
+Optional model filtering:
+
+```ruby
+# config/initializers/js_admin.rb
+JSAdmin.configure do |config|
+  config.include_models User, Post
+  config.exclude_models AuditLog
+  config.records_per_page = 50
+end
+```
+
+## Field Mapping
+
+JSAdmin maps database columns to inputs automatically:
+
+| Column metadata | Input |
+| --- | --- |
+| `text` | `textarea` |
+| `boolean` | checkbox |
+| `integer`, `bigint`, `float`, `decimal` | number input |
+| `date`, `datetime`, `time` | matching date/time input |
+| Rails enum | select |
+| `belongs_to` foreign key | select |
+| other columns | text input |
+
+Primary keys, timestamps, STI inheritance columns, readonly attributes, and
+generated columns are not editable.
+
+## Security
+
+Zero model configuration is convenient, but it is dangerous to expose without
+authentication. In production, mount the engine inside your app's admin
+authentication constraint.
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/js_admin/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/assets/tailwind/js_admin/engine.css

@@ -0,0 +1,4 @@
+@import "tailwindcss";
+
+@source "../../../views/js_admin/**/*.erb";
+@source "../../../helpers/js_admin/**/*.rb";

data/app/controllers/js_admin/application_controller.rb

@@ -0,0 +1,4 @@
+module JSAdmin
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/js_admin/models_controller.rb

@@ -0,0 +1,7 @@
+module JSAdmin
+  class ModelsController < ApplicationController
+    def index
+      @resources = JSAdmin.resources
+    end
+  end
+end

data/app/controllers/js_admin/resources_controller.rb

@@ -0,0 +1,61 @@
+module JSAdmin
+  class ResourcesController < ApplicationController
+    before_action :set_resource
+    before_action :set_record, only: %i[show edit update destroy]
+
+    def index
+      @page = [ params.fetch(:page, 1).to_i, 1 ].max
+      @records = @resource.records(page: @page)
+      @total_count = @resource.count
+    end
+
+    def show
+    end
+
+    def new
+      @record = @resource.new_record
+    end
+
+    def create
+      @record = @resource.new_record(resource_params)
+
+      if @record.save
+        redirect_to resource_path(@resource.model_id, @record), notice: "#{@resource.singular_label} was created."
+      else
+        render :new, status: :unprocessable_entity
+      end
+    end
+
+    def edit
+    end
+
+    def update
+      if @record.update(resource_params)
+        redirect_to resource_path(@resource.model_id, @record), notice: "#{@resource.singular_label} was updated."
+      else
+        render :edit, status: :unprocessable_entity
+      end
+    end
+
+    def destroy
+      @record.destroy
+      redirect_to resources_path(@resource.model_id), notice: "#{@resource.singular_label} was deleted."
+    end
+
+    private
+
+    def set_resource
+      @resource = JSAdmin.resource_for!(params[:model_id])
+    end
+
+    def set_record
+      @record = @resource.find(params[:id])
+    end
+
+    def resource_params
+      params
+        .fetch(@resource.param_key, ActionController::Parameters.new)
+        .permit(*@resource.editable_fields.map(&:name))
+    end
+  end
+end

data/app/helpers/js_admin/application_helper.rb

@@ -0,0 +1,67 @@
+module JSAdmin
+  module ApplicationHelper
+    TEXT_INPUT_CLASSES = "w-full rounded-md border border-slate-300 bg-white px-3 py-2 text-sm text-slate-950 shadow-sm focus:border-sky-500 focus:outline-none focus:ring-2 focus:ring-sky-200"
+    SELECT_INPUT_CLASSES = "w-full rounded-md border border-slate-300 bg-white px-3 py-2 text-sm text-slate-950 shadow-sm focus:border-sky-500 focus:outline-none focus:ring-2 focus:ring-sky-200"
+    CHECKBOX_INPUT_CLASSES = "h-4 w-4 rounded border-slate-300 text-sky-600 focus:ring-sky-500"
+
+    def js_admin_field_input(form, field)
+      case field.input_kind
+      when :text_area
+        form.text_area(field.name, rows: 5, class: TEXT_INPUT_CLASSES)
+      when :check_box
+        tag.div(class: "flex h-10 items-center") do
+          form.check_box(field.name, class: CHECKBOX_INPUT_CLASSES)
+        end
+      when :number_field
+        form.number_field(field.name, step: field.number_step, class: TEXT_INPUT_CLASSES)
+      when :date_field
+        form.date_field(field.name, class: TEXT_INPUT_CLASSES)
+      when :datetime_field
+        form.datetime_field(field.name, class: TEXT_INPUT_CLASSES)
+      when :time_field
+        form.time_field(field.name, class: TEXT_INPUT_CLASSES)
+      when :enum_select
+        form.select(field.name, field.enum_values, { include_blank: true }, class: SELECT_INPUT_CLASSES)
+      when :association_select
+        form.select(field.name, field.association_options, { include_blank: true }, class: SELECT_INPUT_CLASSES)
+      else
+        form.text_field(field.name, class: TEXT_INPUT_CLASSES)
+      end
+    end
+
+    def js_admin_table_value(field, record)
+      value = field.formatted_value(record)
+      classes = value == "NULL" ? "text-slate-400" : "text-slate-700"
+
+      tag.span(truncate(value, length: 80), class: classes)
+    end
+
+    def js_admin_stylesheet_link_tag(logical_name)
+      return unless js_admin_asset_exists?("#{logical_name}.css")
+
+      stylesheet_link_tag logical_name, "data-turbo-track": "reload"
+    end
+
+    def js_admin_hotwire_javascript_tags
+      if respond_to?(:javascript_importmap_tags) && Rails.root.join("config/importmap.rb").exist?
+        javascript_importmap_tags
+      elsif js_admin_asset_exists?("application.js")
+        javascript_include_tag "application", type: "module", "data-turbo-track": "reload"
+      end
+    end
+
+    def js_admin_asset_exists?(logical_path)
+      assets = Rails.application.assets
+
+      if assets.respond_to?(:load_path)
+        assets.load_path.find(logical_path).present?
+      elsif Rails.application.assets_manifest
+        Rails.application.assets_manifest.assets[logical_path].present?
+      else
+        false
+      end
+    rescue StandardError
+      false
+    end
+  end
+end

data/app/models/js_admin/application_record.rb

@@ -0,0 +1,5 @@
+module JSAdmin
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/js_admin/models/index.html.erb

@@ -0,0 +1,22 @@
+<% content_for :title, "JSAdmin Models" %>
+
+<div class="mb-6">
+  <h1 class="text-2xl font-semibold text-slate-950">Models</h1>
+  <p class="mt-1 text-sm text-slate-600"><%= pluralize(@resources.size, "model") %> available</p>
+</div>
+
+<div class="overflow-hidden rounded-lg border border-slate-200 bg-white shadow-sm">
+  <ul class="divide-y divide-slate-200">
+    <% @resources.each do |resource| %>
+      <li>
+        <%= link_to resources_path(resource.model_id), class: "flex items-center justify-between px-4 py-4 hover:bg-slate-50" do %>
+          <span>
+            <span class="block text-sm font-medium text-slate-950"><%= resource.label %></span>
+            <span class="mt-1 block text-xs text-slate-500"><%= resource.model_class.name %></span>
+          </span>
+          <span class="text-sm text-slate-500"><%= number_with_delimiter(resource.count) %></span>
+        <% end %>
+      </li>
+    <% end %>
+  </ul>
+</div>

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

@@ -0,0 +1,30 @@
+<%= form_with model: record, url: url, class: "space-y-6" do |form| %>
+  <% if record.errors.any? %>
+    <div class="rounded-md border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-800">
+      <p class="font-medium"><%= pluralize(record.errors.count, "error") %> prevented this record from being saved.</p>
+      <ul class="mt-2 list-disc space-y-1 pl-5">
+        <% record.errors.full_messages.each do |message| %>
+          <li><%= message %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="rounded-lg border border-slate-200 bg-white shadow-sm">
+    <div class="divide-y divide-slate-200">
+      <% resource.editable_fields.each do |field| %>
+        <div class="grid gap-2 px-4 py-4 sm:grid-cols-3">
+          <%= form.label field.name, field.human_name, class: "text-sm font-medium text-slate-700" %>
+          <div class="sm:col-span-2">
+            <%= js_admin_field_input(form, field) %>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="flex items-center gap-2">
+    <%= form.submit class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2 text-sm font-medium text-white shadow-sm hover:bg-sky-700" %>
+    <%= link_to "Cancel", record.persisted? ? resource_path(resource.model_id, record) : resources_path(resource.model_id), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50" %>
+  </div>
+<% end %>

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

@@ -0,0 +1,13 @@
+<% content_for :title, "Edit #{@resource.display_name(@record)}" %>
+
+<div class="mb-6">
+  <div class="mb-2 text-sm text-slate-500">
+    <%= link_to "Models", root_path, class: "hover:text-slate-950" %> /
+    <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950" %> /
+    <%= link_to @resource.display_name(@record), resource_path(@resource.model_id, @record), class: "hover:text-slate-950" %> /
+    Edit
+  </div>
+  <h1 class="text-2xl font-semibold text-slate-950">Edit <%= @resource.display_name(@record) %></h1>
+</div>
+
+<%= render "form", record: @record, resource: @resource, url: resource_path(@resource.model_id, @record) %>

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

@@ -0,0 +1,54 @@
+<% content_for :title, @resource.label %>
+
+<div class="mb-6 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
+  <div>
+    <div class="mb-2 text-sm text-slate-500"><%= link_to "Models", root_path, class: "hover:text-slate-950" %> / <%= @resource.label %></div>
+    <h1 class="text-2xl font-semibold text-slate-950"><%= @resource.label %></h1>
+    <p class="mt-1 text-sm text-slate-600"><%= number_with_delimiter(@total_count) %> records</p>
+  </div>
+
+  <%= link_to "New #{@resource.singular_label}", new_resource_path(@resource.model_id), class: "inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2 text-sm font-medium text-white shadow-sm hover:bg-sky-700" %>
+</div>
+
+<div class="overflow-x-auto rounded-lg border border-slate-200 bg-white shadow-sm">
+  <table class="min-w-full divide-y divide-slate-200">
+    <thead class="bg-slate-50">
+      <tr>
+        <% @resource.list_fields.each do |field| %>
+          <th scope="col" class="whitespace-nowrap px-4 py-3 text-left text-xs font-semibold uppercase tracking-wide text-slate-500"><%= field.human_name %></th>
+        <% end %>
+        <th scope="col" class="w-24 px-4 py-3 text-right text-xs font-semibold uppercase tracking-wide text-slate-500">Actions</th>
+      </tr>
+    </thead>
+    <tbody class="divide-y divide-slate-200 bg-white">
+      <% @records.each do |record| %>
+        <tr class="hover:bg-slate-50">
+          <% @resource.list_fields.each do |field| %>
+            <td class="whitespace-nowrap px-4 py-3 text-sm"><%= js_admin_table_value(field, record) %></td>
+          <% end %>
+          <td class="whitespace-nowrap px-4 py-3 text-right text-sm">
+            <%= link_to "Open", resource_path(@resource.model_id, record), class: "font-medium text-sky-700 hover:text-sky-900" %>
+          </td>
+        </tr>
+      <% end %>
+
+      <% if @records.empty? %>
+        <tr>
+          <td colspan="<%= @resource.list_fields.size + 1 %>" class="px-4 py-10 text-center text-sm text-slate-500">No records</td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<div class="mt-4 flex items-center justify-between">
+  <div class="text-sm text-slate-500">Page <%= @page %></div>
+  <div class="flex gap-2">
+    <% if @resource.previous_page?(@page) %>
+      <%= link_to "Previous", resources_path(@resource.model_id, page: @page - 1), class: "rounded-md border border-slate-300 bg-white px-3 py-2 text-sm font-medium text-slate-700 hover:bg-slate-50" %>
+    <% end %>
+    <% if @resource.next_page?(@page) %>
+      <%= link_to "Next", resources_path(@resource.model_id, page: @page + 1), class: "rounded-md border border-slate-300 bg-white px-3 py-2 text-sm font-medium text-slate-700 hover:bg-slate-50" %>
+    <% end %>
+  </div>
+</div>

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

@@ -0,0 +1,12 @@
+<% content_for :title, "New #{@resource.singular_label}" %>
+
+<div class="mb-6">
+  <div class="mb-2 text-sm text-slate-500">
+    <%= link_to "Models", root_path, class: "hover:text-slate-950" %> /
+    <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950" %> /
+    New
+  </div>
+  <h1 class="text-2xl font-semibold text-slate-950">New <%= @resource.singular_label %></h1>
+</div>
+
+<%= render "form", record: @record, resource: @resource, url: resources_path(@resource.model_id) %>

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

@@ -0,0 +1,28 @@
+<% content_for :title, @resource.display_name(@record) %>
+
+<div class="mb-6 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
+  <div>
+    <div class="mb-2 text-sm text-slate-500">
+      <%= link_to "Models", root_path, class: "hover:text-slate-950" %> /
+      <%= link_to @resource.label, resources_path(@resource.model_id), class: "hover:text-slate-950" %> /
+      <%= @resource.display_name(@record) %>
+    </div>
+    <h1 class="text-2xl font-semibold text-slate-950"><%= @resource.display_name(@record) %></h1>
+  </div>
+
+  <div class="flex gap-2">
+    <%= link_to "Edit", edit_resource_path(@resource.model_id, @record), class: "inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-medium text-slate-700 shadow-sm hover:bg-slate-50" %>
+    <%= button_to "Delete", resource_path(@resource.model_id, @record), method: :delete, form: { data: { turbo_confirm: "Delete this record?" } }, class: "inline-flex items-center justify-center rounded-md bg-rose-600 px-4 py-2 text-sm font-medium text-white shadow-sm hover:bg-rose-700" %>
+  </div>
+</div>
+
+<div class="overflow-hidden rounded-lg border border-slate-200 bg-white shadow-sm">
+  <dl class="divide-y divide-slate-200">
+    <% @resource.fields.each do |field| %>
+      <div class="grid gap-2 px-4 py-4 sm:grid-cols-3">
+        <dt class="text-sm font-medium text-slate-600"><%= field.human_name %></dt>
+        <dd class="text-sm text-slate-950 sm:col-span-2"><%= js_admin_table_value(field, @record) %></dd>
+      </div>
+    <% end %>
+  </dl>
+</div>

data/app/views/layouts/js_admin/application.html.erb

@@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= content_for(:title) || "JSAdmin" %></title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= js_admin_stylesheet_link_tag "tailwind" %>
+  <%= stylesheet_link_tag "js_admin/application", media: "all", "data-turbo-track": "reload" %>
+  <%= js_admin_hotwire_javascript_tags %>
+</head>
+<body class="min-h-screen bg-slate-50 text-slate-950">
+  <div class="min-h-screen">
+    <header class="border-b border-slate-200 bg-white">
+      <div class="mx-auto flex max-w-7xl items-center justify-between px-4 py-4 sm:px-6 lg:px-8">
+        <%= link_to "JSAdmin", root_path, class: "text-base font-semibold text-slate-950" %>
+        <%= link_to "Models", root_path, class: "rounded-md px-3 py-2 text-sm font-medium text-slate-600 hover:bg-slate-100 hover:text-slate-950" %>
+      </div>
+    </header>
+
+    <main class="mx-auto max-w-7xl px-4 py-6 sm:px-6 lg:px-8">
+      <% if notice.present? %>
+        <div class="mb-4 rounded-md border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm text-emerald-800"><%= notice %></div>
+      <% end %>
+
+      <% if alert.present? %>
+        <div class="mb-4 rounded-md border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-800"><%= alert %></div>
+      <% end %>
+
+      <%= yield %>
+    </main>
+  </div>
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,12 @@
+JSAdmin::Engine.routes.draw do
+  root to: "models#index"
+
+  get "/:model_id", to: "resources#index", as: :resources
+  get "/:model_id/new", to: "resources#new", as: :new_resource
+  post "/:model_id", to: "resources#create"
+  get "/:model_id/:id", to: "resources#show", as: :resource
+  get "/:model_id/:id/edit", to: "resources#edit", as: :edit_resource
+  patch "/:model_id/:id", to: "resources#update"
+  put "/:model_id/:id", to: "resources#update"
+  delete "/:model_id/:id", to: "resources#destroy"
+end

data/lib/generators/js_admin/install/install_generator.rb

@@ -0,0 +1,24 @@
+require "rails/generators"
+
+module JSAdmin
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      class_option :path, type: :string, default: "/js_admin",
+        desc: "Mount path for JSAdmin"
+
+      def mount_engine
+        route %(mount JSAdmin::Engine => "#{options[:path]}")
+      end
+
+      def import_tailwind_engine_styles
+        tailwind_entrypoint = Rails.root.join("app/assets/tailwind/application.css")
+        return unless tailwind_entrypoint.exist?
+
+        import_line = '@import "../builds/tailwind/js_admin";'
+        return if tailwind_entrypoint.read.include?(import_line)
+
+        append_to_file tailwind_entrypoint, "\n#{import_line}\n"
+      end
+    end
+  end
+end

data/lib/js_admin/configuration.rb

@@ -0,0 +1,28 @@
+module JSAdmin
+  class Configuration
+    attr_accessor :included_models, :excluded_models, :records_per_page,
+      :association_limit, :display_name_methods
+
+    def initialize
+      @included_models = []
+      @excluded_models = []
+      @records_per_page = 25
+      @association_limit = 100
+      @display_name_methods = %i[name title email username id]
+    end
+
+    def include_models(*models)
+      included_models.concat(normalize_model_names(models))
+    end
+
+    def exclude_models(*models)
+      excluded_models.concat(normalize_model_names(models))
+    end
+
+    private
+
+    def normalize_model_names(models)
+      models.flatten.map { |model| model.is_a?(Class) ? model.name : model.to_s }
+    end
+  end
+end

data/lib/js_admin/engine.rb

@@ -0,0 +1,15 @@
+module JSAdmin
+  class Engine < ::Rails::Engine
+    initializer "js_admin.inflections", before: :set_autoload_paths do
+      ActiveSupport::Inflector.inflections(:en) do |inflect|
+        inflect.acronym "JS"
+      end
+    end
+
+    isolate_namespace JSAdmin
+
+    config.to_prepare do
+      JSAdmin::Registry.reset!
+    end
+  end
+end

data/lib/js_admin/field.rb

@@ -0,0 +1,125 @@
+module JSAdmin
+  class Field
+    attr_reader :resource, :column
+
+    def initialize(resource, column)
+      @resource = resource
+      @column = column
+    end
+
+    def name
+      column.name
+    end
+
+    def human_name
+      resource.model_class.human_attribute_name(name)
+    end
+
+    def type
+      column.type
+    end
+
+    def primary_key?
+      name == resource.model_class.primary_key
+    end
+
+    def timestamp?
+      %w[created_at updated_at].include?(name)
+    end
+
+    def editable?
+      !primary_key? &&
+        !timestamp? &&
+        !inheritance_column? &&
+        !readonly_attribute? &&
+        !generated_column?
+    end
+
+    def input_kind
+      return :association_select if belongs_to_association
+      return :enum_select if enum?
+
+      case type
+      when :text
+        :text_area
+      when :boolean
+        :check_box
+      when :integer, :bigint, :float, :decimal
+        :number_field
+      when :date
+        :date_field
+      when :datetime
+        :datetime_field
+      when :time
+        :time_field
+      else
+        :text_field
+      end
+    end
+
+    def enum?
+      enum_values.any?
+    end
+
+    def enum_values
+      resource.model_class.defined_enums.fetch(name, {}).keys
+    end
+
+    def belongs_to_association
+      @belongs_to_association ||= resource.model_class
+        .reflect_on_all_associations(:belongs_to)
+        .find { |association| association.foreign_key.to_s == name }
+    rescue NameError
+      nil
+    end
+
+    def association_options
+      association = belongs_to_association
+      return [] unless association
+
+      association_resource = Resource.new(association.klass)
+      association.klass
+        .limit(JSAdmin.configuration.association_limit)
+        .map { |record| [ association_resource.display_name(record), record.id ] }
+    rescue ActiveRecord::ActiveRecordError, NameError
+      []
+    end
+
+    def number_step
+      %i[float decimal].include?(type) ? "any" : 1
+    end
+
+    def value_for(record)
+      record.public_send(name)
+    end
+
+    def formatted_value(record)
+      value = value_for(record)
+
+      case value
+      when nil
+        "NULL"
+      when true
+        "true"
+      when false
+        "false"
+      else
+        value.to_s
+      end
+    end
+
+    private
+
+    def inheritance_column?
+      name == resource.model_class.inheritance_column
+    end
+
+    def readonly_attribute?
+      resource.model_class.readonly_attributes.include?(name)
+    end
+
+    def generated_column?
+      column.respond_to?(:generated?) && column.generated?
+    end
+  end
+end

data/lib/js_admin/registry.rb

@@ -0,0 +1,58 @@
+module JSAdmin
+  class Registry
+    class << self
+      def resources
+        @resources ||= build_resources
+      end
+
+      def resource_for!(model_id)
+        resources.find { |resource| resource.model_id == model_id } ||
+          raise(ActiveRecord::RecordNotFound, "Unknown JSAdmin resource: #{model_id}")
+      end
+
+      def reset!
+        @resources = nil
+      end
+
+      private
+
+      def build_resources
+        eager_load_application_models
+
+        ActiveRecord::Base.descendants
+          .select { |model_class| manageable_model?(model_class) }
+          .select { |model_class| included_model?(model_class) }
+          .reject { |model_class| excluded_model?(model_class) }
+          .map { |model_class| Resource.new(model_class) }
+          .sort_by(&:label)
+      end
+
+      def eager_load_application_models
+        Rails.application.eager_load! unless Rails.application.config.eager_load
+      rescue Zeitwerk::NameError
+        raise
+      rescue StandardError
+        nil
+      end
+
+      def manageable_model?(model_class)
+        model_class.name.present? &&
+          !model_class.name.start_with?("ActiveRecord::") &&
+          !model_class.abstract_class? &&
+          model_class < ActiveRecord::Base &&
+          model_class.table_exists?
+      rescue ActiveRecord::ActiveRecordError, StandardError
+        false
+      end
+
+      def included_model?(model_class)
+        included_models = JSAdmin.configuration.included_models
+        included_models.empty? || included_models.include?(model_class.name)
+      end
+
+      def excluded_model?(model_class)
+        JSAdmin.configuration.excluded_models.include?(model_class.name)
+      end
+    end
+  end
+end

data/lib/js_admin/resource.rb

@@ -0,0 +1,88 @@
+module JSAdmin
+  class Resource
+    attr_reader :model_class
+
+    def initialize(model_class)
+      @model_class = model_class
+    end
+
+    def model_id
+      model_class.name.underscore.tr("/", "--")
+    end
+
+    def label
+      model_class.model_name.human(count: 2)
+    end
+
+    def singular_label
+      model_class.model_name.human
+    end
+
+    def param_key
+      model_class.model_name.param_key
+    end
+
+    def fields
+      @fields ||= model_class.columns.map { |column| Field.new(self, column) }
+    end
+
+    def editable_fields
+      fields.select(&:editable?)
+    end
+
+    def list_fields
+      visible_fields = fields.reject(&:timestamp?)
+      id_field = visible_fields.find(&:primary_key?)
+      selected_fields = visible_fields.reject(&:primary_key?).first(6)
+
+      [ id_field, *selected_fields ].compact
+    end
+
+    def records(page:)
+      page_number = [ page.to_i, 1 ].max
+      model_class.all
+        .then { |scope| ordered_scope(scope) }
+        .limit(JSAdmin.configuration.records_per_page)
+        .offset((page_number - 1) * JSAdmin.configuration.records_per_page)
+    end
+
+    def count
+      model_class.count
+    end
+
+    def find(record_id)
+      model_class.find(record_id)
+    end
+
+    def new_record(attributes = {})
+      model_class.new(attributes)
+    end
+
+    def display_name(record)
+      display_method = JSAdmin.configuration.display_name_methods.find do |method_name|
+        record.respond_to?(method_name) && record.public_send(method_name).present?
+      end
+
+      return record.public_send(display_method).to_s if display_method
+
+      "#{singular_label} ##{record.id}"
+    end
+
+    def next_page?(page)
+      count > page.to_i * JSAdmin.configuration.records_per_page
+    end
+
+    def previous_page?(page)
+      page.to_i > 1
+    end
+
+    private
+
+    def ordered_scope(scope)
+      primary_key = model_class.primary_key
+      return scope unless primary_key && model_class.column_names.include?(primary_key)
+
+      scope.order(primary_key => :desc)
+    end
+  end
+end

data/lib/js_admin/version.rb

@@ -0,0 +1,3 @@
+module JSAdmin
+  VERSION = "0.0.1"
+end

data/lib/js_admin.rb

@@ -0,0 +1,27 @@
+require "js_admin/version"
+require "js_admin/configuration"
+require "js_admin/field"
+require "js_admin/registry"
+require "js_admin/resource"
+require "js_admin/engine"
+
+module JSAdmin
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+      Registry.reset!
+    end
+
+    def resources
+      Registry.resources
+    end
+
+    def resource_for!(model_id)
+      Registry.resource_for!(model_id)
+    end
+  end
+end

data/lib/tasks/js_admin_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :js_admin do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification
+name: js_admin
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- JoungSik
+bindir: bin
+cert_chain: []
+date: 2026-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: stimulus-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tailwindcss-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.23
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.23
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: JSAdmin exposes Active Record models through a generic CRUD UI built
+  with Tailwind CSS and Hotwire.
+email:
+- tjstlr2010@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/js_admin/application.css
+- app/assets/tailwind/js_admin/engine.css
+- app/controllers/js_admin/application_controller.rb
+- app/controllers/js_admin/models_controller.rb
+- app/controllers/js_admin/resources_controller.rb
+- app/helpers/js_admin/application_helper.rb
+- app/models/js_admin/application_record.rb
+- app/views/js_admin/models/index.html.erb
+- app/views/js_admin/resources/_form.html.erb
+- app/views/js_admin/resources/edit.html.erb
+- app/views/js_admin/resources/index.html.erb
+- app/views/js_admin/resources/new.html.erb
+- app/views/js_admin/resources/show.html.erb
+- app/views/layouts/js_admin/application.html.erb
+- config/routes.rb
+- lib/generators/js_admin/install/install_generator.rb
+- lib/js_admin.rb
+- lib/js_admin/configuration.rb
+- lib/js_admin/engine.rb
+- lib/js_admin/field.rb
+- lib/js_admin/registry.rb
+- lib/js_admin/resource.rb
+- lib/js_admin/version.rb
+- lib/tasks/js_admin_tasks.rake
+homepage: https://github.com/JoungSik/js_admin
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/JoungSik/js_admin
+  source_code_uri: https://github.com/JoungSik/js_admin/tree/main
+  changelog_uri: https://github.com/JoungSik/js_admin/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Zero-configuration CRUD engine for Rails applications.
+test_files: []