ruby_ui_scaffold 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea2c9998050e2208005c500148ed961b083d93530e699992e5d8c2cd2463df05
-  data.tar.gz: 2331070feb2defcd9763082d11b8dd8c38a3523e2e3f1333eca359dd1b042d09
+  metadata.gz: aa48925787982afab3d09cbaff717c090245587dc2c6e6bfd2a9754d0d2945c4
+  data.tar.gz: 00ec82e81ac9d9b06c7f2922dce6e02b7a2866a436ebca8d97102c9f5c66b4ad
 SHA512:
-  metadata.gz: b1965a5ee407847b93b9c01410ac939d9383143f864d7b9d96e2691304ff3f9e7034e7ed61910aa82421b8164760b1273dbdc9685906c083a1d3f1bed79bc692
-  data.tar.gz: fdde9d0a8f65ad928ece8044b07ec1dda306576d48e49bbed7eda5bfdb5ca3822278c9823109f7c977d5f383e2aa57b0130b53e41da3343d9b3c0de690177579
+  metadata.gz: d5fac2bf36315c42e793cd3dc01aeec389d016bd94f315d782bd162914304ee72f08a335a7fe51cfba90c1f9d73d6238a07a14c504a1ab5b31f48f402dd53364
+  data.tar.gz: e18f9aa8c59ac5eac1f0286679885e850549aebb360f450bf4358ae535d5b091cb9096edf520e6da82b71819cbd9fee755d7bb762068a3d29ba3fcf1e35ca3df

data/CHANGELOG.md

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-11-12
+
+### Fixed
+
+- **`rails g ruby_ui_scaffold` generated no model or migration** (and having
+  the gem in the Gemfile broke plain `rails g model` too). The Railtie's
+  `generators` block required the generator classes, which loaded Rails'
+  `ModelGenerator` before `Rails::Generators.configure!` and froze its `:orm`
+  hook as `false`. The Railtie now only sets option defaults; generator
+  classes load lazily, after configuration.
+- **Edit form crashed for `decimal` columns** with
+  `Phlex::ArgumentError (Invalid attribute value for value: 0.58206e3)` —
+  Phlex 2 rejects `BigDecimal` attribute values. The input value is now
+  stringified (`@record.price&.to_s` → `"582.06"`).
+- **Boolean `Badge` rendered without colors.** Templates passed the variant
+  as a string (`"success"`), but `RubyUI::Badge::COLORS` is symbol-keyed and
+  Badge doesn't `to_sym` it. Variants are now symbols (`:success` / `:outline`).
+
+### Changed
+
+- **`ruby_ui` now comes from RubyGems.** The installer adds
+  `gem "ruby_ui", "~> 1.6", require: false` instead of tracking the GitHub
+  `main` branch. Verified end-to-end against ruby_ui 1.6.0. Existing GitHub
+  entries in a Gemfile are still detected and left alone.
+
+### Added
+
+- **Ruby × Rails compatibility matrix** in the README and a GitHub Actions CI
+  workflow that runs the test suite on Ruby 3.2, 3.3, 3.4 and 4.0 against
+  Rails 7.1, 7.2, 8.0 and 8.1 (per-version Gemfiles under `gemfiles/`).
+
+### Changed
+
+- **Minimum Ruby raised to 3.2.** Phlex 2.x (required by `phlex-rails >= 2.0`)
+  already needs Ruby 3.2+, so the previous `>= 3.1` couldn't be installed on 3.1.
+
 ## [0.1.0] - 2026-06-09
 
 ### Added
@@ -339,5 +375,6 @@ if your `Components::Base` already declares it.
   (not `"ruby_ui_scaffold:ruby_ui_scaffold"`) to avoid `find_by_namespace`
   shadowing of the sub-generators when hooks fire.
 
-[Unreleased]: https://github.com/jacksonpires/ruby_ui_scaffold/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/jacksonpires/ruby_ui_scaffold/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/jacksonpires/ruby_ui_scaffold/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/jacksonpires/ruby_ui_scaffold/releases/tag/v0.1.0

data/README.md

@@ -1,5 +1,7 @@
 # ruby_ui_scaffold
 
+[![CI](https://github.com/jacksonpires/ruby_ui_scaffold/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jacksonpires/ruby_ui_scaffold/actions/workflows/ci.yml)
+
 Rails scaffold generator that outputs **Phlex views built with [ruby_ui](https://github.com/ruby-ui/ruby_ui) components**, plus a smart `seed` command to populate models with fake data.
 
 Drop-in alternative to `rails g scaffold` — generates model, migration, controller, routes, tests, and Phlex view classes wired to ruby_ui components.
@@ -8,9 +10,30 @@ Drop-in alternative to `rails g scaffold` — generates model, migration, contro
 
 ## Requirements
 
+- Ruby 3.2+
 - Rails 7.1+
 - Tailwind CSS (any Rails Tailwind setup — `tailwindcss-rails` is fine)
 
+### Compatibility matrix
+
+The full test suite runs in CI against every combination below.
+
+| Ruby \ Rails | 7.1 | 7.2 | 8.0 | 8.1 |
+|--------------|:---:|:---:|:---:|:---:|
+| **4.0**      | ✅  | ✅  | ✅  | ✅  |
+| **3.4**      | ✅  | ✅  | ✅  | ✅  |
+| **3.3**      | ✅  | ✅  | ✅  | ✅  |
+| **3.2**      | ✅  | ✅  | ✅  | ✅  |
+
+Last verified with Ruby 4.0.9 and Rails 8.1.4.1. Ruby 3.1 isn't supported because Phlex 2.x (required by `phlex-rails >= 2.0`) needs Ruby 3.2+.
+
+To run the suite against a specific Rails version locally:
+
+```bash
+BUNDLE_GEMFILE=gemfiles/rails_8.1.gemfile bundle install
+BUNDLE_GEMFILE=gemfiles/rails_8.1.gemfile bundle exec rake test
+```
+
 ## Disclaimer
 
 `ruby_ui_scaffold` is a development-only generator built on the [`ruby_ui`](https://github.com/ruby-ui/ruby_ui) component library — you add both to your app. [`faker`](https://github.com/faker-ruby/faker) and [`lucide-rails`](https://github.com/heyvito/lucide-rails) come along automatically as runtime dependencies of `ruby_ui_scaffold` — `faker` powers the `seed` command, and `lucide-rails` renders the icons in the generated views (the index action menu plus the New / Edit / Create / Update buttons).
@@ -25,7 +48,7 @@ On a fresh Rails app, add **both** gems to your `Gemfile` — `ruby_ui` (the com
 
 ```ruby
 # Gemfile
-gem "ruby_ui", github: "ruby-ui/ruby_ui", branch: "main", require: false
+gem "ruby_ui", "~> 1.6", require: false
 
 group :development do
   gem "ruby_ui_scaffold"
@@ -51,7 +74,7 @@ That's it. The installer wires up phlex, ruby_ui, and the base scaffold componen
 <details>
 <summary>What the installer does</summary>
 
-0. **ruby_ui gem bootstrap** — if `ruby_ui` isn't loadable, adds `gem "ruby_ui", github: "ruby-ui/ruby_ui", branch: "main", require: false` to the Gemfile (unless an entry already exists) and runs `bundle install`. Skipped entirely once the gem loads.
+0. **ruby_ui gem bootstrap** — if `ruby_ui` isn't loadable, adds `gem "ruby_ui", "~> 1.6", require: false` (from RubyGems) to the Gemfile (unless an entry already exists) and runs `bundle install`. Skipped entirely once the gem loads.
 1. **`phlex:install`** — creates `app/views/base.rb` (`Views::Base`), `app/components/base.rb` (`Components::Base`), and `config/initializers/phlex.rb` (wires the `Views::` autoloader). Skipped if `app/views/base.rb` already exists.
 2. **`ruby_ui:install`** — mixes `include RubyUI` into `Components::Base`, adds `config/initializers/ruby_ui.rb`, and the Tailwind preset. Skipped if `Components::Base` already includes RubyUI.
 3. **Base components** — installs the components every scaffold's shell uses regardless of columns/flags: `table`, `link`, `button`, `card`, `typography`, `dropdown_menu`, `alert_dialog`, `form`, `input`. Each is skipped if already present. The installer does **not** run `ruby_ui:component:all` — column/flag-specific components are installed on demand (see below).
@@ -431,7 +454,8 @@ Controllers render via the fully-qualified constant — `render ::Views::Buddies
 | `string`                  | `Input(type: "text")`                                                |
 | `text`                    | `Textarea(rows: 4)`                                                  |
 | `integer`                 | `Input(type: "number", step: 1)`                                     |
-| `float`, `decimal`        | `Input(type: "number", step: "any")`                                 |
+| `float`                   | `Input(type: "number", step: "any")`                                 |
+| `decimal`                 | `Input(type: "number", step: "any")` — value stringified (`&.to_s`)  |
 | `boolean`                 | `Checkbox` + hidden `"0"`                                            |
 | `date`                    | `DatePicker` (ruby_ui — Popover + Calendar over a submittable input) |
 | `time`                    | `Input(type: "time")`                                                |

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

@@ -21,6 +21,11 @@ module RubyUiScaffold
     class InstallGenerator < ::Rails::Generators::Base
       include ::RubyUiScaffold::ComponentInstaller
 
+      # Version constraint for the `ruby_ui` Gemfile entry the installer adds.
+      # ruby_ui is published on RubyGems; 1.6 is the oldest release this gem's
+      # generated views and component set were verified against.
+      RUBY_UI_REQUIREMENT = "~> 1.6"
+
       desc "Install the ruby_ui gem, phlex, ruby_ui, and the base scaffold components."
 
       def check_phlex_rails_gem
@@ -37,9 +42,9 @@ module RubyUiScaffold
       end
 
       # Ensure the `ruby_ui` gem is available. Unlike `phlex-rails` (a declared
-      # runtime dependency of this gem), `ruby_ui` is distributed via GitHub and
-      # can't be a gemspec dependency — so on a fresh app it usually isn't
-      # bundled yet. Rather than abort, add it to the Gemfile and `bundle
+      # runtime dependency of this gem), `ruby_ui` is left to the host app's
+      # Gemfile (so the app controls its version and group, as ruby_ui's own
+      # docs recommend) — so on a fresh app it usually isn't bundled yet. Rather than abort, add it to the Gemfile and `bundle
       # install` automatically, then let the rest of the installer proceed:
       # the subsequent `ruby_ui:install` / `ruby_ui:component` steps run in
       # subprocesses (via run_rails_generator!) that boot with the freshly
@@ -56,7 +61,7 @@ module RubyUiScaffold
           say "\n  → ruby_ui is in the Gemfile but not bundled yet — running `bundle install`.", :cyan
         else
           say "\n  → ruby_ui gem not found — adding it to your Gemfile.", :cyan
-          gem "ruby_ui", github: "ruby-ui/ruby_ui", branch: "main", require: false
+          gem "ruby_ui", RUBY_UI_REQUIREMENT, require: false
         end
 
         run_bundle_install!
@@ -137,7 +142,7 @@ module RubyUiScaffold
       def abort_ruby_ui_unavailable!
         say "\n  ❌  The `ruby_ui` gem isn't available and no Gemfile was found to add it to.", :red
         say "      Add it to your Gemfile, then bundle and retry:\n", :red
-        say %(          gem "ruby_ui", github: "ruby-ui/ruby_ui", branch: "main", require: false), :cyan
+        say %(          gem "ruby_ui", "#{RUBY_UI_REQUIREMENT}", require: false), :cyan
         say "          bundle install"
         say "          bin/rails g ruby_ui_scaffold:install\n", :cyan
         exit(1)

data/lib/generators/ruby_ui_scaffold/ruby_ui_scaffold_generator.rb

@@ -3,6 +3,17 @@
 require "rails/generators"
 require "rails/generators/rails/scaffold/scaffold_generator"
 
+# Load our sub-generators eagerly, together with this entry point. Rails'
+# hook lookup (Rails::Command::Behavior#lookup) requires only the FIRST
+# existing candidate file: for the views hook (`find_by_namespace(
+# "ruby_ui_scaffold", "ruby_ui_scaffold", "scaffold")`) that is THIS file,
+# so `scaffold/scaffold_generator.rb` would never be loaded and the hook
+# reports "ruby_ui_scaffold [not found]". This file itself is loaded lazily
+# by the namespace lookup — after `Rails::Generators.configure!` — so these
+# requires can't freeze option defaults too early (see Railtie).
+require "generators/ruby_ui_scaffold/scaffold_controller/scaffold_controller_generator"
+require "generators/ruby_ui_scaffold/scaffold/scaffold_generator"
+
 module RubyUiScaffold
   module Generators
     # Entry point: `rails g ruby_ui_scaffold User name:string ...`

data/lib/generators/ruby_ui_scaffold/scaffold/templates/index.rb.tt

@@ -43,7 +43,7 @@ class Views::<%= controller_class_name %>::Index < Views::Base
 <% attributes.reject { |a| a.respond_to?(:password_digest?) && a.password_digest? }.each do |attribute| -%>
 <% if attribute.type == :boolean -%>
                 TableCell do
-                  Badge(variant: <%= singular_table_name %>.<%= attribute.column_name %>? ? "success" : "outline") do
+                  Badge(variant: <%= singular_table_name %>.<%= attribute.column_name %>? ? :success : :outline) do
                     <%= singular_table_name %>.<%= attribute.column_name %>? ? "Yes" : "No"
                   end
                 end

data/lib/generators/ruby_ui_scaffold/scaffold/templates/index_data_table.rb.tt

@@ -86,7 +86,7 @@ class Views::<%= controller_class_name %>::Index < Views::Base
 <% attributes.reject { |a| a.respond_to?(:password_digest?) && a.password_digest? }.each do |attribute| -%>
 <% if attribute.type == :boolean -%>
                   TableCell do
-                    Badge(variant: <%= singular_table_name %>.<%= attribute.column_name %>? ? "success" : "outline") do
+                    Badge(variant: <%= singular_table_name %>.<%= attribute.column_name %>? ? :success : :outline) do
                       <%= singular_table_name %>.<%= attribute.column_name %>? ? "Yes" : "No"
                     end
                   end

data/lib/generators/ruby_ui_scaffold/scaffold/templates/show.rb.tt

@@ -35,7 +35,7 @@ class Views::<%= controller_class_name %>::Show < Views::Base
         div do
           Text(weight: "medium") { "<%= attribute.human_name %>:" }
 <% if attribute.type == :boolean -%>
-          Badge(variant: @<%= singular_table_name %>.<%= attribute.column_name %>? ? "success" : "outline") do
+          Badge(variant: @<%= singular_table_name %>.<%= attribute.column_name %>? ? :success : :outline) do
             @<%= singular_table_name %>.<%= attribute.column_name %>? ? "Yes" : "No"
           end
 <% elsif reference_associations.include?(attribute.name.to_sym) -%>

data/lib/generators/ruby_ui_scaffold/scaffold_controller/scaffold_controller_generator.rb

@@ -3,6 +3,10 @@
 require "rails/generators"
 require "rails/generators/rails/scaffold_controller/scaffold_controller_generator"
 require "ruby_ui_scaffold/attribute_helpers"
+# Our template_engine hook target. Required directly so a standalone
+# `rails g ruby_ui_scaffold:scaffold_controller` resolves it too (see the
+# note in ruby_ui_scaffold_generator.rb on Rails' first-match lookup).
+require "generators/ruby_ui_scaffold/scaffold/scaffold_generator"
 
 module RubyUiScaffold
   module Generators

data/lib/ruby_ui_scaffold/field_type_mapper.rb

@@ -38,7 +38,10 @@ module RubyUiScaffold
       when :text                    then textarea
       when :boolean                 then checkbox
       when :integer                 then input("number", step: 1)
-      when :float, :decimal         then input("number", step: "any")
+      when :float                   then input("number", step: "any")
+      # Phlex 2 rejects BigDecimal attribute values (Phlex::ArgumentError), so
+      # stringify — ActiveSupport makes BigDecimal#to_s plain notation ("582.06").
+      when :decimal                 then input("number", step: "any", value_suffix: "&.to_s")
       when :date                    then date_picker
       when :time                    then input("time", value_suffix: %q{&.strftime("%H:%M")})
       when :datetime, :timestamp    then input("datetime-local", value_suffix: %q{&.strftime("%Y-%m-%dT%H:%M")})

data/lib/ruby_ui_scaffold/railtie.rb

@@ -6,20 +6,24 @@ module RubyUiScaffold
     # (i.e. on `rails g`), not at app boot — important because
     # Rails::Generators isn't loaded at boot.
     generators do
-      # IMPORTANT: set option defaults BEFORE requiring the generator
-      # classes. `class_option(...)` (called by `hook_for`) freezes the
-      # default at class-definition time via `default_value_for_option`,
-      # which reads from Rails::Generators.options.
+      # Only set option defaults here — do NOT require any generator class.
       #
-      # We only need to override template_engine — the scaffold_controller
-      # default falls back to :scaffold_controller (Rails-wide), which
-      # combined with our base_name routes correctly to ours.
+      # Rails runs every railtie's `generators` block BEFORE
+      # `Rails::Generators.configure!(app.config.generators)` (see
+      # Rails::Engine#load_generators). `hook_for`/`class_option` freeze their
+      # defaults at class-definition time, so requiring our generators here
+      # would also load Rails' ScaffoldGenerator → ModelGenerator early, and
+      # their `:orm` hook would freeze as `false` (the pre-configure default)
+      # instead of `:active_record` — silently skipping the model + migration
+      # for `rails g ruby_ui_scaffold` AND plain `rails g model`.
+      #
+      # Our generator classes are instead loaded lazily by Rails' namespace
+      # lookup (`generators/ruby_ui_scaffold/...`), after configure! has run,
+      # and they read this template_engine default at that point. The
+      # scaffold_controller default falls back to :scaffold_controller
+      # (Rails-wide), which combined with our base_name routes to ours.
       ::Rails::Generators.options[:ruby_ui_scaffold] ||= {}
       ::Rails::Generators.options[:ruby_ui_scaffold][:template_engine] = "ruby_ui_scaffold"
-
-      require "generators/ruby_ui_scaffold/ruby_ui_scaffold_generator"
-      require "generators/ruby_ui_scaffold/scaffold_controller/scaffold_controller_generator"
-      require "generators/ruby_ui_scaffold/scaffold/scaffold_generator"
     end
   end
 end

data/lib/ruby_ui_scaffold/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_ui_scaffold
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jackson Pires
@@ -184,14 +184,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Rails scaffold generator that outputs Phlex views built with ruby_ui components.
 test_files: []