What is email-boilerplate?

This repository is a collection of HTML code snippets and templates for building email messages that display correctly across different email clients. Anyone who has tried to design a formatted HTML email knows that the same code can look completely different in Gmail versus Outlook versus Apple Mail, and this project exists to address that problem. The template is split into two sections. The header area holds global styles, some of which need to stay in the header and some of which should be moved inline before sending. The body section contains more targeted fixes for specific rendering issues you might encounter. The intended use is not to copy the entire file wholesale. Instead, you treat it as a reference: read the comments in the code, pick the pieces that fix your particular issue, and build your own template from there. The instructions inside the file are not meant to be included in the email you send, since that could trigger spam filters. This is a resource for developers, designers, or anyone building HTML email campaigns who wants a starting point grounded in real-world compatibility quirks rather than guesswork. It covers common pitfalls but is not a substitute for testing your actual email in the clients your audience uses.