Volt is a client and server framework. Gems exist for both client and server and many gems are not compatible with either client or server environment. This and other reasons (see below) means that volt does not automatically require all gems at startup.
Use Gemfile and bundler as always. But as mentioned above, you just have to remember to require gems explicitly.
For gems that run on both client and server,
config/app.rb is a good place for such a require statement.
A growing list of gems exist for use in the browser. Opal gems are usually prefixed with opal-. Opal-browser or opal-jquery are good examples, just like opal-pixi or opal-phantom, all of which use the browser or DOM API.
To use a gem in your code, say opal-browser, you must require it in a conditional block. The syntax to do so is below.
if RUBY_PLATFORM == 'opal' require "browser" end
alternatively you can use an initializer for the client, eg
in which case you can omit the platform test.
For client-only gems, you also need to instruct opal where to find the sources for the gem. This can be done in
On the other hand some gems may not work on the browser, eg opal will never support c extensions. Also gems used in Tasks should be loaded only on the server. It is good practice to avoid loading gems into the browser, as anything loaded into the client takes network bandwidth.
Similarly, you can require conditionally, eg:
if RUBY_PLATFORM != 'opal' require "nokogiri" end
or alternatively you can use an initializer for the server, eg
Gems in the Gemfile are not automatically required in Volt. This was a decision made for a few reasons.
Check out 5 reasons to avoid Bundler.require for more reasons.
If you really like having Gems auto-required, you can put the following at the start of your