Morphing is a Rails engine that allows you to morph into your users temporarily. This can be especially helpful when debugging issues reported by a user without needing to log into their account to reproduce.

NOTE: This library assumes you're using devise.

Add the following to your Gemfile:

gem 'morphing'

and be sure to bundle install and add to your routes:

YourApplication::Application.routes.draw do
  ...
  morphing_for
  ...
end

To use the morphed? helper, Add the following to your app/helpers/application_helper.rb:

module ApplicationHelper
  include Morphing::ApplicationHelper
end

Then place a link somewhere only admins can see:

= link_to "Morph", morph_path(@user)

If you're morphed, you can provide a link to unmorph:

- if morphed?
  = link_to "Unmorph", unmorph_path

We recommend making this a big red banner that makes it clear you're morphed! (Future releases will have this included.)

If you want to customize the behavior of the controller, for example to add or skip before filters, or to perform authorization, just subclass the MorphingController somewhere in your application:

class MorphingController < Morphing::MorphingController
  authenticate_user! only: [:morph]
end

Then, pass that controller as an argument to the routes helper:

YourApplication::Application.routes.draw do
  ...
  morphing_for controller: 'morphing'
  ...
end

This project is sponsored by the engineering team at Bloc.

This project is licensed under the MIT License.

Here are ways you can help:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features