Rails::Fort

Modern progress bar for form completion

• Ruby >= 3.0
• Rails >= 6.0
• No jQuery required

Add this line to your application's Gemfile:

gem 'rails-fort', '~> 1.0'

And then execute:

bundle install

For Rails 6.x / 7.x with Sprockets:

In app/assets/javascripts/application.js:

//= require rails_fort

In app/assets/stylesheets/application.css:

*= require fort

For Rails 7+ with Import Maps:

Add to config/importmap.rb:

pin "rails_fort", to: "rails_fort.js"
pin "fort", to: "fort.js"

Import in application.js:

import "rails_fort"

Include fort.css through your stylesheet pipeline or asset host.

Rails-Fort tracks input, textarea, and select fields inside forms and shows a fixed progress bar as the user completes the form.

Add ignore or fort-ignore to skip a field:

<input type="text" class="ignore">

height: '20px'
duration: '3s'
alignment: 'bottom'
type: 'solid'
value: '#009DFF'

Solid

type: 'solid'
value: '#009DFF'

Gradient (two colors)

type: 'gradient'
value: ['#009DFF', '#47B9FF']

Sections

type: 'sections'
value: ['#009DFF', '#4AF2A1', '#FB5229']

Flash

type: 'flash'
value: ['#009DFF', '#000', '#6638F0']

Merge

type: 'merge'
value: '#009DFF'

Upgrading from the legacy 0.x gem? See UPGRADE_GUIDE.md for 1.0.0.

The progress bar is implemented in vanilla JavaScript (app/assets/javascripts/fort.js) and vendored inside this gem. The original Fort.js repository by Idris Khenchil is no longer available; this gem maintains a compatible fort.yml API with a new implementation.

Bug reports and pull requests are welcome on GitHub at https://github.com/ethirajsrinivasan/rails-fort. Contributors are expected to adhere to the Contributor Covenant code of conduct.

Thanks to Idris Khenchil for the original Fort.js form progress bar concept.

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