Setup Cuprite

spec/support/capybara.rb

@@ -1,3 +1,12 @@
 # frozen_string_literal: true
 
 Capybara.server = :puma
+Capybara.default_driver = Capybara.javascript_driver = :cuprite
+
+RSpec.configure do |config|
+  # Make sure this hook runs before others
+  config.prepend_before(:each, type: :system) do
+    # Use JS driver always
+    driven_by Capybara.javascript_driver
+  end
+end

spec/support/capybara_cuprite.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'capybara/cuprite'
+
+Capybara.register_driver(:cuprite) do |app|
+  browser_options = {}.tap do |opts|
+    opts['no-sandbox'] = nil if ENV['CI']
+  end
+
+  Capybara::Cuprite::Driver.new(
+    app,
+    **{
+      window_size: [1600, 1280],
+      # See additional options for Dockerized environment in the respective section of this article
+      browser_options: browser_options,
+      # Increase Chrome startup wait time (required for stable CI builds)
+      process_timeout: 30,
+      # The number of seconds we'll wait for a response when communicating with browser. Default is 5
+      timeout: 30,
+      # Enable debugging capabilities
+      inspector: true,
+      # Allow running Chrome in a headful mode by setting HEADLESS env var to a falsey value
+      headless: !ENV['CUPRITE_HEADLESS'].in?(%w[n 0 no false])
+    }
+  )
+end

spec/support/drivers.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.configure do |config|
-  config.before(:each, type: :system) do
-    driven_by(:selenium_chrome_headless)
-  end
-end