{"id":13432138,"url":"https://github.com/nottinghamcollege/HTML-Email-Boilerplate-Redux","last_synced_at":"2025-03-16T23:30:42.757Z","repository":{"id":18317330,"uuid":"21496230","full_name":"nottinghamcollege/HTML-Email-Boilerplate-Redux","owner":"nottinghamcollege","description":"A rewrite of the original HTML email boilerplate (originally written by Sean Powell) that keeps up with the latest developments of email clients, providing a solid foundation for our email campaigns, and yours too!","archived":false,"fork":false,"pushed_at":"2017-08-15T18:58:34.000Z","size":528,"stargazers_count":79,"open_issues_count":1,"forks_count":15,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-10-27T11:48:53.519Z","etag":null,"topics":["email-boilerplate","email-campaigns","html"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nottinghamcollege.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-04T12:13:20.000Z","updated_at":"2023-07-25T21:33:47.000Z","dependencies_parsed_at":"2022-08-26T07:40:50.091Z","dependency_job_id":null,"html_url":"https://github.com/nottinghamcollege/HTML-Email-Boilerplate-Redux","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nottinghamcollege%2FHTML-Email-Boilerplate-Redux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nottinghamcollege%2FHTML-Email-Boilerplate-Redux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nottinghamcollege%2FHTML-Email-Boilerplate-Redux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nottinghamcollege%2FHTML-Email-Boilerplate-Redux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nottinghamcollege","download_url":"https://codeload.github.com/nottinghamcollege/HTML-Email-Boilerplate-Redux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243949803,"owners_count":20373651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email-boilerplate","email-campaigns","html"],"created_at":"2024-07-31T02:01:08.868Z","updated_at":"2025-03-16T23:30:42.752Z","avatar_url":"https://github.com/nottinghamcollege.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"\u003ca href=\"https://www.centralnottingham.ac.uk\" target=\"_blank\" title=\"Visit the Central College Nottingham website\"\u003e\n\t\u003cimg src=\"https://i.emlfiles.com/cmpimg/5/8/9/2/2/1/files/794509_centrallogopink690x210.png\" \n\talt=\"Central College Nottingham\" style=\"display:block;\" width=\"260\" /\u003e\n\u003c/a\u003e\n\nHTML Email Boilerplate Redux\n==============================================\n\n[![CircleCI Shield](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux.svg?style=shield\u0026circle-token=4c887bae1ee5e6a4601c55abeb5b8fc230a524a7)](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux)\n\nA HTML Email Boilerplate is designed to create a solid foundation for any email campaign by fixing various email client quirks from the beginning (saving headaches later!), as well as providing a good starting point for building your own email campaigns/templates.\n\nThere are various email boilerplate templates around, however [Central College Nottingham](https://www.centralnottingham.ac.uk) has adapted its own email boilerplate template based on a variety of sources as well our own additions based on our own research and development. We regularly review changes in email client behaviour and aim to keep our boilerplate constantly up to date with the latest developments and changes in the email world.\n\nWe refer to our email boilerplate as a redux of the [original HTML Email Boilerplate](https://github.com/seanpowell/Email-Boilerplate).\n\n## Main Features\n\nAs well as creating a solid foundation for any email campaign, our boilerplate also focuses on the following areas:\n\n* Modular and customisable email boilerplate that suits your needs with configuration options\n* Full documented with a guidelines version that explains every aspect of each line of code\n* Forcing the document mode for Internet Explorer based clients\n* Improved Windows Phone 7/8/8.1 compatibility\n* CSS3 support in the Outlook Mobile client on Windows Phone 8+ and above (POP3/IMAP)\n* Scaling images correctly in Outlook 2010 and 2013 when using DPI scaling factors greater than 96 DPI (100%)\n* Improved Office 365 (OWA) compatibility (Microsoft have since improved the rendering standards of OWA [in the October 2014 update](http://blogs.office.com/2014/10/14/improving-outlook-web-app-options-settings-2/))\n* Android 4.4 centring fix\n* More robust method of stopping iOS data links on text like phone numbers and addresses\n* Apple Mail iOS 10 auto scaling fix\n\nAs well as fixing other email client quirks that have been discovered.\n\n## Installation instructions\n\nThis project now uses `npm` and `gulp` based packages to produce a customised and production ready version of the email boilerplate. Originally the project began as static HTML files, however overtime this become a problem where dynamic elements were needed. e.g. toggling code blocks on/off, variable values etc.\n\n1. Install `npm` \u003ca href=\"https://nodejs.org/en/\" target=\"_blank\"\u003ehttps://nodejs.org/en/\u003c/a\u003e (Make sure its in your `$PATH`)\n2. Install gulp globally with `npm install --global gulp-cli`\n3. Clone the git source of this project and run `npm i` to install the required dependencies\n4. Copy `.boilerplate.defaults -\u003e .boilerplate.custom`. There are a range of booleans, integer and string values to tweak to your requirements\n5. Run `gulp` to build the email boilerplate\n6. The \"compiled\" email boilerplate versions will be written to:\n\n* `dist/boilerplate/email-boilerplate.html` (Production ready)\n* `dist/boilerplate/email-boilerplate-guidelines.html` (Documentation purposes)\n\nA `tmp` directory will be created when running `gulp` these are just helper files needed during the build, they can be ignored.\n\n**Note:** Don't place any files within the `tmp` or `dist` directory, they are cleaned each time `gulp` is run.\n\nFor further information on the available configuration options available, see USAGE.md.\n\n## Project branches\n\nThe email boilerplate itself is split into two versions, experimental and stable. Previously this was managed by creating seperate HTML documents, however since [\n1bc2b35](https://github.com/centralcollegenottingham/HTML-Email-Boilerplate-Redux/commit/1bc2b35d4e4730eb4aea203f2d8fded1a93ec0d9) this is now done via branches in the Git repo.\n\n### Develop (Experimental) [![CircleCI](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux/tree/develop.svg?style=svg)](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux/tree/develop)\n\nThis is the latest/bleeding edge version of the email boilerplate, experimental code that needs testing will appear here first, it provides a branch for testers/curious users to check out the very latest developments of the email boilerplate, but be warned, email client compatibility is not guaranteed on develop because its more of a pre-release branch.\n\n**It is strongly recommended that you NEVER use the develop version of the email boilerplate in a live email campaign. The develop version may not have been tested thoroughly and hence its cross email client compatibility is not guaranteed. Always use the master branch!**\n\n### Master (Stable) [![CircleCI](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux/tree/master.svg?style=svg)](https://circleci.com/gh/centralcollegenottingham/HTML-Email-Boilerplate-Redux/tree/master)\n\nThis is the stable version of the boilerplate which should be used in email campaigns. It is also the default branch. \n\n## Boilerplate versions\n\nTwo versions of the email boilerplate exist, one version is heavily documented with HTML/CSS comments that details every aspect of the code, the other is a clean version which has all of the HTML/CSS comments removed.\n\n**Never use the \"guidelines\" version in a live email campaign, as HTML/CSS comments play havoc with spam filters and even cause emails to appear blank in a few clients! You will also be adding unnecessary bloat to your HTML as well!**\n\n## License\n\nThe MIT License (MIT)\n\n\u0026copy; 2014 - 2016 Central College Nottingham\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n## Credits\n\nThis boilerplate is originally based on two very popular boilerplates by:\n\n* Sean Powell - https://github.com/seanpowell/Email-Boilerplate\n* Email on Acid - http://www.emailonacid.com/blog/details/C13/html_boilerplate\n\nFurther additions and adaptations have been made Central College Nottingham either from our own research or cited from sources. Where sources have been cited in the guidelines version of the boilerplate, credit is given to the original author of the referenced information.\n\nA full list of credited individuals/organisations can be found in the CONTRIBUTORS.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnottinghamcollege%2FHTML-Email-Boilerplate-Redux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnottinghamcollege%2FHTML-Email-Boilerplate-Redux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnottinghamcollege%2FHTML-Email-Boilerplate-Redux/lists"}