Frontend Checklist
A front-end checklist covering meta tags, HTML, CSS, JavaScript, performance, SEO, accessibility and security.
12 min read
Landing Website — Frontend Checklist & TODO
Based on Front-End Checklist, Front-End Performance Checklist, and Hugo Best Practices.
Priority: 🔴 High · 🟡 Medium · 🟢 Low
1. HEAD & Meta Tags
- Doctype 🔴 — HTML5 doctype is present at the top of all pages
- Charset 🔴 — UTF-8 declared as the first meta tag in
<head> - Viewport 🔴 —
width=device-width, initial-scale=1is set - Viewport
viewport-fit🟢 — Addviewport-fit=coverfor notched devices:<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"> - Title 🔴 — Every page has a unique, descriptive
<title>(< 55 characters) - Meta description 🔴 — Per-page descriptions provided (< 150 characters)
-
keywordsmeta tag 🟡 — Either populated dynamically from tags/categories or removed entirely (Google ignores it, but an empty tag looks unprofessional) - Canonical URL 🔴 —
<link rel="canonical">present to avoid duplicate content - Language attribute 🔴 —
<html lang="...">set correctly for the page language - Alternate hreflang 🟢 — Hreflang tags present for all translations
-
x-defaulthreflang 🟡 —<link rel="alternate" hreflang="x-default" href="..." />present for international landing page fallback (Google recommendation) -
twitter:cardmeta tag 🟡 —twitter:cardtype declared (e.g.,summary_large_image). Required for Twitter/X preview cards - Open Graph tags 🟡 —
og:type,og:title,og:description,og:image,og:url,og:locale,og:site_namepresent -
og:image:widthandog:image:height🟢 — Dimensions specified so crawlers render immediately without downloading - CSS before JS 🔴 — All CSS
<link>tags loaded before any<script>tags in<head>
2. Favicons & Web App Manifest
- Favicon files 🟡 — All required sizes present (16x16, 32x32, 192x192, 512x512, apple-touch-icon, favicon.ico)
- Web manifest 🟡 —
site.webmanifestexists and is linked - Manifest
nameandshort_name🔴 — Both fields populated with the site name (required for PWA install prompts and bookmarking) - Theme color 🟢 —
<meta name="theme-color">set to match brand
3. HTML Quality
- Semantic HTML5 🔴 — Appropriate use of
<header>,<footer>,<section>,<main>,<aside>,<nav>,<article> - 404 error page 🔴 — Custom 404 page exists with inline CSS (no external stylesheet dependency)
- 5xx error page 🟡 — Custom 500 error page exists with inline CSS
- No boilerplate/template remnants 🔴 — All placeholder text, debug strings, and framework boilerplate removed from production templates
- No dead code 🟢 — Unused template blocks, variables, and commented-out code removed
-
noopener noreferreron external links 🔴 — Alltarget="_blank"links includerel="noopener noreferrer"to prevent tab nabbing -
<noscript>fallback 🟡 — A minimal fallback message provided for users with JavaScript disabled - No unused source files 🟢 — Unused SCSS/JS source files removed from the project
- All strings internationalized 🟡 — No hardcoded UI strings in templates; all user-facing text pulled from i18n files
- W3C HTML validation 🔴 — All pages pass W3C validator without errors
- Broken link check 🔴 — No broken internal or external links (use W3C Link Checker)
- Clean production code 🟢 — HTML comments and unnecessary whitespace removed in production output
4. CSS
- CSS preprocessor 🟢 — Using a CSS preprocessor (Sass/SCSS/Less) for maintainability
- Autoprefixer 🔴 — Vendor prefixes generated automatically via Autoprefixer or PostCSS
- Minification 🔴 — All CSS minified in production
- Fingerprinting / cache busting 🟡 — CSS filenames include content hash for cache invalidation
- SRI (Subresource Integrity) 🟡 — CSS
<link>tags includeintegrityattribute - Single CSS bundle 🔴 — All CSS concatenated into a single file (or minimal files for HTTP/2)
- CSS Reset / Normalize 🔴 — A CSS reset, normalize, or reboot is included and up to date
- Unused CSS removed 🟡 — Unused CSS selectors purged (via PurgeCSS or similar). Full framework imports trimmed to needed components
- Critical CSS 🟡 — Above-the-fold CSS inlined in
<head>for faster First Contentful Paint (FCP) -
font-displayproperty 🟡 — Web fonts (including icon fonts) usefont-display: swapto prevent FOIT (Flash of Invisible Text) - No inline CSS in
<body>🔴 — All styles in external files or<head>(except critical CSS) - Unique IDs 🔴 — All element IDs are unique per page
- Responsive design 🔴 — Tested at 320px, 768px, 1024px, 1440px breakpoints
- Print stylesheet 🟡 — Print-specific styles provided
- CSS validation 🟡 — CSS passes W3C CSS Validator
- LTR/RTL support 🟡 — If multilingual, tested for RTL languages
5. JavaScript
- No inline JS in
<body>🔴 — JavaScript code in external files, not mixed with HTML - Minification 🔴 — All JS files minified in production
- Fingerprinting / SRI 🔴 — JS filenames hashed and
integrityattribute present - Non-blocking loading 🔴 — Scripts loaded with
deferorasyncattribute - Bundled into minimal files 🔴 — All JS concatenated/bundled to minimize HTTP requests
- No
javascript:void(0)🟡 — Using properhref="#"withevent.preventDefault()or<button>elements instead - Updated libraries 🟡 — All JS libraries are up to date with latest stable versions
- Dependency size audit 🟢 — External libraries are necessary and as lightweight as possible (consider Vanilla JS for simple features)
- ESLint / linting 🟡 — No errors flagged by a JS linter
- No console.log in production 🟢 — Debug logging removed from production builds
6. Images
- Image optimization 🔴 — All images compressed without visible quality loss (target: < 200 KB per image)
- Modern formats 🟡 — Using WebP (or AVIF) with fallbacks where appropriate
- No duplicate format files 🟢 — If multiple formats exist for the same image, implement
<picture>with fallback or remove unused formats - SVG optimization 🟡 — Large SVG files optimized with SVGO
-
loading="lazy"🟡 — Below-the-fold images use native lazy loading - Descriptive
alttext 🔴 — All<img>tags have meaningful, descriptive alt text (not just the brand name) -
widthandheightattributes 🟡 — Dimensions specified on images to prevent Cumulative Layout Shift (CLS) - Responsive images 🟡 — Using
srcsetand<picture>to serve appropriately sized images per viewport - Hugo image processing 🟡 — Using Hugo’s built-in
.Resize/.Fit/.Fillfor serving optimally sized images (Hugo-specific) - No oversized images in content 🔴 — Blog/content images are appropriately sized (not raw camera/design exports)
7. Video & Media
- Video hosting strategy 🔴 — Large videos hosted on CDN or streaming platform (YouTube/Vimeo) rather than self-hosted in
static/ - Video compression 🟡 — Self-hosted videos compressed with modern codecs (H.265/VP9), with WebM fallback
-
preloadoptimization 🟡 — Videos not auto-loaded usepreload="none"orpreload="metadata"to save bandwidth - Video file size 🔴 — Self-hosted video files kept under 5 MB each where possible
8. Performance
- Resource hints 🟡 —
<link rel="preconnect">and/or<link rel="dns-prefetch">added for critical external domains (analytics, CDN, API) - Page weight < 1.5 MB 🔴 — Initial page load (HTML + CSS + JS + images) kept under 1.5 MB, ideally under 500 KB
- Page load time < 3 seconds 🔴 — Full page load under 3 seconds on 3G connection
- TTFB < 1.3 seconds 🔴 — Time To First Byte under 1.3 seconds
- HTML minification 🟡 — Hugo minify config enabled:
minify:disableXML: trueminifyOutput: true
- Gzip/Brotli compression 🔴 — Server delivers compressed responses (verify with
curl -H "Accept-Encoding: gzip" -I) - HTTP cache headers 🟡 — Static assets have appropriate
Cache-Controlheaders - Google PageSpeed score ≥ 90 🔴 — PageSpeed Insights score ≥ 90 on both mobile and desktop
- Core Web Vitals 🔴 — LCP, INP, and CLS metrics within “Good” thresholds
- Cookie size 🟡 — Each cookie under 4096 bytes; domain has fewer than 20 cookies
- Minimal HTTP requests 🔴 — Every requested file is essential; no unnecessary requests
- CDN 🟡 — Static assets served from a CDN for global performance
- Same-protocol assets 🔴 — All assets served over HTTPS; no mixed content
9. SEO
- Sitemap 🔴 —
sitemap.xmlgenerated and submitted to Google Search Console - robots.txt 🔴 —
robots.txtpresent and not blocking important pages - robots.txt environment check 🟡 — Verify that production environment variables are set so robots.txt allows crawling (not
Disallow: /) -
enableRobotsTXTin Hugo config 🟡 — Enabled inconfig.yamlso Hugo uses the custom robots.txt template - Structured data (JSON-LD) 🔴 — Schema.org markup present and validated with Rich Results Test
- Schema.org accuracy 🟡 — Author names, sameAs URLs, and image references in JSON-LD are correct (not empty or placeholder values)
- Sitemap configuration 🟡 — Hugo sitemap config set with
changefreqandpriority:sitemap:changefreq: weeklypriority: 0.5 - Heading hierarchy 🟡 — Proper heading order (single
<h1>per page,<h2>→<h3>→ etc.) without skipping levels - HTML sitemap 🟡 — An HTML sitemap page is accessible via the footer
- Google Analytics / Search Console 🟢 — Analytics installed and Search Console configured
10. Accessibility (a11y)
- Skip navigation link 🔴 — “Skip to main content” link at the top of the page:
<a href="#content" class="visually-hidden-focusable">Skip to main content</a>
- Focus styles 🔴 —
:focusoutlines visible on all interactive elements; not suppressed by custom CSS - Color contrast 🟡 — All text/background combinations pass WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large text)
- ARIA labels on icon-only links 🟡 — Links/buttons using only icons have
aria-labelfor screen readers - Keyboard navigation 🔴 — All interactive elements (nav, modals, forms, buttons) reachable and operable with keyboard only
- Screen reader testing 🟡 — Pages tested with at least one screen reader (VoiceOver, NVDA, ChromeVox)
- Form labels 🔴 — All form inputs have associated
<label>elements oraria-label - Heading structure 🔴 — Headings used in proper order for document outline (not for visual styling)
- WAVE / axe audit 🟡 — Automated accessibility testing passed with WAVE or axe
- Progressive enhancement 🟡 — Core functionality (navigation, content) works without JavaScript
11. Security
- HTTPS everywhere 🔴 — All pages and assets served over HTTPS
- SRI (Subresource Integrity) 🟡 — External/CDN CSS and JS include
integrityandcrossoriginattributes -
noopener noreferrer🔴 — Alltarget="_blank"links includerel="noopener noreferrer" - Content Security Policy (CSP) 🟡 — CSP headers configured to restrict resource loading sources
- HSTS header 🟡 —
Strict-Transport-Securityheader set withmax-age≥ 31536000 -
X-Content-Type-Options🟢 —nosniffheader set to prevent MIME-type sniffing -
X-Frame-Options🟢 —DENYorSAMEORIGINheader set to prevent clickjacking - Security headers audit 🟡 — Scan with securityheaders.com and Mozilla Observatory
12. Hugo-Specific Best Practices
- Content archetypes 🟡 — Archetypes defined for each content type (blog, page, etc.) with pre-filled front matter:
archetypes/blog.md ---title: "{{ replace .Name "-" " " | title }}"description: ""date: {{ .Date }}draft: truearchived: falsetoc: truetags: []--- -
canonifyURLs🟡 — Consider enablingcanonifyURLs: truein config for consistent URL handling - External link render hook 🟡 — Custom
render-link.htmlinlayouts/_default/_markup/to addtarget="_blank" rel="noopener noreferrer"to external links in markdown content - Content for all configured languages 🟡 — All languages in config have corresponding content directories, or unused languages are disabled
-
.gitignorecoverage 🟢 — Build artifacts ignored:public/,resources/,node_modules/, generated JS/CSS inassets/ - Content organization 🟢 — Images stored alongside their markdown files (page bundles), not in a separate global folder
- Hugo Pipes for assets 🟡 — Using
resources.Minify,resources.Fingerprint, andresources.Concatfor CSS/JS processing - Conditional asset loading 🟢 — Page-specific scripts and styles wrapped in Hugo conditionals to avoid loading on every page
13. Build & CI/CD
- Pinned CI image 🔴 — CI container uses a specific version (e.g.,
node:20-alpine), notlatest - Hugo binary available in CI 🟡 — Hugo is correctly installed/available in the CI build environment
- Production environment variables 🟡 —
HUGO_ENV=production(or equivalent) set in CI so that:robots.txtallows crawling- Analytics scripts are activated
- Minification/optimization is enabled
- Build size monitoring 🟢 — Bundle size tracked and checked on each build (consider size-limit or similar)
- Build reproducibility 🟡 —
package-lock.jsoncommitted andnpm ciused instead ofnpm installin CI
14. Fonts & Typography
- WOFF2 format 🔴 — Web fonts served in WOFF2 format (with WOFF fallback for older browsers)
- Webfont total size < 300 KB 🟡 — All font files (including icon fonts) combined under 300 KB
-
font-display: swap🟡 — All@font-facedeclarations includefont-display: swap - Preconnect for font CDN 🟡 — If using Google Fonts or similar:
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> - System font stack considered 🟢 — Evaluated whether a system font stack is sufficient vs. custom web fonts (better performance)
- Icon font audit 🟢 — If using an icon font, verify full font is needed; consider inline SVG for a small number of icons
15. Pre-Launch Summary Checklist
| # | Item | Status |
|---|---|---|
| 1 | Web manifest has valid name/short_name |
⬜ |
| 2 | No boilerplate/placeholder text in templates | ⬜ |
| 3 | rel="noopener noreferrer" on all external links |
⬜ |
| 4 | All images optimized (< 200 KB each) | ⬜ |
| 5 | Videos compressed or externally hosted | ⬜ |
| 6 | Skip navigation link present | ⬜ |
| 7 | CI uses pinned image version | ⬜ |
| 8 | Production env variables set in CI | ⬜ |
| 9 | Core Web Vitals in “Good” range | ⬜ |
| 10 | robots.txt allows crawling in production |
⬜ |
| 11 | PageSpeed score ≥ 90 (mobile + desktop) | ⬜ |
| 12 | Accessibility audit passed (WAVE/axe) | ⬜ |
| 13 | Structured data validated (Schema.org) | ⬜ |
| 14 | Security headers audit passed | ⬜ |
| 15 | All forms have labels and proper input types | ⬜ |