responsive-html-email-template

This repository contains a simple, free HTML email template designed to look good across different email clients and screen sizes. Building HTML emails is more difficult than building web pages because email applications like Gmail, Outlook, and Apple Mail each interpret HTML and CSS differently, and many modern CSS features simply do not work in email. This template handles the tricky parts so you start with something that already works.

The template is a clean layout with a call-to-action button, the kind of structure commonly used for transactional emails such as password resets, welcome messages, or order confirmations. The README describes two ways to use it. If you are sending email through a developer service like Mailgun, SendGrid, or Postmark, you need to convert the CSS from the separate stylesheet into inline styles on each HTML element, because many email clients ignore stylesheets. The repository includes a pre-inlined version of the file for this case. If you are using a marketing platform like Mailchimp, you can use the template as-is because those platforms handle the inlining step for you.

The README also covers a common image pitfall: HTML images in email need explicit width, height, and border attributes set, or they will break in some clients. Example markup showing the correct format is provided.

The template has been tested across mobile, desktop, and web-based email clients. It is free to use, and the author also sells a broader set of premium email templates through a separate product called HTML Email.