fix: allow applications to override scaffold templates

Note that developers can override by placing templates in either:

- lib/templates/tailwindcss/scaffold
- lib/templates/erb/scaffold

Author: flavorjones

Diff for: CHANGELOG.md

@@ -1,8 +1,9 @@
 ## next / unreleased
 
 * Update to [Tailwind CSS v3.4.1](https://github.com/tailwindlabs/tailwindcss/releases/tag/v3.4.1) from v3.4.0 by @flavorjones
-* Fix `password` form field styling in generated scaffold forms. (#304, #307) @flavorjones
-* Fix namespaced mailer generation. (#272, #308) @flavorjones
+* Fix `password` form field styling in generated scaffold forms. (#304) @flavorjones
+* Fix namespaced mailer generation. (#272) @flavorjones
+* Allow overriding the scaffold generator templates by placing application templates in either `lib/templates/tailwindcss/scaffold` or `lib/templates/erb/scaffold`. (#164) @flavorjones
 
 
 ## v2.2.0 / 2023-01-04

Diff for: lib/generators/tailwindcss/scaffold/scaffold_generator.rb

@@ -7,6 +7,7 @@ class ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
       include Rails::Generators::ResourceHelpers
 
       source_root File.expand_path("templates", __dir__)
+      source_paths << "lib/templates/erb/scaffold"
 
       argument :attributes, type: :array, default: [], banner: "field:type field:type"
 

Diff for: test/lib/generators/tailwindcss/scaffold_generator_test.rb

@@ -22,4 +22,28 @@ class Tailwindcss::Generators::ScaffoldGeneratorTest < Rails::Generators::TestCa
       assert_file "app/views/admin/roles/#{view}.html.erb"
     end
   end
+
+  [
+    "lib/templates/tailwindcss/scaffold",
+    "lib/templates/erb/scaffold",
+  ].each do |templates_path|
+    test "overriding generator templates in #{templates_path}" do
+      override_dir = File.join(destination_root, templates_path)
+      FileUtils.mkdir_p override_dir
+      File.open(File.join(override_dir, "index.html.erb"), "w") { |f| f.puts "This is a custom template" }
+
+      # change directory because the generator adds a relative path to source_paths
+      Dir.chdir(destination_root) do
+        run_generator
+      end
+
+      %w(edit new show _form _message).each do |view|
+        assert_file "app/views/messages/#{view}.html.erb"
+      end
+
+      assert_file "app/views/messages/index.html.erb" do |body|
+        assert_match("This is a custom template", body, "index custom template should be used")
+      end
+    end
+  end
 end