Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


Standards for flexible, durable, and sustainable HTML and CSS.

Subscribe to updates I use code-guide

Statistics on code-guide

Number of watchers on Github 6837
Number of open issues 39
Average time to close an issue 4 days
Main language HTML
Average time to merge a PR 5 days
Open pull requests 15+
Closed pull requests 24+
Last commit about 3 years ago
Repo Created about 8 years ago
Repo Last Updated over 2 years ago
Size 160 KB
Homepage http://codeguide.co
Organization / Authormdo
Latest Releasev2.1.0
Page Updated
Do you use code-guide? Leave a review!
View open issues (39)
View code-guide activity
View on github
Book a Mock Interview With Me (Silicon Valley Engineering Leader, 100s of interviews conducted)
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating code-guide for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Code Guide

Code Guide is a project for documenting standards for developing flexible, durable, and sustainable HTML and CSS. It comes from years of experience writing code on projects of all sizes. It's not the end-all be-all, but it's a start.

Start reading


Released under MIT by, and copyright 2014, @mdo.


Heavily inspired by Idiomatic CSS and the GitHub Styleguide.


Translations are maintained by their creators and may not always be up to date with the original here.

Have a translation you'd like to link to? Open a pull request to add it here. Be sure to keep it alphabetical.


code-guide open issues Ask a question     (View All Issues)
  • about 4 years
  • about 4 years Quotes to url background-image
  • over 4 years open an issue on GitHub
  • over 4 years bootstrap
  • over 4 years 申请加入
  • over 4 years Box-model and border
  • over 4 years CSS declaration order - complete list missing
  • almost 5 years Typo in french version
  • almost 5 years Setting the charset meta will reduce the Google Page Speed Insights and Yahoo Slow test results
  • almost 5 years BEM naming conventions
  • about 5 years Include guidance on where mixins come in declaration order
  • over 5 years Better language code reference
  • over 5 years Add `tabindex` and `style` to attribute ordering section
  • almost 6 years Add additional resource links?
  • almost 6 years Misleading statement
  • almost 6 years ⌥ Option key doesn't show up right
  • over 6 years Add reason for new lines at end of files
  • over 6 years Advise use of child (rather than descendant) selectors when component is recursive?
  • over 6 years Generic element tag selectors also bad for reasons besides perf
  • over 6 years IE compatibility mode specifics
  • over 6 years should it have quotes or not in background image?
code-guide open pull requests (View All Pulls)
  • Updated declaration order list to match example
  • Add a Code Hunt vote badge to README.md
  • Update ie-compatibility-mode.html
  • lowercase X-UA-Compatible & doctype
  • Updated year in License
  • Reorder the elements in import
  • Add reason for new lines at end of files
  • Adjust the order of html content
  • 啊啊啊
  • I've started working on the arabic translation
  • Fix issue #178
  • add Romanian translation
  • Correct 'lang' attribute in html tag
  • fix the "Start reading ☞" link
  • https link to github styleguide
code-guide questions on Stackoverflow (View All Questions)
  • Erlang source code guide
code-guide list of languages used
code-guide latest release notes
v2.1.0 v2.1.0
  • Same content, new format.
  • Now only uses the gh-pages branch.
  • Built on Jekyll with each code snippet coming from an include.
  • Page layout utilizes @mdo/table-grid and scalable typography.
  • Slight reorganization of content.
v2.0.0 v2.0.0

Rewrites much of the document and adds some new hotness:

  • Rewrote golden rule
  • Added boolean attributes to HTML section
  • Added media query placement to CSS section
  • Added editor preferences section
  • Rewrote hella other stuff
  • Added some source/additional reading links


v1.0.0 v1.0.0

This releases serves as a snapshot of what once was. It's not technically v1.0.0, but it's close enough.

Other projects in HTML
Powered by Autocode - Instant Webhooks, Scripts and APIs
Autocode logo wordmark