springload/email-starter-kit

Name: email-starter-kit

Owner: Springload

Description: Email starter kit

Created: 2017-09-12 05:22:12.0

Updated: 2017-10-10 00:47:56.0

Pushed: 2017-09-29 23:12:01.0

Homepage: https://springload.github.io/email-starter-kit/

Size: 2300

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Email starter kit

Coding for HTML emails is like coding for Internet browsers from 10 years ago. Picture a website from a decade ago: that?s the level of design complexity we can reasonably shoot for. Tables Are Your Best Friend

|Important links| |—————| |template building documentation| |CSS support in email clients|

Installation

Clone the project on your computer, and install Node. This project also uses nvm.

From the command-line:

/Development/sites/
clone git@github.com:springload/email_starter_kit.git
mail_starter_kit
stall the required Node and npm versions.
install
en, install all project dependencies.
install
install wrangler
Working on the project
art the server.
run start
Publishing the templates
epare the templates for deployment
run deploy
Documentation
For designers

if you want your email to render well in every email client, stick to using a width of 600px. Plus this is what our default starter kit uses.

For developers

Please if you come across any of your own please document them here

< Bugs you need to be aware of

Divs have positioning and box model issues in different clients, in particular those that use Microsoft Word (Outlook) to render. You can use divs if you want but safer to code like it?s the 90's and stick to tables.

#ffffff instead of #fff

In general it?s easier to stick with standard system fonts. That includes Helvetica, Arial etc.

However, we can use web fonts like Google fonts. You should put them behind a WebKit conditional media query otherwise Outlook will mess up your type e.g.

If you want to use margins you need to have a capital M for example Margin: 30px; as this is the only way it works in Outlook Inline CSS instead of stylesheets

Cache strings break when importing a template into campaign monitor

Images always need the width defined

USING RETINA IMAGES IN OUTLOOK

Some versions of Microsoft Outlook still display the retina images at their full size, despite the explicit sizes set by the width and height attributes. To get around this, you can include a max-width rule in the style attribute of the image.

DO NOT USE * it can cause all sorts of mess

Email client support

Email client support is informed by analytics on existing campaigns of comparable audiences.

| Email client | Version | Testing in Campaign Monitor | |———|———–|———| | Gmail | Gmail | Yes | | iOS Devices | iPhone | Yes | | iOS Devices | iPad | Yes | | Apple Mail | Apple Mail 10 | No ? Use Apple Mail 9 instead | | Apple Mail | Apple Mail 9 | Yes | | Outlook.com | Outlook.com | Yes | | Microsoft Outlook | Outlook 2016 | Yes | | Microsoft Outlook | Outlook 2013 | Yes | | Microsoft Outlook | Outlook 2010 | Yes | | Spark.co.nz | Spark.co.nz | No ? Uses the user's browser's rendering? | | Windows Live Desktop | Windows Live Desktop | No ? Discontinued. Probably using the same underlying engine as Outlook | | Android | Android 7 | No ? Use Android 4 instead | | Yahoo! Mail | Yahoo! Mail | Yes | | Thunderbird | Thunderbird | Yes |


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.