Uses the MJML framework to build e-mail templates without dealing with a lot of the complexity that often arises out of doing so.
- Make sure you have
yarn 1.xavailable globally (e.g. through corepack)
Use VSCode and make sure you install the recommended MJML extension. Through this extension you can will get syntax highlighting in .mjml files and also the option to trigger a live preview right from the specific .mjml file.
Before development do yarn serve:assets to start a local file server. You'll need that to be able to see assets in the preview pane, cause it expects assets to be hosted somewhere and accessed through HTTP, not loaded from a relative path on your PC.
The file server is accessible at localhost:4040, assets are served from /assets and built templates from /templates.
Run yarn build to build everything. Run yarn watch to build in watch mode.
You can configure the MJML VSCode extension to actually send out an email of your template. To do so, make sure to configure the mjml.mailjetAPIKey, mjml.mailjetAPISecret and mjml.mailSender settings or mjml.nodemailer settings in your user settings.
Do not save these values into the workspace settings we don't want tokens being commited to Git!
Read more: https://marketplace.visualstudio.com/items?itemName=mjmlio.vscode-mjml
You can use a trial for one of these kinds of services: https://www.emailonacid.com/. The goal here is to evaluate that the template looks right in different kinds of e-mail clients and their versions.
Please make sure you read the contribution guidelines for an overview of the best practices we try to follow.
The Speckle Community hangs out on the forum, do join and introduce yourself & feel free to ask us questions!
For any security vulnerabilities or concerns, please contact us directly at security[at]speckle.systems.
Unless otherwise described, the code in this repository is licensed under the Apache-2.0 License. Please note that some modules, extensions or code herein might be otherwise licensed. This is indicated either in the root of the containing folder under a different license file, or in the respective file's header. If you have any questions, don't hesitate to get in touch with us via email.