Source maps are available (on current stable release, v0.6.x) even without explicit support from Sprockets in a sort of hackish way.
As such even if they generally work fine there are some limitations and edge case issues.
Note on master
branch
Currently on master sourcemaps are work-in-progress and probably will integrate with the upcoming Sprockets 4 that has integrated support for them.
source_map_enabled
flagTo enable sourcemaps in the Sprockets processor you need to turn on the relative flag:
Opal::Processor.source_map_enabled = true # default
The sourcemaps only work with Sprockets in debug mode because they are generated just for single files.
Rails has debug mode already enabled in development environment with the following line from config/environments/development.rb
:
# Debug mode disables concatenation and preprocessing of assets.
# This option may cause significant delays in view rendering with a large
# number of complex assets.
config.assets.debug = true
opal-rails
also enables sourcemaps in development so with the standard setup you ready to go.
You can add Opal::Server
as in the official example: sinatra/config.ru.
Opal::Server
implements sourcemaps and can be used alone or with Rack::Cascade
in conjunction with other apps.
Opal::Environment
is a bit lower level and doesn't support source maps by itself.