hmontazeri/rails-assessment

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. Highlights 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. ⚠️ Disclaimer — This project is mostly vibe coded and in active development. Expect breaking changes and rapid iteration.