Front-End Checklist
🚨 Currently working on a V2 of frontendchecklist.io,
feel free to discuss any feature you would like to see in the next version
The Front-End Checklist is an exhaustive list of all elements you need to have / to test before launching your website / HTML page to production.
How To Use • Contributing • Website • Product Hunt
Other Checklists:
🎮 Front-End Performance Checklist • 💎 Front-End Design Checklist
It is based on Front-End developers' years of experience, with the additions coming from some other open-source checklists.
How to use?
All items in the Front-End Checklist are required for the majority of the projects, but some elements can be omitted or are not essential (in the case of an administration web app, you may not need RSS feed for example). We choose to use 3 levels of flexibility:
![Low][low_img] means that the item is recommended but can be omitted in some particular situations.
![Medium][medium_img] means that the item is highly recommended and can eventually be omitted in some really particular cases. Some elements, if omitted, can have bad repercussions in terms of performance or SEO.
![High][high_img] means that the item can't be omitted by any reason. You may cause a dysfunction in your page or have accessibility or SEO issues. The testing priority needs to be on these elements first.
Some resources possess an emoticon to help you understand which type of content / help you may find on the checklist:
📖: documentation or article
🛠: online tool / testing tool
📹: media or video content
You can contribute to the Front-End Checklist App reading the CONTRIBUTING.md file which explains everything about the project.
Head
Meta tag
[ ] Doctype: ![High][high_img] The Doctype is HTML5 and is at the top of all your HTML pages.
- ``` html
- <!doctype html>
- ```
The next 2 meta tags (Charset and Viewport) need to come first in the head.
[ ] Charset: ![High][high_img] The charset (UTF-8) is declared correctly.
- ``` html
- <meta charset="utf-8">
- ```
[ ] Viewport: ![High][high_img] The viewport is declared correctly.
- ``` html
- <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
- ```
[ ] Title: ![High][high_img] A title is used on all pages (SEO: Google calculates the pixel width of the characters used in the title, and it cuts off between 472 and 482 pixels. The average character limit would be around 55-characters).
- ``` html
- <title>Page Title less than 55 characters</title>
- ```
[ ] Description: ![High][high_img] A meta description is provided, it is unique and doesn't possess more than 150 characters.
- ``` html
- <meta name="description" content="Description of the page less than 150 characters">
- ```
[ ] Favicons: ![Medium][medium_img] Each favicon has been created and displays correctly. If you have only a favicon.ico, put it at the root of your site. Normally you won't need to use any markup. However, it's still good practice to link to it using the example below. Today, PNG format is recommended over .ico format (dimensions: 32x32px).
- ``` html
- <link rel="icon" type="image/x-icon" href="https://example.com/favicon.ico">
- <link rel="icon" type="image/png" href="https://example.com/favicon.png">
- ```
[ ] Apple Web App Meta: ![Low][low_img] Apple meta-tags are present.
- ``` html
- <link rel="apple-touch-icon" href="/custom-icon.png">
- <meta name="apple-mobile-web-app-capable" content="yes">
- <meta name="apple-mobile-web-app-status-bar-style" content="black">
- ```
[ ] Windows Tiles: ![Low][low_img] Windows tiles are present and linked.
- ``` html
- <meta name="msapplication-config" content="browserconfig.xml" />
- ```
Minimum required xml markup for the browserconfig.xml file is as follows:
- ```xml
- <?xml version="1.0" encoding="utf-8"?>
- <browserconfig>
- <msapplication>
- <tile>
- <square70x70logo src="small.png"/>
- <square150x150logo src="medium.png"/>
- <wide310x150logo src="wide.png"/>
- <square310x310logo src="large.png"/>
- </tile>
- </msapplication>
- </browserconfig>
- ```
[ ] Canonical: ![Medium][medium_img] Use rel="canonical" to avoid duplicate content.
- ``` html
- <link rel="canonical" href="http://example.com/2017/09/a-new-article-to-read.html">
- ```
HTML tags
[ ] Language attribute: ![High][high_img] The lang attribute of your website is specified and related to the language of the current page.
- ``` html
- <html lang="en">
- ```
[ ] Direction attribute: ![Medium][medium_img] The direction of lecture is specified on the html tag (It can be used on another HTML tag).
- ``` html
- <html dir="rtl">
- ```
[ ] Alternate language: ![Low][low_img] The language tag of your website is specified and related to the language of the current page.
- ``` html
- <link rel="alternate" href="https://es.example.com/" hreflang="es">
- ```
[ ] x-default: ![Low][low_img] The language tag of your website for international landing pages.
- ``` html
- <link rel="alternate" href="https://example.com/" hreflang="x-default" />
- ```
[ ] Conditional comments: ![Low][low_img] Conditional comments are present for IE if needed.
[ ] RSS feed: ![Low][low_img] If your project is a blog or has articles, an RSS link was provided.
* [ ] **CSS Critical:** ![Medium][medium_img] The CSS critical (or "above the fold") collects all the CSS used to render the visible portion of the page. It is embedded before your principal CSS call and between `` in a single line (minified).
* [ ] **CSS order:** ![High][high_img] All CSS files are loaded before any JavaScript files in the ``. (Except the case where sometimes JS files are loaded asynchronously on top of your page).
Social meta
Visualize and generate automatically our social meta tags with
Meta Tags
Facebook OG and Twitter Cards are, for any website, highly recommended. The other social media tags can be considered if you target a particular presence on those and want to ensure the display.
[ ] Facebook Open Graph: ![Low][low_img] All Facebook Open Graph (OG) are tested and no one is missing or with false information. Images need to be at least 600 x 315 pixels, although 1200 x 630 pixels is recommended.
Notes: Using og:image:width and og:image:height will specify the image dimensions to the crawler so that it can render the image immediately without having to asynchronously download and process it.
- ``` html
- <meta property="og:type" content="website">
- <meta property="og:url" content="https://example.com/page.html">
- <meta property="og:title" content="Content Title">
- <meta property="og:image" content="https://example.com/image.jpg">
- <meta property="og:description" content="Description Here">
- <meta property="og:site_name" content="Site Name">
- <meta property="og:locale" content="en_US">
- <meta property="og:image:width" content="1200">
- <meta property="og:image:height" content="630">
- ```
[ ] Twitter Card: ![Low][low_img]
- ``` html
- <meta name="twitter:card" content="summary">
- <meta name="twitter:site" content="@site_account">
- <meta name="twitter:creator" content="@individual_account">
- <meta name="twitter:url" content="https://example.com/page.html">
- <meta name="twitter:title" content="Content Title">
- <meta name="twitter:description" content="Content description less than 200 characters">
- <meta name="twitter:image" content="https://example.com/image.jpg">
- ```
HTML
Best practices
[ ] HTML5 Semantic Elements: ![High][high_img] HTML5 Semantic Elements are used appropriately (header, section, footer, main...).
[ ] Error pages: ![High][high_img] Error 404 page and 5xx exist. Remember that the 5xx error pages need to have their CSS integrated (no external call on the current server).
[ ] Noopener: ![Medium][medium_img] In case you are using external links with target="_blank", your link should have a rel="noopener" attribute to prevent tab nabbing. If you need to support older versions of Firefox, use rel="noopener noreferrer".
[ ] Clean up comments: ![Low][low_img] Unnecessary code needs to be removed before sending the page to production.
HTML testing
[ ] W3C compliant: ![High][high_img] All pages need to be tested with the W3C validator to identify possible issues in the HTML code.
[ ] HTML Lint: ![High][high_img] I use tools to help me analyze any issues I could have on my HTML code.
[ ] Link checker: ![High][high_img] There are no broken links in my page, verify that you don't have any 404 error.
[ ] Adblockers test: ![Medium][medium_img] Your website shows your content correctly with adblockers enabled (You can provide a message encouraging people to disable their adblocker).
Webfonts
Notes: Using web fonts may cause Flash Of Unstyled Text/Flash Of Invisible Text - consider having fallback fonts and/or utilizing web font loaders to control behavior.
[ ] Webfont format: ![High][high_img] WOFF, WOFF2 and TTF are supported by all modern browsers.
[ ] Webfont size: ![High][high_img] Webfont sizes don't exceed 2 MB (all variants included).
[ ] Webfont loader: ![Low][low_img] Control loading behavior with a webfont loader
CSS
[ ] Responsive Web Design: ![High][high_img] The website is using responsive web design.
[ ] CSS Print: ![Medium][medium_img] A print stylesheet is provided and is correct on each page.
[ ]
Preprocessors: ![Low][low_img] Your project is using a CSS preprocessor (e.g
Sass,
Less,
Stylus).
[ ] Unique ID: ![High][high_img] If IDs are used, they are unique to a page.
[ ] Reset CSS: ![High][high_img] A CSS reset (reset, normalize or reboot) is used and up to date. (If you are using a CSS Framework like Bootstrap or Foundation, a Normalize is already included into it.)
[ ] JS prefix: ![Low][low_img] All classes (or id- used in JavaScript files) begin with js- and are not styled into the CSS files.
- ``` html
- <div id="js-slider" class="my-slider">
- <div id="id-used-by-cms" class="js-slider my-slider">
- ```
* [ ] **embedded or inline CSS:** ![High][high_img] Avoid at all cost embedding CSS in `