I am thinking of building the render in Node and then running in a ruby / php runtime to compile. Looking for feedback here, let me know.
Setup with Rails could not be easier.
1: Add Bootstrap Email to your Gemfile
gem 'bootstrap-email'
2: You need to create the mailer template which will wrap the email content. Create the file /app/views/layouts/bootstrap-mailer.html.erb and paste this HTML into it. (It is very similar to the default mailer).
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<%= stylesheet_link_tag "application-mailer", media: "all" %>
</head>
<body class="bg-light">
<%= yield %>
</body>
</html>
3: Specify the layout for the actions you want to build with bootstrap email. You can specify it for all with ApplicationMailer.
class ApplicationMailer < ActionMailer::Base
layout 'bootstrap-mailer'
end
Refer to the official ActionMailer documentation on more info about using a different layout for different mailers.
4: Create a new stylesheet /app/assets/stylesheets/application-mailer.scss and import bootstrap-email. This is where your custom styles and overrides that you want to be inlined should live.
@import 'bootstrap-email';
5: Add this line in /config/initializers/asset.rb to compile your new SASS file.
Rails.application.config.assets.precompile += %w( application-mailer.scss )
6: Create the view file /app/views/example_mailer/greet.html.erb.
You can also create the view /app/views/example_mailer/greet.text.erb. In this case don’t forget to create also the textual layout /app/views/layouts/example_mailer.text.erb.
If you do not create a textual view file, a text part is automatically added by the premailer-rails gem.
Thats it! Now all you need to do to use it instead of using the mail() method, you use the make_bootstrap_mail() method to kick off Bootstrap Email compilation!
class ExampleMailer < ApplicationMailer
def greet
make_bootstrap_mail(
to: '[email protected]',
from: '[email protected]',
subject: 'Hi From Bootstrap Email',
)
end
end
You can also use the format in the usual way.
class ExampleMailer < ApplicationMailer
def greet
make_bootstrap_mail(
to: '[email protected]',
from: '[email protected]',
subject: 'Hi From Bootstrap Email',
) do |format|
format.html { layout 'custom_bootstrap_layout' }
format.text # here example_mailer.text.erb is used
end
end
end
The old method bootstrap_mail is still available for compatibility.