docs: add Non-Rails setup, GitHub Actions integration, animation tip

- Non-Rails section: Rack-based setup for Hugo/Jekyll/static sites
- GitHub Actions: upload HTML report as artifact on failure
- Troubleshooting: mention Capybara.disable_animation for CSS animations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: pftg

README.md

@@ -827,6 +827,41 @@ CapybaraScreenshotDiff.reporters << MyReporter.new
 
 Reporters are notified before assertions are cleared on each test teardown. `finalize` is called via `at_exit`.
 
+### Non-Rails Projects (Hugo, Jekyll, Static Sites)
+
+```ruby
+# test/test_helper.rb
+require 'capybara_screenshot_diff/static'
+
+CapybaraScreenshotDiff.serve("_site")  # or "public", "build", "dist"
+```
+
+This sets up Capybara to serve static files and configures screenshot paths automatically.
+
+### GitHub Actions Integration
+
+Upload the HTML report as a CI artifact so reviewers can browse screenshot diffs directly:
+
+```yaml
+# .github/workflows/test.yml
+- name: Run tests
+  run: bundle exec rake test
+
+- name: Upload screenshot report
+  if: failure()
+  uses: actions/upload-artifact@v4
+  with:
+    name: screenshot-diffs
+    path: tmp/snap_diff-report/
+    retention-days: 7
+```
+
+To enable the HTML report, add to your test helper:
+
+```ruby
+require 'capybara_screenshot_diff/reporters/html'
+```
+
 ## Troubleshooting
 
 **"No existing screenshot found"**
@@ -838,7 +873,8 @@ Font rendering varies across OS versions. Use `tolerance: 0.001` or `perceptual_
 to ignore sub-pixel differences. Set `window_size` to ensure consistent browser dimensions.
 
 **Animations cause flaky diffs**
-Set `stability_time_limit: 1` to wait for the page to stabilize before capturing.
+Set `Capybara.disable_animation = true` in your test helper to disable CSS animations globally.
+For JS animations, add `stability_time_limit: 1` to wait for the page to stabilize.
 The gem takes multiple screenshots and compares them until two consecutive ones match.
 
 **Dynamic content (timestamps, ads) always differs**

lib/capybara_screenshot_diff/static.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "rack/files"
+require "capybara_screenshot_diff/minitest"
+
+module CapybaraScreenshotDiff
+  def self.serve(directory, root: Dir.pwd)
+    Capybara.app = Rack::Files.new(directory)
+    Capybara::Screenshot.root = root
+  end
+end

test/unit/static_test.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "capybara_screenshot_diff/static"
+
+module CapybaraScreenshotDiff
+  class StaticTest < ActiveSupport::TestCase
+    teardown do
+      Capybara.app = Rails.application
+    end
+
+    test ".serve sets Capybara.app to serve the directory" do
+      CapybaraScreenshotDiff.serve("test/fixtures")
+
+      assert_kind_of Rack::Files, Capybara.app
+    end
+
+    test ".serve sets Screenshot.root to pwd" do
+      CapybaraScreenshotDiff.serve("test/fixtures")
+
+      assert_equal Pathname(Dir.pwd), Capybara::Screenshot.root
+    end
+
+    test ".serve accepts custom root" do
+      CapybaraScreenshotDiff.serve("test/fixtures", root: "/tmp")
+
+      assert_equal Pathname("/tmp"), Capybara::Screenshot.root
+    end
+  end
+end