Ruby on Rails Engine vs Mountable App
Full Engine
With a full engine, the parent application inherits the routes from the engine. It is not necessary to specify anything in parent_app/config/routes.rb. Specifying the gem in Gemfile is enough for the parent app to inherit the models, routes etc. The engine routes are specified as:
# new_engine/config/routes.rb
Rails.application.routes.draw do
# whatever
end
No namespacing of models, controllers, etc. These are immediately accessible to the parent application.
Mountable Engine
The engine’s namespace is isolated by default.
# new_engine/lib/new_engine/engine.rb
module NewEngine
class Engine < Rails::Engine
isolate_namespace NewEngine
end
end
With a mountable engine, the routes are namespaced and the parent app can bundle this functionality under a single route:
# new_engine/config/routes.rb
NewEngine::Engine.routes.draw do
#whatever
end
# parent_app/config/routes.rb
ParentApp::Application.routes.draw do
mount NewEngine::Engine => "/new_engine", :as => "namespaced"
end
Models, controllers, etc are isolated from the parent application – although helpers can be shared easily.
These are the main differences I have spotted. My impression is that since a full engine does not isolate itself from the parent application, it is best used as a standalone application adjacent to the parent app.
A mountable engine could be used in situations where you want to avoid name conflicts and bundle the engine under one specific route in the parent application. For example, I am working on building my first engine designed for customer service. The parent application could bundle it’s functionality under a single route such as:
mount Help::Engine => "/help", :as => "help"