rails_accessibility_testing 1.4.1 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdfb13e559e3d6d786ac41d4027b1b89272b5595d2bc6b9324db3ee6082a8d90
-  data.tar.gz: b8b3420d7ba19cb20bb2a6b3601196e996e5e372aab780ec3de0a6ae7b44f22d
+  metadata.gz: 7a60633c05618ff8bc3fa720655c2a954675aa9a7ab5fdc3b515f18f937481ec
+  data.tar.gz: e15e7a3238221d4ae21ed60bf451818fbc94bca45ea6af4c0f9675309125ab63
 SHA512:
-  metadata.gz: c2abe639249eca589eb405aeb0432b7fa57c45214c8de1b044c4fc1a5118c229ae16d90d04b7368ed3430830400ae77ef7a3848623edb587ec222a28b50f9376
-  data.tar.gz: ddc8a6f229e2038c080d923f0c9d25a21949543e581c8131b23c7e3536ffb633a9ee0ad855dce7d2bd2e9482a959a07f7171e021e08a7c5f5d831f0fb0994d1d
+  metadata.gz: ff0b0cfc0c3f51b2bf022ffa97bfeab3c50da7cd0c3afb024d0ab8043f9cf599df8bb76f6cf8d3c97127a352e7050b5309819eac6b91030c5ea73a2e5d01c6ac
+  data.tar.gz: 9debe7aa2879d009108cbb801e158fc12e8c12e592f69c76e2a603c3fd8db4ad72b8e322d15e5d0987dbcb4e6b4f146e24edb5bd3cc1c4b241a5f0659e548cfb

data/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.2] - 2025-11-18
+
+### Added
+- Procfile.dev documentation for continuous accessibility checking during development
+- Instructions for running accessibility checks automatically every 30 seconds via `bin/dev`
+- Updated getting started guides with Procfile setup examples
+- Enhanced README with continuous testing workflow documentation
+
+### Improved
+- Better developer experience with continuous accessibility feedback during development
+- Clearer documentation on multiple ways to run accessibility checks (manual vs continuous)
+- Improved onboarding with step-by-step Procfile setup instructions
+
 ## [1.4.1] - 2025-11-18
 
 ### Changed
@@ -155,6 +168,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Compatible with RSpec Rails 6.0+
 - Modular architecture with rule engine and check definitions
 
+[1.4.2]: https://github.com/rayraycodes/rails-accessibility-testing/releases/tag/v1.4.2
 [1.4.1]: https://github.com/rayraycodes/rails-accessibility-testing/releases/tag/v1.4.1
 [1.4.0]: https://github.com/rayraycodes/rails-accessibility-testing/releases/tag/v1.4.0
 [1.3.0]: https://github.com/rayraycodes/rails-accessibility-testing/releases/tag/v1.3.0

data/GUIDES/getting_started.md

@@ -40,7 +40,9 @@ This creates:
 
 ### Step 3: Run Your Tests
 
-That's it! Just run your system specs:
+You can run accessibility checks in several ways:
+
+#### Option A: Run Tests Manually
 
 ```bash
 bundle exec rspec spec/system/
@@ -48,6 +50,29 @@ bundle exec rspec spec/system/
 
 Accessibility checks run automatically on every system test that visits a page.
 
+#### Option B: Run Continuously with Procfile (Recommended for Development)
+
+For continuous accessibility checking during development, add to your `Procfile.dev`:
+
+```procfile
+web: bin/rails server
+css: bin/rails dartsass:watch
+a11y: while true; do bundle exec rspec spec/system/*_accessibility_spec.rb; sleep 30; done
+```
+
+Then run:
+
+```bash
+bin/dev
+```
+
+This will:
+- Start your Rails server
+- Watch for CSS changes
+- **Automatically run accessibility checks every 30 seconds** on all `*_accessibility_spec.rb` files
+
+The accessibility checker will continuously monitor your pages and alert you to any issues as you develop!
+
 ## Your First Accessibility Check
 
 Let's see it in action. Create a simple system spec:

data/README.md

@@ -7,7 +7,7 @@
 
 **The RSpec + RuboCop of accessibility for Rails. Catch WCAG violations before they reach production.**
 
-**Current Version:** 1.4.1
+**Current Version:** 1.4.2
 
 📖 **[📚 Full Documentation](https://rayraycodes.github.io/rails-accessibility-testing/)** | [💻 GitHub](https://github.com/rayraycodes/rails-accessibility-testing) | [💎 RubyGems](https://rubygems.org/gems/rails_accessibility_testing)
 
@@ -108,12 +108,24 @@ end
 
 **Accessibility checks run automatically after each `visit` in system specs!**
 
-For continuous testing during development, add to your `Procfile.dev`:
+#### Continuous Testing with Procfile (Recommended for Development)
 
-```ruby
+For continuous accessibility checking during development, add to your `Procfile.dev`:
+
+```procfile
+web: bin/rails server
+css: bin/rails dartsass:watch
 a11y: while true; do bundle exec rspec spec/system/*_accessibility_spec.rb; sleep 30; done
 ```
 
+Then run:
+
+```bash
+bin/dev
+```
+
+This will automatically run accessibility checks every 30 seconds on all `*_accessibility_spec.rb` files, giving you continuous feedback as you develop!
+
 📖 **[See the full System Specs Guide](GUIDES/system_specs_for_accessibility.md)** for detailed examples and best practices.
 
 ### Automatic Checks

data/docs_site/getting_started.md

@@ -43,9 +43,31 @@ This creates:
 - `config/accessibility.yml` - Check settings
 - Updates `spec/rails_helper.rb` (if using RSpec)
 
-### Step 3: Run Your Tests
+### Step 3: Create System Specs (Recommended)
 
-That's it! Just run your system specs:
+Create system specs for the pages you want to test. This is the **recommended and most reliable** approach:
+
+```ruby
+# spec/system/home_page_accessibility_spec.rb
+require 'rails_helper'
+
+RSpec.describe 'Home Page Accessibility', type: :system do
+  it 'loads the page and runs comprehensive accessibility checks' do
+    visit root_path
+    
+    # Run comprehensive accessibility checks
+    # This will fail the test if any accessibility issues are found
+    check_comprehensive_accessibility
+    # ✅ If all checks pass, you'll see: "All comprehensive accessibility checks passed! (11 checks)"
+  end
+end
+```
+
+### Step 4: Run Your Tests
+
+You can run accessibility checks in several ways:
+
+#### Option A: Run Tests Manually
 
 ```bash
 bundle exec rspec spec/system/
@@ -53,5 +75,31 @@ bundle exec rspec spec/system/
 
 Accessibility checks run automatically on every system test that visits a page.
 
-For complete documentation, see the [Getting Started guide](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/getting_started.md) in the main repository.
+#### Option B: Run Continuously with Procfile (Recommended for Development)
+
+For continuous accessibility checking during development, add to your `Procfile.dev`:
+
+```procfile
+web: bin/rails server
+css: bin/rails dartsass:watch
+a11y: while true; do bundle exec rspec spec/system/*_accessibility_spec.rb; sleep 30; done
+```
+
+Then run:
+
+```bash
+bin/dev
+```
+
+This will:
+- Start your Rails server
+- Watch for CSS changes
+- **Automatically run accessibility checks every 30 seconds** on all `*_accessibility_spec.rb` files
+
+The accessibility checker will continuously monitor your pages and alert you to any issues as you develop!
+
+## Learn More
+
+- **[System Specs Guide](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/system_specs_for_accessibility.md)** - ⭐ Recommended approach for reliable accessibility testing
+- **[Complete Getting Started Guide](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/getting_started.md)** - Detailed setup instructions
 

data/docs_site/index.md

@@ -7,7 +7,7 @@ title: Home
 
 **The RSpec + RuboCop of accessibility for Rails. Catch WCAG violations before they reach production.**
 
-**Version:** 1.1.0
+**Version:** 1.4.2
 
 Rails Accessibility Testing is a comprehensive accessibility testing gem that makes accessibility testing as natural as unit testing. It integrates seamlessly into your Rails workflow, catching WCAG 2.1 AA violations as you code—not after deployment.
 
@@ -48,6 +48,12 @@ bundle exec rspec spec/system/
 - [CI Integration]({{ '/ci_integration.html' | relative_url }}) - CI/CD setup
 - [Contributing]({{ '/contributing.html' | relative_url }}) - How to contribute
 
+## Additional Guides
+
+- [System Specs for Accessibility](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/system_specs_for_accessibility.md) - ⭐ Recommended approach
+- [Writing Accessible Views](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/writing_accessible_views_in_rails.md) - Best practices
+- [Working with Designers](https://github.com/rayraycodes/rails-accessibility-testing/blob/main/GUIDES/working_with_designers_and_content_authors.md) - Team collaboration
+
 ## Links
 
 - [GitHub Repository](https://github.com/rayraycodes/rails-accessibility-testing)

data/lib/rails_accessibility_testing/version.rb

@@ -1,4 +1,4 @@
 module RailsAccessibilityTesting
-  VERSION = "1.4.1"
+  VERSION = "1.4.2"
 end
 

data/lib/rails_accessibility_testing.rb

@@ -5,7 +5,7 @@
 # Automatically configures accessibility testing for Rails system specs with
 # comprehensive checks and detailed error messages.
 #
-# @version 1.4.1
+# @version 1.4.2
 # @author Regan Maharjan
 #
 # @example Basic usage
@@ -38,7 +38,7 @@ begin
   require_relative 'rails_accessibility_testing/version'
 rescue LoadError
   module RailsAccessibilityTesting
-    VERSION = '1.4.1'
+    VERSION = '1.4.2'
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_accessibility_testing
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.2
 platform: ruby
 authors:
 - Regan Maharjan