Ordit

A Ruby gem to analyze Stimulus.js controller usage in your Rails application. Find unused controllers, undefined controllers, and audit your Stimulus controller usage.

Installation

Add this line to your application's Gemfile:

gem 'ordit'

And then execute:

bundle install

Usage

Audit Stimulus Controllers

Run an audit to see all defined and used controllers in your application:

rails ordit:stimulus

This will show:

• Controllers that are defined but never used
• Controllers that are used but don't have corresponding files
• Summary statistics

Example output:

📊 Stimulus Controller Audit

❌ Controllers not defined in any views:
   unused-feature
   users--edit-password

⚠️  Used but undefined controllers:
   missing-controller
   └─  📁 app/views/products/show.html.erb
       📁 app/views/users/edit.html.erb

Configuration

You can customize the paths that are scanned in an initializer (config/initializers/ordit.rb):

Ordit.configure do |config|
  config.view_paths = [
    Rails.root.join('app/views/**/*.{html,erb,haml}'),
    Rails.root.join('app/javascript/**/*.{js,jsx}'),
    Rails.root.join('app/components/**/*.{html,erb,haml,rb}')
  ]

  config.controller_paths = [
    Rails.root.join('app/javascript/controllers/**/*.{js,ts}')
  ]
end

Features

• Finds unused Stimulus controllers
• Detects controllers used in views but missing controller files
• Supports namespaced controllers (e.g., users--name)
• Handles multiple syntax styles: ```ruby # HTML attribute syntax

# Ruby hash syntax <%= f.submit 'Save', data: { controller: 'products' } %>

# Hash rocket syntax <%= f.submit 'Save', data: { :controller => 'products' } %>

# Hash rocket string syntax <%= f.submit 'Save', 'data' => { 'controller' => 'products' } %>

- Scans ERB, HTML, and HAML files
- Works with both JavaScript and TypeScript controller files
- Supports component-based architectures

## Development

After checking out the repo:

1. Run `bundle install` to install dependencies
2. Run `rake test` to run the tests
3. Create a branch for your changes (`git checkout -b my-new-feature`)
4. Make your changes and add tests
5. Ensure tests pass

## Contributing

Bug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration.

## License

The gem is available as open source under the terms of the MIT License.