quick_admin 0.1.0

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

@@ -0,0 +1,14 @@
+<turbo-frame id="modal">
+  <div class="modal-overlay" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">
+    <div class="modal-content" onclick="event.stopPropagation()">
+      <div class="modal-header">
+        <h2>Edit <%= @resource_config.model_name.singularize.humanize %></h2>
+        <button type="button" class="modal-close" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">&times;</button>
+      </div>
+      
+      <div class="modal-body">
+        <%= render "form", resource: @resource %>
+      </div>
+    </div>
+  </div>
+</turbo-frame>

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

@@ -0,0 +1,38 @@
+<div class="resources-index">
+  <div class="page-header">
+    <h1><%= @resource_config.display_name %></h1>
+    <%= link_to "Add New #{@resource_config.model_name.singularize.humanize}", 
+                quick_admin.new_resource_path(resource_name), 
+                class: "btn btn-primary",
+                data: { turbo_frame: "modal" } %>
+  </div>
+
+  <div class="filters-section">
+    <%= form_with url: quick_admin.resources_path(resource_name), method: :get, 
+                  local: false, data: { turbo_frame: "resources_list" }, 
+                  class: "search-form" do |f| %>
+      <% if @resource_config.searchable_fields.any? %>
+        <%= f.text_field :search, 
+                         placeholder: "Search #{@resource_config.searchable_fields.join(', ')}", 
+                         value: params[:search],
+                         data: { search: "input" },
+                         class: "search-input" %>
+      <% end %>
+      
+      <% @resource_config.filterable_fields.each do |field| %>
+        <%= f.select "filter[#{field}]", 
+                     options_for_select(filter_options_for_field(@resource_config.model_class, field), params.dig(:filter, field)),
+                     { include_blank: "All #{field.humanize}" },
+                     { data: { filter: "select" }, class: "filter-select" } %>
+      <% end %>
+    <% end %>
+  </div>
+
+  <turbo-frame id="resources_list">
+    <%= render "resources_list", resources: @resources, pagy: @pagy %>
+  </turbo-frame>
+</div>
+
+<turbo-frame id="modal">
+  <!-- Modal content will be loaded here -->
+</turbo-frame>

data/app/views/quick_admin/resources/index.turbo_stream.erb

@@ -0,0 +1,3 @@
+<%= turbo_stream.update "resources_list" do %>
+  <%= render "resources_list", resources: @resources, pagy: @pagy %>
+<% end %>

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

@@ -0,0 +1,14 @@
+<turbo-frame id="modal">
+  <div class="modal-overlay" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">
+    <div class="modal-content" onclick="event.stopPropagation()">
+      <div class="modal-header">
+        <h2>New <%= @resource_config.model_name.singularize.humanize %></h2>
+        <button type="button" class="modal-close" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">&times;</button>
+      </div>
+      
+      <div class="modal-body">
+        <%= render "form", resource: @resource %>
+      </div>
+    </div>
+  </div>
+</turbo-frame>

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

@@ -0,0 +1,38 @@
+<turbo-frame id="modal">
+  <div class="modal-overlay" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">
+    <div class="modal-content" onclick="event.stopPropagation()">
+      <div class="modal-header">
+        <h2><%= @resource_config.model_name.singularize.humanize %> Details</h2>
+        <button type="button" class="modal-close" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">&times;</button>
+      </div>
+      
+      <div class="modal-body">
+        <div class="resource-details">
+          <% @resource_config.fields.each do |field| %>
+            <div class="detail-row">
+              <label class="detail-label"><%= field.humanize %>:</label>
+              <div class="detail-value">
+                <%= display_field_value(@resource, field) %>
+              </div>
+            </div>
+          <% end %>
+        </div>
+        
+        <div class="detail-actions">
+          <%= link_to "Edit", quick_admin.edit_resource_path(resource_name, @resource), 
+                      class: "btn btn-warning",
+                      data: { turbo_frame: "modal" } %>
+          <%= button_to "Delete", quick_admin.resource_path(resource_name, @resource), 
+                        method: :delete,
+                        class: "btn btn-danger",
+                        form_class: "inline-form",
+                        local: false,
+                        data: { 
+                          turbo_confirm: "Are you sure?"
+                        } %>
+          <button type="button" class="btn btn-secondary" onclick="document.getElementById('modal').innerHTML = ''; document.body.style.overflow = '';">Close</button>
+        </div>
+      </div>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/quick_admin/resources/update.turbo_stream.erb

@@ -0,0 +1,9 @@
+<%= turbo_stream.update "modal", "" %>
+<%= turbo_stream.update "resources_list" do %>
+  <%= render "resources_list", resources: @resources, pagy: @pagy %>
+<% end %>
+<%= turbo_stream.append "body" do %>
+  <div class="flash-message alert alert-success" style="position: fixed; top: 20px; right: 20px; z-index: 9999;" data-auto-dismiss="true">
+    Record updated successfully!
+  </div>
+<% end %>

data/config/routes.rb

@@ -0,0 +1,14 @@
+QuickAdmin::Engine.routes.draw do
+  root 'dashboard#index'
+  
+  get ':resource_name', to: 'resources#index', as: :resources
+  get ':resource_name/new', to: 'resources#new', as: :new_resource
+  post ':resource_name', to: 'resources#create'
+  get ':resource_name/:id', to: 'resources#show', as: :resource
+  get ':resource_name/:id/edit', to: 'resources#edit', as: :edit_resource
+  patch ':resource_name/:id', to: 'resources#update'
+  put ':resource_name/:id', to: 'resources#update'
+  delete ':resource_name/:id', to: 'resources#destroy'
+  delete ':resource_name', to: 'resources#bulk_destroy', as: :bulk_destroy_resources
+  get ':resource_name/:id/attachment/:field(/:signed_id)', to: 'resources#attachment', as: :resource_attachment
+end

data/lib/generators/quick_admin/install_generator.rb

@@ -0,0 +1,37 @@
+require 'rails/generators'
+
+module QuickAdmin
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+      
+      desc 'Install QuickAdmin configuration and mount the engine'
+      
+      def create_initializer
+        template 'quick_admin.rb', 'config/initializers/quick_admin.rb'
+      end
+      
+      def add_route
+        route 'mount QuickAdmin::Engine, at: "/admin"'
+      end
+      
+      def show_usage
+        say "\n"
+        say "QuickAdmin has been installed!", :green
+        say "\n"
+        say "Next steps:", :yellow
+        say "1. Configure your resources in config/initializers/quick_admin.rb"
+        say "2. Visit http://localhost:3000/admin to access your admin panel"
+        say "\n"
+        say "Example resource configuration:", :cyan
+        say <<-EXAMPLE
+QuickAdmin.resource :user do |r|
+  r.fields :name, :email, :created_at
+  r.searchable :name, :email
+  r.editable :name, :email
+end
+        EXAMPLE
+      end
+    end
+  end
+end

data/lib/generators/quick_admin/templates/quick_admin.rb

@@ -0,0 +1,43 @@
+# QuickAdmin Configuration
+QuickAdmin.configure do |config|
+  # Authentication settings
+  # config.authentication = :devise  # Use Devise authentication
+  # config.authentication = :custom  # Use custom authentication (override admin_authenticated? method)
+  config.authentication = nil        # No authentication (default)
+  
+  # CSS Framework
+  # config.css_framework = :tailwind  # Use Tailwind CSS
+  # config.css_framework = :bootstrap # Use Bootstrap
+  config.css_framework = :none       # Use built-in styles (default)
+  
+  # Text Editor
+  # config.text_editor = :trix        # Use Trix editor (requires Action Text)
+  # config.text_editor = :lexical     # Use Lexical editor
+  config.text_editor = :textarea     # Use simple textarea (default)
+  
+  # Turbo/Hotwire settings
+  config.turbo_enabled = true        # Enable Turbo (default: true)
+  config.stimulus_enabled = true     # Enable Stimulus (default: true)
+  
+  # General settings
+  config.per_page = 25              # Records per page
+  config.mount_path = '/admin'      # Mount path for admin interface
+  config.app_name = 'QuickAdmin'    # App name shown in navigation
+end
+
+# Configure your resources here
+# Example:
+# QuickAdmin.resource :user do |r|
+#   r.fields :name, :email, :created_at, :updated_at
+#   r.searchable :name, :email
+#   r.filterable :created_at
+#   r.editable :name, :email
+#   r.name 'Users'
+# end
+
+# QuickAdmin.resource :post do |r|
+#   r.fields :title, :content, :published, :created_at
+#   r.searchable :title, :content
+#   r.filterable :published, :created_at
+#   r.editable :title, :content, :published
+# end

data/lib/quick_admin/configuration.rb

@@ -0,0 +1,59 @@
+module QuickAdmin
+  # Configuration class for QuickAdmin.
+  # Holds all configuration options for the admin interface.
+  #
+  # @attr authentication [Symbol, nil] authentication method (:devise, :custom, or nil)
+  # @attr css_framework [Symbol] CSS framework to use (:tailwind, :bootstrap, or :none)
+  # @attr text_editor [Symbol] text editor for rich text fields (:trix, :lexical, or :textarea)
+  # @attr turbo_enabled [Boolean] whether to enable Turbo (default: true)
+  # @attr stimulus_enabled [Boolean] whether to enable Stimulus (default: true)
+  # @attr per_page [Integer] number of records per page (default: 25)
+  # @attr mount_path [String] URL path where admin is mounted (default: '/admin')
+  # @attr app_name [String] application name shown in UI (default: 'QuickAdmin')
+  class Configuration
+    attr_accessor :authentication, :css_framework, :text_editor, :turbo_enabled, 
+                  :stimulus_enabled, :per_page, :mount_path, :app_name
+
+    # Initializes a new Configuration with default values.
+    def initialize
+      @authentication = nil           # No authentication by default
+      @css_framework = :none          # Use built-in styles
+      @text_editor = :textarea        # Simple textarea editor
+      @turbo_enabled = true           # Turbo enabled for modern UX
+      @stimulus_enabled = true        # Stimulus enabled for controllers
+      @per_page = 25                  # Reasonable default pagination
+      @mount_path = '/admin'          # Standard admin path
+      @app_name = 'QuickAdmin'        # Default app name
+    end
+
+    # Checks if Devise authentication is enabled and available.
+    # @return [Boolean] true if devise is configured and gem is loaded
+    def devise_enabled?
+      authentication == :devise && defined?(Devise)
+    end
+
+    # Checks if Tailwind CSS framework is enabled.
+    # @return [Boolean] true if tailwind is configured
+    def tailwind_enabled?
+      css_framework == :tailwind
+    end
+
+    # Checks if Bootstrap CSS framework is enabled.
+    # @return [Boolean] true if bootstrap is configured
+    def bootstrap_enabled?
+      css_framework == :bootstrap
+    end
+
+    # Checks if Trix editor is enabled and available.
+    # @return [Boolean] true if trix is configured and gem is loaded
+    def trix_enabled?
+      text_editor == :trix && defined?(Trix)
+    end
+
+    # Checks if Lexical editor is enabled.
+    # @return [Boolean] true if lexical is configured
+    def lexical_enabled?
+      text_editor == :lexical
+    end
+  end
+end

data/lib/quick_admin/engine.rb

@@ -0,0 +1,20 @@
+module QuickAdmin
+  class Engine < ::Rails::Engine
+    isolate_namespace QuickAdmin
+
+    config.generators do |g|
+      g.test_framework :rspec
+      g.fixture_replacement :factory_bot
+      g.assets false
+      g.helper false
+    end
+
+    initializer "quick_admin.assets.precompile" do |app|
+      if app.config.respond_to?(:assets) && app.config.assets.respond_to?(:precompile)
+        app.config.assets.precompile += %w( quick_admin/application.css quick_admin/application.js )
+      end
+    end
+
+    # Engine configuration - no auto-mounting to avoid conflicts
+  end
+end

data/lib/quick_admin/resource.rb

@@ -0,0 +1,102 @@
+module QuickAdmin
+  # Resource represents a model configuration for the admin interface.
+  # It defines which fields to display, search, filter, and edit.
+  #
+  # @attr model_name [String] the name of the model
+  # @attr searchable_fields [Array<String>] fields that can be searched
+  # @attr filterable_fields [Array<String>] fields that can be filtered
+  # @attr editable_fields [Array<String>] fields that can be edited
+  # @attr display_name [String] human-friendly name for the resource
+  class Resource
+    attr_accessor :model_name, :searchable_fields,
+                  :filterable_fields, :editable_fields, :display_name
+
+    # Initializes a new Resource.
+    #
+    # @param model_name [Symbol, String] the name of the model
+    def initialize(model_name)
+      @model_name = model_name.to_s
+      @fields = []
+      @searchable_fields = []
+      @filterable_fields = []
+      @editable_fields = []
+      @display_name = model_name.to_s.humanize.pluralize
+    end
+
+    # Returns the actual model class for this resource.
+    # Attempts to constantize the model name.
+    #
+    # @return [Class, nil] the model class or nil if not found
+    def model_class
+      @model_class ||= model_name.classify.constantize
+    rescue NameError => e
+      Rails.logger.warn "QuickAdmin: Could not load model class for #{model_name}: #{e.message}"
+      nil
+    end
+
+    # Gets or sets the fields to display in the index view.
+    #
+    # @param field_names [Array<Symbol>] optional field names to set
+    # @return [Array<String>] the list of field names
+    #
+    # @example
+    #   r.fields :name, :email, :created_at  # setter
+    #   r.fields                              # getter
+    def fields(*field_names)
+      if field_names.any?
+        @fields = field_names.map(&:to_s)
+      else
+        @fields.empty? ? default_fields : @fields
+      end
+    end
+
+    # Gets or sets the searchable fields.
+    #
+    # @param field_names [Array<Symbol>] optional field names to set
+    # @return [Array<String>] the list of searchable field names
+    def searchable(*field_names)
+      @searchable_fields = field_names.map(&:to_s) if field_names.any?
+      @searchable_fields
+    end
+
+    # Gets or sets the filterable fields.
+    #
+    # @param field_names [Array<Symbol>] optional field names to set
+    # @return [Array<String>] the list of filterable field names
+    def filterable(*field_names)
+      @filterable_fields = field_names.map(&:to_s) if field_names.any?
+      @filterable_fields
+    end
+
+    # Gets or sets the editable fields.
+    #
+    # @param field_names [Array<Symbol>] optional field names to set
+    # @return [Array<String>] the list of editable field names
+    def editable(*field_names)
+      @editable_fields = field_names.map(&:to_s) if field_names.any?
+      @editable_fields
+    end
+
+    # Gets or sets the display name for this resource.
+    #
+    # @param display_name [String, nil] optional display name to set
+    # @return [String] the display name
+    def name(display_name = nil)
+      @display_name = display_name if display_name
+      @display_name
+    end
+
+    private
+
+    # Returns default fields from the model if no fields are explicitly set.
+    # Excludes id, created_at, and updated_at by default.
+    #
+    # @return [Array<String>] list of column names
+    def default_fields
+      return [] unless model_class&.respond_to?(:column_names)
+
+      excluded_fields = %w[id created_at updated_at]
+      model_class.column_names.reject { |field| excluded_fields.include?(field) }
+    end
+  end
+end

data/lib/quick_admin/version.rb

@@ -0,0 +1,3 @@
+module QuickAdmin
+  VERSION = "0.1.0"
+end

data/lib/quick_admin.rb

@@ -0,0 +1,70 @@
+require "turbo-rails"
+require "quick_admin/version"
+require "quick_admin/engine"
+require "quick_admin/configuration"
+require "quick_admin/resource"
+
+# QuickAdmin is a lightweight Rails admin interface gem.
+# It provides CRUD operations, search, filtering, and modern Turbo/Hotwire integration
+# with minimal configuration.
+#
+# @example Basic configuration
+#   QuickAdmin.configure do |config|
+#     config.authentication = :devise
+#     config.per_page = 25
+#   end
+#
+# @example Defining a resource
+#   QuickAdmin.resource :user do |r|
+#     r.fields :name, :email, :created_at
+#     r.searchable :name, :email
+#     r.editable :name, :email
+#   end
+module QuickAdmin
+  class << self
+    attr_accessor :configuration
+  end
+
+  # Configures QuickAdmin with the given block.
+  # Creates a new configuration if one doesn't exist.
+  #
+  # @yield [Configuration] the configuration object
+  # @return [Configuration] the configuration object
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+
+  # Returns the current configuration or creates a new one.
+  #
+  # @return [Configuration] the configuration object
+  def self.config
+    self.configuration ||= Configuration.new
+  end
+
+  # Returns a hash of all registered resources.
+  #
+  # @return [Hash<String, Resource>] hash of resource name to Resource objects
+  def self.resources
+    @resources ||= {}
+  end
+
+  # Registers a new resource with QuickAdmin.
+  #
+  # @param model_name [Symbol, String] the name of the model (e.g., :user, :post)
+  # @yield [Resource] the resource configuration object
+  # @return [Resource] the configured resource
+  #
+  # @example
+  #   QuickAdmin.resource :post do |r|
+  #     r.fields :title, :content, :published
+  #     r.searchable :title, :content
+  #     r.filterable :published
+  #     r.editable :title, :content, :published
+  #   end
+  def self.resource(model_name, &block)
+    resource = Resource.new(model_name)
+    yield(resource) if block_given?
+    resources[model_name.to_s] = resource
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: quick_admin
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nezir Zahirovic
+bindir: bin
+cert_chain: []
+date: 1980-01-02 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.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: A lightweight Rails admin gem with minimal dependencies, featuring CRUD
+  operations, search, filtering, and modern Turbo/Hotwire integration
+email:
+- nezir.zahirovic@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/javascripts/quick_admin/application.js
+- app/assets/javascripts/quick_admin/controllers/alert_controller.js
+- app/assets/javascripts/quick_admin/controllers/bulk_actions_controller.js
+- app/assets/javascripts/quick_admin/controllers/modal_controller.js
+- app/assets/javascripts/quick_admin/controllers/search_controller.js
+- app/assets/javascripts/quick_admin/controllers/text_expander_controller.js
+- app/assets/stylesheets/quick_admin/application.css
+- app/controllers/quick_admin/application_controller.rb
+- app/controllers/quick_admin/dashboard_controller.rb
+- app/controllers/quick_admin/resources_controller.rb
+- app/helpers/quick_admin/application_helper.rb
+- app/views/layouts/quick_admin/application.html.erb
+- app/views/quick_admin/dashboard/index.html.erb
+- app/views/quick_admin/resources/_form.html.erb
+- app/views/quick_admin/resources/_pagination.html.erb
+- app/views/quick_admin/resources/_resource_row.html.erb
+- app/views/quick_admin/resources/_resources_list.html.erb
+- app/views/quick_admin/resources/attachment.html.erb
+- app/views/quick_admin/resources/bulk_destroy.turbo_stream.erb
+- app/views/quick_admin/resources/create.turbo_stream.erb
+- app/views/quick_admin/resources/destroy.turbo_stream.erb
+- app/views/quick_admin/resources/edit.html.erb
+- app/views/quick_admin/resources/index.html.erb
+- app/views/quick_admin/resources/index.turbo_stream.erb
+- app/views/quick_admin/resources/new.html.erb
+- app/views/quick_admin/resources/show.html.erb
+- app/views/quick_admin/resources/update.turbo_stream.erb
+- config/routes.rb
+- lib/generators/quick_admin/install_generator.rb
+- lib/generators/quick_admin/templates/quick_admin.rb
+- lib/quick_admin.rb
+- lib/quick_admin/configuration.rb
+- lib/quick_admin/engine.rb
+- lib/quick_admin/resource.rb
+- lib/quick_admin/version.rb
+homepage: https://github.com/nezirz/quick_admin
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/nezirz/quick_admin
+  source_code_uri: https://github.com/nezirz/quick_admin
+  changelog_uri: https://github.com/nezirz/quick_admin/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/nezirz/quick_admin/issues
+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: 2.0.0
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Simple, minimal Rails admin interface
+test_files: []