Rails Assessment

A mountable Rails 8 engine that lets you ship dynamic, themeable assessments without building CRUD back offices.

rails-assessment is a mountable Rails 8 engine that lets you ship dynamic, themeable assessments without building CRUD back offices. Define questionnaires in YAML or a Ruby DSL, persist JSONB responses, and deliver a Hotwire-powered multi-step flow that can be embedded in any Rails application.

What you get

• Declarative definitions — load assessments from YAML files or a compact Ruby DSL.
• Conditional logic — evaluate answer tags against ordered rules to produce tailored results.
• Persistence built-in — stores submissions in a single rails_assessment_responses table (JSONB answers + result text).
• Hotwire UI — Turbo Frames + a Stimulus controller provide a progressive multi-step experience with graceful no-JS fallback.
• Theme system — inject CSS tokens per assessment, resolve themes via initializer, params, or request proc.
• Dark mode support — optional dark mode toggle with customizable theme variables.
• Start screen — optional intro screen with description, estimated time, and branding.

Mounting it

# Gemfile
gem "rails-assessment"

# config/routes.rb
mount Rails::Assessment::Engine, at: "/rails-assessment"

Details

48 stars on GitHub · MIT licensed · maintained by hmontazeri. Source: https://github.com/hmontazeri/rails-assessment