Created: 2011-07-18 00:25
Updated: 2013-01-03 21:55

HTML5 Boilerplate


v.1.0 : March 21st, 2011

Build Script

  • Files linked via @import will be inlined into the files they are imported to using Corey Hart's CSS Compressor.
  • Environments are definable.
  • htaccess Expires headers are upgraded to 1year, as the filenames are revved
  • Massive rewrite so you can define which HTML, CSS, JS files to operate on in your configurable files. This allows you to let the build script operate on very unique folder architecture, including non-H5BP projects.
  • Added a source directory option in the build config, so your source files can be in a different directory from the final generated files (useful for other CMSes/frameworks like Django).



  • Added .focusable helper class that extends .visuallyhidden to allow the element to be focusable when navigated to via the keyboard.
  • Anchor links are no longer reset. Basically our reset is the effectively merged with Eric Meyer's recent CSS reset update and also the HTML5 Doctor reset.
  • An unordered list within a nav element will no longer have a margin.
  • All helper classes are now after primary styles to ensure correct overrides and not be burdened with resets.
  • .visuallyhidden is no longer camelCase, as to be consistent with other classname formats.
  • Updated the specificity of .visuallyhidden rule to make sure it overrides all other declarations.
  • Removed reset on image elements within table cells as they look ugly alongside multiline texts. Browsers default to baseline alignment for images which works better than top alignment.
  • Increased margin-left on ol, to allow for 2-digit list numbers.
  • Added a print reset on IE's proprietary filters.
  • Print styles no longer prints hash links or javascript links.
  • Updated sub/sup css to make them not be impacted by line-height, so now you can do sub/superscripts without worrying.


  • Added a humans.txt so you can clarify authorship and tools used
  • Removed YUI profiling. You probably weren't using it anyway.
  • Removed QUnit's unit tests. There is no need to ship with them, really.

Webserver Configs


  • .htaccess is far more documented now. Take a read through it!
  • Changed mimetype of .ico files to "image/x-icon".
  • HTML Manifest files now use .appcache extension instead of .manifest, as per
  • Force deflate for accept-encoding headers mangled by turtle tappers, courtesy of Yahoo!'s research
  • We nerfed some of the directives in case you're on server without mod_headers. (Which is totally crazy, man)
  • Block access to .git and .svn folders.
  • Eradicating Chrome's console warning on WOFF font downloads.
  • More optimizations available if you set the .htaccess details up in your httpd.conf
  • .htaccess now caches .htc files
<li>Moved all server configurations (except apache's .htaccess) over to <a href ="">the new html5-boilerplate-server-configs repo</a>. Head over there if you are not using Apache. </li>

<li>Updated <code>.htaccess</code> and <code>mime.types</code> for ogg formats.</li>
<li>Fixed regression where EOT fonts had been excluded from DEFLATE compression</li>
<li>Apache version independence: Use <code>mod_filter</code> for compression, with fallback to AddOutputFilterByType directive for legacy versions</li>
<li>Added plugin/extension mime types for Safari, Chrome, Firefox</li>
#### nginx
  • Cleaned up cache expires directives.
  • Now includes SVG and font formats for gzipping.
  • expires header bug fixed.
#### IIS
  • Added Flash video mime types to IIS server
  • Fixed some mimetype weirdness that was preventing proper caching

Basically a lot of great updates were made for 1.0. Here are all 220 commits since last release.. You may ask though, do I need to upgrade existing sites? Short answer: nah, you're good.


Mickael Daniel, Dave Kirk, Jonathan Verrecchia, nlogax, Rob Larsen, David Murdoch, AD7six, Mathias Bynens, Michael van Laar, Mike West, Mikko Tikkanen, Velir, Stephen Gariepy


Adam J. McIntyre, Adeel Ejaz, akolesnikov, Alex Dunae, Andrew Le, ashnur, Ben Truyman, Bruno Aguirre, Chris Hager, Corey Ward, Craig Barnes, crappish, Daniel Schildt, Dave DeSandro, Dustin Whittle, grigio, Irakli Nadareishvili, Jaime Bueza, Jake Ingman, James A. Rosen, Jeremy Balch, joe bartlett, Joe Sak, John Bacon Jonathan Fielding, Jonathan Neal, kblomqvist, Kenneth Nordahl, Maarten Verbaarschot, Manuel Strehl, Marcel Turi, Martin Hintzmann, mikealmond mikkotikkanen, Nic Pottier, Paul Neave, Peter Beverloo, Rick Waldron, Rob Flaherty, S Anand, Sam Sherlock, Michael Cetrulo, simshaun, Sirupsen, Stephen Gariepy, timemachine3030 , Vinay, Weston Ruter, WraithKenny, Yann Mainier, Michael van Laar, Massimo Lombardo, Ivan Nikolić , Kaelig, Richard Bradshaw, SammyK, alrra, Rizky Syazuli, iszak, aaron peters, Swaroop C H, Mike Połtyn, Marco d'Itri, Mike Lamb , BIG Folio, Philip von Bargen, Meander, Daniel Harttman, rse, timwillison, ken nordahl, Erik Dahlström, christopherjacob, Chew Choon Keat, benalman, stoyan, Markus, Vladimir Carrer, aristidesfl, Trevor Norris

#####Configs Dusan Hlavaty, Sean Caetano Martin, yaph, michaud, Paul Sarena, Graham Weldon, Ron. Adams

#####Translators alrra, Anton Kovalyov, Milos Gavrilovic, jorge-vitrubio, Julian Wachholz, laviperchik, lenzcom, Mathias Bynens, Mickael Daniel, Mike West, Niels Bom, Ricardo Tomasi, skill83 , Sean Caetano Martin, Yuya Saito, Zee-Julien

v.0.9.5 : October 25th, 2010

Major changes:

  • Removed -webkit-font-smoothing: antialiased; it makes monospace too thin.
  • IE conditional classes have moved from the <body> tag to the <html> tag ( #44 ).
  • Dropped text-rendering: optimizeLegibility as it breaks small-caps, looks odd on Linux machines, and goes invisible on WebOS.
  • Added a IE6 call for the minified dd_belatedpng.
  • Revised viewport declaration to allow user scaling and clear Webkit console errors ( #37 ).
  • Updated Modernizr to 1.6
  • Added web.config file for Microsoft IIS
  • Beta release of the Build Script (this is HUGE)
  • New project scaffolding bash script.


  • Updated Modernizr to 1.6 (smaller and faster)
  • Added web.config file for Microsoft IIS. Now forcing latest IE version and ChromeFrame, if installed.
  • Added favicon and default icon for iOS.
  • Updated crossdomain.xml wording for better security guidelines ( #124 ).
  • Expires value for nginx.conf corrected.
  • License clarified.


  • Removed -webkit-font-smoothing: antialiased; as it made monospace too thin.
  • Updated fonts normalization to YUI 3.2.0 PR1.
  • Table Header set explicitly for IE6 and table row now has page-break: avoid in print CSS.
  • text-shadow:none !important set for all text in print css.
  • Removed scrollbar from textareas in IE.
  • Fixed textarea stylings and form field treatment for validity. Added default background-color.
  • New robust clearfix solution without IE 5.5 hack ( #45 #126 ).
  • Margins for form-elements explicitly set to 0 as webkit adds 2px space around form elements' chrome.
  • Dropped text-rendering: optimizeLegibility as it breaks small-caps and looks odd on Linux machines.
  • Lists now have a left margin of 1.8em. Default list-style-type for ordered list is decimal.
  • Image Replacement now works with right-to-left text ( #68 ).
  • Removed "Star Hack" for checkboxes in favor of .ie7 selector.


  • IE conditional classes have moved from the tag to the tag ( #44 ).
  • Added a IE6 call for the minified dd_belatedpng.
  • Google Analytics script will now work with SSL in IE6.
  • Added protocol independent absolute path for cdn jquery, with improved fallback-to-local code to protect against edge case IE bug.
  • Commented out handheld CSS ( #73 ).
  • Mobile viewport and textsize styles adjusted per group feedback ( #37 ).


  • More files are served via gzip like .htc ( #55 ).
  • Added Expires header for content types image/gif and video/webm.
  • Fixed favicon display in IE6 ( #113 ).
  • Corrected mimetypes for fonts.
  • Removed caching for files of type json/xml.
  • Better use of ifmodule for more stability in different Apache environments.

View full diff and commit history


Shi Chuan, Rob Larsen, Ivan Nikolić, Mikko Tikkanen, Velir, Paul Neave, Weston Ruter, Jeffrey Barke, Robert Meissner, SirFunk, Philip von Bargen, Kroc Camen, Rick Waldron, Andreas Madsen, Marco d'Itri, Adeelejaz, James Rosen, Dave DeSandro, Ken Newman, Daniel Lenz, Swaroop C H, Yann Mainier, Joe Sak, Irakli, Rob Flaherty, Jeff Starr, Mike Lamb, Holek, Aaron Peters, Kaelig, Meander, Charlie Ussery, Ciney, Région Wallonne, Sirupsen, and Paul Hayes.

v.0.9.1 : August 13th, 2010

  • HTML5 Boilerplate is now in the Public Domain
  • Nginx configuration added
  • Font stacks (sans-serif and monospace) simplified
  • Very accessible a:focus styles.
  • Corrected IE=edge,chromeframe enabling (As a result, the base HTML does not validate)
  • ServerSideIncludes disabled by default.
  • Apache config bugfixes
  • Conditional body tag class combined
  • dd_belatedPNG updated to 0.0.8. Redundant BackgroundImageCache fix removed.

View full diff and commit history


voodootikigod, garowetz, fearphage, christopherjacob, mathias bynens, daniel harttman, rse, chris dary, erik dahlstrom, timwillison, kenneth nordahl, riddle, elcuervo, andreas kuckartz, 3rdEden, riley willis, majic3

v0.9 : August 10th, 2010 - Initial release


Major components:

  • Modernizr: MIT/BSD license
  • jQuery: MIT/GPL license
  • DD_belatedPNG: MIT license
  • YUI Profiling: BSD license
  • HTML5Doctor CSS reset: Public Domain
  • CSS Reset Reloaded: Public Domain

Everything else:


This is a set of files that a front-end developer can use to get started on a website, with following included:

  1. Cross-browser compatible (IE6, yeah we got that.)
  2. HTML5 ready. Use the new tags with certainty.
  3. Optimal caching and compression rules for grade-A performance
  4. Best practice site configuration defaults
  5. Think there's too much? The HTML5 Boilerplate is delete-key friendly. :)
  6. Mobile browser optimizations
  7. Progressive enhancement graceful degredation ........ yeah yeah we got that
  8. IE specific classes for maximum cross-browser control
  9. Want to write unit tests but lazy? A full, hooked up test suite is waiting for you.
  10. Javascript profiling.. in IE6 and IE7? Sure, no problem.
  11. Console.log nerfing so you won't break anyone by mistake.
  12. Never go wrong with your doctype or markup!
  13. An optimal print stylesheet, performance optimized
  14. iOS, Android, Opera Mobile-adaptable markup and CSS skeleton.
  15. IE6 pngfix baked in.
  16. jQuery, waiting for you


There are two releases: a documented release, which is exactly what you see here, and a "stripped" release, with most of the descriptive comments stripped out.

Watch the current tickets to view the areas of active development.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more