https://github.com/wireapp/wire-emails
Templates for sending emails for Wire
https://github.com/wireapp/wire-emails
Last synced: 4 months ago
JSON representation
Templates for sending emails for Wire
- Host: GitHub
- URL: https://github.com/wireapp/wire-emails
- Owner: wireapp
- License: gpl-3.0
- Created: 2018-02-07T16:34:37.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-01-30T13:46:07.000Z (4 months ago)
- Last Synced: 2026-01-31T06:01:48.592Z (4 months ago)
- Language: HTML
- Homepage: https://wireapp.github.io/wire-emails/dist/
- Size: 66.2 MB
- Stars: 13
- Watchers: 12
- Forks: 9
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# wire-emails
[](https://travis-ci.org/wireapp/wire-emails)
Templates for sending emails, based on [Foundation for Emails](https://foundation.zurb.com/emails.html).
Visit [wireapp.github.io/wire-emails/dist](https://wireapp.github.io/wire-emails/dist/) for the latest ✨ [**Live Preview**](https://wireapp.github.io/wire-emails/dist/) ⭐️
Help translate our emails via the [Crowdin project](https://crowdin.com/project/wire-launch).
## IMPORTANT NOTES
- Only ever update stuff under `/src/`. Other changes may get overwritten.
- Only translate languages supported here: https://github.com/wireapp/wire-emails/blob/master/bin/translate.js#L24-L31
## For Designers
- Find and edit the template in [`src/pages/en`](https://github.com/wireapp/wire-emails/tree/master/src/pages/en).
- To update shared text modules like headers, footers or signatures, edit the corresponding files in the [`src/partials/en`](https://github.com/wireapp/wire-emails/tree/master/src/partials/en) folder.
- Commit your changes to `master`.
- Continue in [Section "Otto builds"](./README.md#otto-builds) below.
## For Copywriters
- Find the things you want to edit in the same places as designers (see [above](./README.md#for-designers)).
- Commit your changes to a branch and create a pull request.
- Otto will now automatically upload your English changes to the [Crowdin project](https://crowdin.com/project/wire-launch).
- Continue in [Section "For Translators"](./README.md#for-translators) below.
## For Translators
- All translations are located in the [Crowdin project](https://crowdin.com/project/wire-launch).
- When the original (English) email copy is changed via the GitHub UI or in a local clone and submitted via a pull request, the modified source text is uploaded to Crowdin for translation. Translators use the [Crowdin UI](https://crowdin.com/project/wire-launch) to update the localized text strings.
- When the translators are done, merge the pull request to `master`.
- The 'Subject' keyword in the translations should not be translated as it is used to split that section into an email subject. The text after the colon should be translated as normal. [Example at line 2](./src/pages/de/user/email/verification-login.html)
- Additionally the 'Layout' keyword as well as the text after it should also not be translated as it refers to a source language file name [Example at line 2](./src/pages/pl/billing/email/suspension.html).
- Continue in [Section "Otto builds"](./README.md#otto-builds) below.
If you changed Crowdin content without any changes on github (eg., to fix a translation error), you can try to re-run the travis job that is otherwise triggered automatically on every change on `master`.
## Otto builds
When you commit to `master`, Otto will tell Travis to generate [the new email templates](https://github.com/wireapp/wire-emails/tree/master/dist) and add an `Otto build` message to the [commits list](https://github.com/wireapp/wire-emails/commits/master). The absense of the `Otto build` will indicate an error as seen in the screenshot below:
## Advanced
We recommend you set up the `wire-emails` repo to run locally on your computer so you can verify your changes before pushing them to the live site.
The instructions below assume you're on a Mac with [Homebrew](http://brew.sh) installed.
### Installation
1. Install the [yarn](https://yarnpkg.com) JavaScript package manager via Homebrew:
```sh
brew install yarn
```
2. Clone this repository and run `yarn` from the root directory of your clone to install the necessary dependencies:
```sh
yarn global add foundation-cli
yarn
```
### Start the local preview
This repository provides a local preview, so you can see what the final messages will look like.
To start the preview, run `yarn start` and check the results at [`localhost:3000`](http://localhost:3000).
A table of contents appears with links to each message. Click a link to display the rendered message content.
### Update
When you update the HTML files in the `src` folder, the results should be reflected automatically in the browser.
If not, make sure the local preview server is running or check the console for errors.
### Build
Run `yarn build` to inline your CSS into your HTML along with the rest of the build process.
### Import changes to [wire-server](https://github.com/wireapp/wire-server)
Find the tag you want to update to from
[here](https://github.com/wireapp/wire-emails/tags), or from the repo
in a shell:
```
cd ~/src/wire-emails
export TAG=$(git tag -l --sort v:refname | tail -1)
```
The update the tag in wire-server, run a script to pull the updates, and commit everything to a branch:
```
cd ~/src/wire-server
git checkout develop && git checkout -b email-templates-$TAG
echo $TAG > ./libs/wire-subsystems/template-version
./libs/wire-subsystems/bin/fetch.p
echo "Updated email templates to $TAG" > changelog.d/5-internal/email-templates-$TAG
git add .
git commit -m "Update email templates to $TAG."
```
Now make a PR like you always do.
There are two issues for automating this process a little further: https://github.com/zinfra/backend-issues/issues/720, https://github.com/zinfra/backend-issues/issues/1130, but both are labelled [P4](https://github.com/zinfra/backend-wiki/wiki/Bug-Tracking#backend-issues-priorities) at the time of writing this.