Awesome Open Source
Awesome Open Source

Rails Workflow Engine

Build Status Code Climate Join the chat at


Rails Workflow allows you to organize your application business logic by joining user- and auto- operations in processes. You can configure, create and manage processes to easily build project management systems, sales / product provisioning systems, ERP, CMS, etc.

Rails Workflow is mountable Rails engine and can be mounted to any Rails application.

All processes, configurations, operations and their data is persisted for processing and supporting purposes. Engine has UI to configure process templates and manage existing processes.

Rails Workflow Engine

Main features:

  • It is mountable rails engine.
  • Allows to configure process and operation templates.
  • Allows to configure syncronous and asyncronous operations.
  • Allows to run operations in background
  • Provides operations exceptions/errors monitoring and management.
  • Allows to build hierarchical synchronous and asynchronous processes.
  • Allows to split process implementation to operations isolating logic.
  • Allows to reuse operations in different processes.
  • Every operation runs in it's own transaction and has separate context.
  • Process may be canceled, manually changed, rolled back, reset to any specific operation.
  • Allow to track operations flow and their context, errors, user activities etc.

User Interface

  • It has UI for processes configuration and management.
  • UI is bootstrapped and can be easily changed to fit main rails application design.


You can find tutorials and documentation here

Help and support

Please contact me if you have any questions or need any customization


Add to your application's Gemfile:

gem 'rails_workflow'

And then execute:

$ bundle install

and mount it to /workflow routes:

Rails.application.routes.draw do
  mount RailsWorkflow::Engine => '/workflow', as: 'workflow'

Generate all models:

$ rails generate rails_workflow:install
$ bundle exec rake db:migrate

I am developing this engine using PostgreSQL database. In case if you using MySQL, add following to your config/initializers/workflow.rb file:

RailsWorkflow.setup do |config|
  config.sql_dialect= 'mysql'

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,328
workflow (324
workflow-engine (66
bpm (21

Find Open Source By Browsing 7,000 Topics Across 59 Categories