rolemodel-rails 2.1.0 → 2.3.0

data/lib/generators/rolemodel/optics/base/base_generator.rb

@@ -6,15 +6,16 @@ module Rolemodel
       def add_optics_package
         say 'installing Optics package', :green
 
+        ensure_yarn
         run 'yarn add @rolemodel/optics'
       end
 
       def copy_templates
         say 'importing stylesheet', :green
 
-        prepend_to_file Dir.glob('app/assets/stylesheets/application.*').first, <<~SCSS
+        prepend_to_file application_stylesheet_path, <<~CSS
           @import '@rolemodel/optics/dist/css/optics';
-        SCSS
+        CSS
       end
     end
   end

data/lib/generators/rolemodel/react/react_generator.rb

@@ -6,6 +6,7 @@ module Rolemodel
       @add_react = yes?('Would you like to add react?')
 
       if @add_react
+        ensure_yarn
         run 'yarn add react react-dom'
       end
     end

data/lib/generators/rolemodel/readme/templates/README.md.erb

@@ -81,12 +81,10 @@ When finished with the feature and the code has been reviewed, the commits shoul
 ## [Staging](http://staging.<applicationname>.com)
 ## [Production](http://app.<applicationname>.com)
 ## External services
-* [HoneyBadger](http://honeybadger.io)
-* [Skylight](http://skylight.io)
+* [Sentry](https://sentry.io)
 * [SendGrid](http://sendgrid.com/RoleModel)
 * [Heroku](http://herokuapp.com)
 
-## [CI](http://semaphoreci.com/RoleModel)
 ## [Core project presentation](http://docs.google.com)
 ## [List of contributors](http://github.com/RoleModel)
 ## [Change log](file://./docs/change_log.md)
@@ -113,4 +111,4 @@ The application is deployed to Heroku. They are also hosting the DNS. We certifi
 * Larry Anderson - 919-555-1213
 
 # Copyright & licensing
-Copyright (c) 2019 Closed Source @CompanyName
+Copyright (c) 2026 Closed Source @CompanyName

data/lib/generators/rolemodel/saas/devise/devise_generator.rb

@@ -161,11 +161,11 @@ module Rolemodel
         say 'importing login stylesheet', :green
         copy_file 'app/assets/stylesheets/login.css'
 
-        return unless File.exist?(File.join(destination_root, 'app/assets/stylesheets/application.scss'))
+        return unless File.exist?(application_stylesheet_path)
 
-        append_to_file 'app/assets/stylesheets/application.scss', <<~SCSS
+        append_to_file application_stylesheet_path, <<~CSS
           @import 'login';
-        SCSS
+        CSS
       end
     end
   end

data/lib/generators/rolemodel/sentry/README.md

@@ -0,0 +1,25 @@
+# Sentry Generator
+
+## What you get
+
+Error monitoring and performance tracing via [Sentry](https://sentry.io) for both the Ruby and JavaScript sides of the app.
+
+### Ruby
+
+* The `sentry-rails` gem
+* `config/initializers/sentry.rb` with sensible defaults: traces sampling, profiling, PII filtering via Rails' parameter filter, noisy-exception exclusion, and health-check transaction filtering
+* Sentry user context wired into `app/controllers/application_controller.rb` via a `set_sentry_user` before_action (Devise-friendly, gated on `user_signed_in?`)
+
+### JavaScript
+
+* `@sentry/browser` and `@sentry/webpack-plugin` dependencies
+* `app/javascript/initializers/sentry.js`, which initializes Sentry in production and staging only (avoids ad-blocker noise in development) and attaches the current user from a `current-user-id` meta tag
+* The `sentryWebpackPlugin` wired into `webpack.config.js` to upload source maps in production
+
+Depends on the `rolemodel:webpack` generator having already created `webpack.config.js` and `app/javascript/application.js`.
+
+## After running
+
+* Update the `project` and `applicationKey` in `webpack.config.js`, and the matching `filterKeys` in `app/javascript/initializers/sentry.js`, to match your Sentry project.
+* Set the `SENTRY_DSN`, `SENTRY_ENVIRONMENT`, and `SENTRY_AUTH_TOKEN` environment variables.
+* Render a `current-user-id` meta tag in your layout so the browser SDK can attach user context.

data/lib/generators/rolemodel/sentry/USAGE

@@ -0,0 +1,13 @@
+Description:
+    Sets up Sentry error monitoring for both Ruby and JavaScript
+
+Example:
+    rails generate rolemodel:sentry
+
+    This will:
+        Add the sentry-rails gem
+        Create config/initializers/sentry.rb
+        Add Sentry user context to app/controllers/application_controller.rb
+        Add @sentry/browser and @sentry/webpack-plugin JS dependencies
+        Create app/javascript/initializers/sentry.js
+        Wire the Sentry webpack plugin into webpack.config.js

data/lib/generators/rolemodel/sentry/sentry_generator.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Rolemodel
+  class SentryGenerator < GeneratorBase
+    source_root File.expand_path('templates', __dir__)
+
+    JS_DEPS = %w[
+      @sentry/browser
+      @sentry/webpack-plugin
+    ]
+
+    def install_gem
+      say 'Adding sentry-rails gem', :green
+
+      bundle_command 'add sentry-rails'
+    end
+
+    def install_profiler_gem
+      say 'Adding stackprof gem for Sentry profiling', :green
+
+      # config/initializers/sentry.rb sets profiles_sample_rate; without stackprof
+      # the SDK logs a warning on every boot and profiling is silently disabled.
+      # stackprof is a native MRI extension, so restrict it to compatible platforms.
+      bundle_command 'add stackprof --platform ruby'
+      run_bundle
+    end
+
+    def add_ruby_initializer
+      say 'Setting up Sentry for Ruby error reporting', :green
+
+      copy_file 'config/initializers/sentry.rb'
+    end
+
+    def add_user_context
+      say 'Adding Sentry user context to ApplicationController', :green
+
+      directory 'app/controllers/concerns'
+
+      inject_into_class 'app/controllers/application_controller.rb', 'ApplicationController',
+                        "  include SentryUser\n"
+    end
+
+    def add_js_dependencies
+      say 'Adding Sentry JS dependencies to package.json', :green
+
+      ensure_yarn
+      run "yarn add --dev #{JS_DEPS.join(' ')}"
+    end
+
+    def add_js_initializer
+      say 'Setting up Sentry for JS error reporting', :green
+
+      copy_file 'app/javascript/initializers/sentry.js'
+      append_to_file 'app/javascript/application.js', <<~JS
+        import './initializers/sentry'
+      JS
+    end
+
+    # Wire the Sentry webpack plugin into webpack.config.js. Idempotent and a
+    # no-op if there's no webpack.config.js or it's already wired, so the
+    # webpack generator can safely invoke this generator via its --sentry option.
+    def configure_webpack
+      config = File.expand_path('webpack.config.js', destination_root)
+      return unless File.exist?(config)
+      return if File.read(config).include?('@sentry/webpack-plugin')
+
+      say 'Wiring Sentry into webpack.config.js', :green
+
+      inject_into_file 'webpack.config.js',
+                       "import { sentryWebpackPlugin } from '@sentry/webpack-plugin'\n",
+                       after: "import CssMinimizerPlugin from 'css-minimizer-webpack-plugin'\n"
+
+      inject_into_file 'webpack.config.js', after: "'process.env.RAILS_ENV': JSON.stringify(process.env.RAILS_ENV),\n" do
+        <<-JS
+      'process.env.SENTRY_DSN': JSON.stringify(process.env.SENTRY_DSN),
+      'process.env.SENTRY_ENVIRONMENT': JSON.stringify(process.env.SENTRY_ENVIRONMENT),
+      'process.env.SENTRY_AUTH_TOKEN': JSON.stringify(process.env.SENTRY_AUTH_TOKEN),
+        JS
+      end
+
+      gsub_file 'webpack.config.js', "    })\n  ].filter(Boolean)", <<-JS.chomp
+    }),
+
+    // Upload source maps to Sentry in production for easier debugging
+    mode === 'production' &&
+      !process.env.CI &&
+      sentryWebpackPlugin({
+        authToken: process.env.SENTRY_AUTH_TOKEN,
+        org: 'rolemodel-software',
+        project: '#{sentry_app_name}',
+        telemetry: false,
+        applicationKey: 'app-frontend'
+      })
+  ].filter(Boolean)
+      JS
+    end
+
+    def finishing_notes
+      say <<~NOTES
+
+        *** Update the sentryWebpackPlugin `project` and `applicationKey` in webpack.config.js,
+            and the matching `filterKeys` in app/javascript/initializers/sentry.js, to your Sentry project.
+
+        *** Set the SENTRY_DSN, SENTRY_ENVIRONMENT, and SENTRY_AUTH_TOKEN environment variables.
+      NOTES
+    end
+
+    private
+
+    def sentry_app_name
+      Rails.application.name.underscore
+    end
+  end
+end

data/lib/generators/rolemodel/sentry/templates/app/controllers/concerns/sentry_user.rb

@@ -0,0 +1,13 @@
+module SentryUser
+  extend ActiveSupport::Concern
+
+  included { before_action :set_sentry_user }
+
+  private
+
+  def set_sentry_user
+    return unless respond_to?(:current_user) && current_user
+
+    Sentry.set_user(id: current_user.id)
+  end
+end

data/lib/generators/rolemodel/sentry/templates/app/javascript/initializers/sentry.js

@@ -0,0 +1,34 @@
+import * as Sentry from '@sentry/browser'
+
+// Only initialize Sentry in production and staging environments
+// This avoids issues with ad blockers during local development
+const environment = process.env.SENTRY_ENVIRONMENT || process.env.RAILS_ENV
+const shouldInitialize = environment === 'production' || environment === 'staging'
+
+if (shouldInitialize) {
+  Sentry.init({
+    dsn: process.env.SENTRY_DSN,
+    environment: environment,
+    sendDefaultPii: false,
+    tracesSampleRate: 0.1,
+    replaysOnErrorSampleRate: 1.0,
+    integrations: [
+      Sentry.thirdPartyErrorFilterIntegration({
+        // Must match the applicationKey in the sentryWebpackPlugin configuration
+        filterKeys: ['app-frontend'],
+        behaviour: 'drop-error-if-exclusively-contains-third-party-frames'
+      })
+    ],
+
+    // Capture user context from meta tags rendered by Rails
+    beforeSend(event) {
+      const userId = document.querySelector('meta[name="current-user-id"]')?.content
+
+      if (userId) {
+        event.user = { id: userId }
+      }
+
+      return event
+    }
+  })
+}

data/lib/generators/rolemodel/sentry/templates/config/initializers/sentry.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+Sentry.init do |config|
+  config.dsn = ENV['SENTRY_DSN']
+  config.enable_logs = true
+  config.debug = Rails.env.local?
+
+  # Traces sampling — 5% for HTTP requests, 10% for other transactions
+  config.traces_sampler = lambda do |sampling_context|
+    transaction_context = sampling_context[:transaction_context]
+
+    case transaction_context[:op]
+    when /^http/
+      0.05
+    else
+      0.10
+    end
+  end
+
+  # Enable profiling at 100% of sampled transactions
+  config.profiles_sample_rate = 1.0
+
+  # Breadcrumbs configuration
+  config.breadcrumbs_logger = [:sentry_logger, :http_logger]
+
+  # Exclude common noisy exceptions
+  config.excluded_exceptions += [
+    'ActiveRecord::RecordNotFound',
+    'ActionController::RoutingError',
+  ]
+
+  # Include local variables for debugging
+  config.include_local_variables = true
+
+  # Filter out health check transactions
+  config.before_send_transaction = lambda do |event, _hint|
+    return nil if event.transaction&.match?(/health|ping|metrics/)
+    event
+  end
+
+  # Filter sensitive data using Rails' parameter filter
+  filter = ActiveSupport::ParameterFilter.new(Rails.application.config.filter_parameters)
+  config.send_default_pii = false
+
+  config.before_send = lambda do |event, _hint|
+    if event.extra
+      event.extra = filter.filter(event.extra)
+    end
+
+    if event.user
+      event.user = filter.filter(event.user)
+    end
+
+    if event.contexts
+      event.contexts = filter.filter(event.contexts)
+    end
+
+    event
+  end
+
+  config.enabled_patches << :logger
+  config.std_lib_logger_filter = proc do |_logger, _message, severity|
+    [:warn, :error, :fatal].include?(severity)
+  end
+
+  config.rails.register_error_subscriber = Rails.env.production?
+  config.rails.structured_logging.subscribers = config.rails.structured_logging.subscribers.slice(:action_controller)
+end

data/lib/generators/rolemodel/simple_form/README.md

@@ -8,3 +8,9 @@
 * SimpleForm scaffold generation template
 
 Adds SimpleForm for simplified and unified styling that automatically wraps inputs with classes
+
+## Custom inputs
+
+All standard custom inputs are included by default. The generator prompts you to
+confirm whether to include the `tailored_select` custom input, since not every
+project uses the tailored-select web component.

data/lib/generators/rolemodel/simple_form/USAGE

@@ -9,3 +9,6 @@ Example:
         config/locales/simple_form.en.yml
         simple_form input wrapper classes
         simple_form template file
+
+    Pass --tailored_select to also install the experimental tailored_select
+    component input (via the rolemodel:tailored_select generator).

data/lib/generators/rolemodel/simple_form/simple_form_generator.rb

@@ -4,6 +4,9 @@ module Rolemodel
   class SimpleFormGenerator < GeneratorBase
     source_root File.expand_path('templates', __dir__)
 
+    class_option :tailored_select, type: :boolean, default: false,
+                                   desc: 'Install the tailored_select experimental component input'
+
     def add_gem
       Bundler.with_unbundled_env do
         bundle_command 'add simple_form'
@@ -16,5 +19,13 @@ module Rolemodel
       copy_file 'config/initializers/simple_form.rb'
       copy_file 'config/locales/simple_form.en.yml'
     end
+
+    def install_tailored_select
+      return unless options.tailored_select?
+
+      # The tailored_select generator owns the input template and installs it
+      # here because simple_form is now present.
+      generate 'rolemodel:tailored_select'
+    end
   end
 end

data/lib/generators/rolemodel/simple_form/templates/app/inputs/switch_checkbox_input.rb

@@ -14,7 +14,7 @@
 # <%= f.input :my_field, as: :switch_checkbox, label_after_input: true %>
 # <%= f.input :my_field, as: :switch_checkbox, wrapper: :switch_wrapper %>
 class SwitchCheckboxInput < SimpleForm::Inputs::BooleanInput
-  def input(wrapper_options = nil)
+  def input(wrapper_options = nil) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
     merged_input_options = merge_wrapper_options(input_html_options, wrapper_options)
 
     switch_group = template.content_tag(:div, class: "switch #{'switch--small' if options[:small]}") do

data/lib/generators/rolemodel/slim/templates/app/views/application/_head.html.slim.tt

@@ -4,10 +4,6 @@ title <%= Rails.application.class.name.deconstantize.titleize %>
 = csp_meta_tag
 
 meta name="viewport" content="width=device-width, initial-scale=1"
-meta name="turbo-refresh-method" content="morph"
-meta name="turbo-refresh-scroll" content="preserve"
 
 = stylesheet_link_tag 'application', 'data-turbo-track': 'reload'
 = javascript_include_tag 'application', 'data-turbo-track': 'reload', defer: true
-
-= yield :head

data/lib/generators/rolemodel/tailored_select/USAGE

@@ -1,5 +1,6 @@
 Description:
-  runs the tailored select generator
+  Installs the @rolemodel/tailored-select package. If the app is using
+  SimpleForm, it also installs the matching tailored_select SimpleForm input.
 
 Example:
   rails generate rolemodel:tailored_select

data/lib/generators/rolemodel/tailored_select/tailored_select_generator.rb

@@ -7,7 +7,22 @@ module Rolemodel
     def add_tailored_select_package
       say 'Installing Tailored Select package', :green
 
+      ensure_yarn
       run 'yarn add @rolemodel/tailored-select'
     end
+
+    def add_simple_form_input
+      return unless simple_form?
+
+      say 'Installing the Tailored Select SimpleForm input', :green
+
+      copy_file 'app/inputs/tailored_select_input.rb'
+    end
+
+    private
+
+    def simple_form?
+      File.exist?(File.expand_path('config/initializers/simple_form.rb', destination_root))
+    end
   end
 end

data/lib/generators/rolemodel/testing/factory_bot/templates/support/factory_bot.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 RSpec.configure do |config|
   config.include FactoryBot::Syntax::Methods
 end

data/lib/generators/rolemodel/testing/jasmine_playwright/jasmine_playwright_generator.rb

@@ -18,8 +18,8 @@ module Rolemodel
         raise Thor::InvocationError, 'a --github_package_token option or GITHUB_PACKAGES_TOKEN environment variable is required' if options[:github_package_token].blank?
       end
 
-      def yarn_init_unless_package_json_exists
-        run 'yarn init' unless File.exist?(File.expand_path('package.json', destination_root))
+      def enable_corepack_and_yarn
+        ensure_yarn
       end
 
       def add_browser_test_script

data/lib/generators/rolemodel/testing/rspec/rspec_generator.rb

@@ -10,26 +10,24 @@ module Rolemodel
       def install_rspec
         say 'Installing RSpec-rails', :green
 
-        gem_group :development, :test do
-          gem 'rspec-rails'
-        end
+        bundle_command('add rspec-rails --group "development, test"')
+      end
 
+      def install_system_test_driver
         say 'Installing capybara-playwright-driver for system tests', :green
 
-        gem_group :test do
-          gem 'capybara-playwright-driver'
+        bundle_command('add capybara-playwright-driver --group "test"')
+        bundle_command('add marsh_grass --group "test"') if options.marsh_grass?
+      end
 
-          if options.marsh_grass?
-            gem 'marsh_grass'
-            gem 'pry'
-          end
-        end
+      def bundle_install
         run_bundle
       end
 
       def install_playwright
         say 'Installing Playwright for system tests', :green
 
+        ensure_yarn
         run 'yarn add --dev playwright'
         run 'yarn run playwright install'
       end

data/lib/generators/rolemodel/testing/rspec/templates/spec/rails_helper.rb.tt

@@ -70,7 +70,10 @@ RSpec.configure do |config|
       prep_passed = system 'rails spec:prepare'
       ENV['ASSET_PRECOMPILE_SUCCESSFUL'] = 'true'
 
-      abort "\nYour assets didn't compile. Exiting WITHOUT running any tests. Review the output above to resolve any errors." unless prep_passed
+      unless prep_passed
+        abort "\nYour assets didn't compile. Exiting WITHOUT running any tests. " \
+              'Review the output above to resolve any errors.'
+      end
     end
   end
 end

data/lib/generators/rolemodel/testing/rspec/templates/spec/support/capybara_drivers.rb.tt

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 RSpec.configure do |config|
   Capybara.register_driver :playwright_headless do |app|
     create_driver(app)

data/lib/generators/rolemodel/testing/rspec/templates/spec/support/helpers/action_cable_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ActionCableHelper
   def wait_for_stream_connection
     expect(page).to have_selector('turbo-cable-stream-source[connected]', visible: false)

data/lib/generators/rolemodel/testing/rspec/templates/spec/support/helpers/test_element_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module TestElementHelper
   include ActionView::RecordIdentifier
 

data/lib/generators/rolemodel/testing/rspec/templates/spec/support/helpers.rb.tt

@@ -1,4 +1,6 @@
-Dir[Rails.root.join('spec', 'support', 'helpers', '**', '*.rb')].each { |f| require f }
+# frozen_string_literal: true
+
+Rails.root.glob('spec/support/helpers/**/*.rb').each { |f| require f }
 
 # this is a place to pull in all your app specific DSL methods.
 

data/lib/generators/rolemodel/testing/vitest/vitest_generator.rb

@@ -16,6 +16,7 @@ module Rolemodel
 
       def update_test_script
         say 'Update yarn test command', :green
+        ensure_yarn
 
         add_package_json_script 'test', TEST_COMMAND
       end

data/lib/generators/rolemodel/turbo/all/README.md

@@ -0,0 +1,16 @@
+# All Generator
+
+Runs all Turbo Generators
+
+## Prerequisites
+
+  - slim
+  - webpack (if using webpack)
+  - optics
+
+## What you get
+
+  - Turbo meta tags in HEAD
+  - TurboConfirm setup
+  - Turbo Frame Modals setup
+  - Turbo-Form stimulus controller

data/lib/generators/rolemodel/turbo/all/USAGE

@@ -0,0 +1,5 @@
+Description:
+  All Turbo Generators
+
+Example:
+  rails generate rolemodel:turbo:all

data/lib/generators/rolemodel/turbo/all/all_generator.rb

@@ -0,0 +1,15 @@
+module Rolemodel
+  module Turbo
+    class AllGenerator < ::Rolemodel::GeneratorBase
+      source_root File.expand_path('templates', __dir__)
+
+      def run_generators
+        generate 'rolemodel:turbo:ready'
+        generate 'rolemodel:turbo:confirm'
+        generate 'rolemodel:turbo:modals'
+        generate 'rolemodel:turbo:form'
+      end
+    end
+  end
+end
+

data/lib/generators/rolemodel/turbo/confirm/README.md

@@ -0,0 +1,25 @@
+# Confirm Generator
+
+Add custom dialog support to `data-turbo-confirm`
+
+## Prerequisites
+
+* `rolmodel:slim`
+* `rolemodel:webpack`
+* `rolemodel:optics:base`
+
+## What you get
+
+* Custom confirm dialogs via `@rolemodel/turbo-confirm` integration
+
+## Example
+
+```slim
+  = button_to "Test Confirm", model, method: :delete, data: { \
+    turbo_confirm: "For real?!?",
+    confirm_details: "You're about to delete #{model.name}, forever. 😱",
+    confirm_button: "YOLO!",
+  }
+```
+
+data attributes other than `turbo-confirm` are optional & customizable.  See [turbo-confirm](https://github.com/RoleModel/turbo-confirm) for more details.

data/lib/generators/rolemodel/turbo/confirm/USAGE

@@ -0,0 +1,5 @@
+Description:
+  Install @rolemodel/turbo-confirm
+
+Example:
+  rails generate rolemodel:turbo:confirm

data/lib/generators/rolemodel/turbo/confirm/confirm_generator.rb

@@ -0,0 +1,35 @@
+module Rolemodel
+  module Turbo
+    class ConfirmGenerator < ::Rolemodel::GeneratorBase
+      source_root File.expand_path('templates', __dir__)
+
+      def add_turbo_confirm_package
+        say 'Installing Turbo Confirm package', :green
+
+        ensure_yarn
+        run 'yarn add @rolemodel/turbo-confirm'
+      end
+
+      def add_initializer
+        template 'app/javascript/initializers/turbo_confirm.js'
+
+        append_to_file 'app/javascript/application.js' do
+          optimize_indentation <<~JS
+            import './initializers/turbo_confirm.js'
+          JS
+        end
+      end
+
+      def add_view_partial
+        template 'app/views/application/_confirm.html.slim'
+
+        inject_into_file 'app/views/layouts/application.html.slim', after: /\bbody.*\n/ do
+          optimize_indentation <<~SLIM, 4
+            = render 'confirm'
+          SLIM
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/rolemodel/turbo/form/README.md

@@ -0,0 +1,8 @@
+# Form Generator
+
+Enable the "turbo-fetch" (now Turbo-Form) pattern in new/existing rails apps.
+
+## What you get
+
+  - turbo-form controller
+  - system spec helper