How to Debug CSS Problems: A Practical Developer's Guide
Why your style isn't applying, what's causing the horizontal scrollbar, and how to work out which rule actually won. A methodical approach to CSS bugs.
Read articlePractical write-ups on inspecting, debugging, testing and auditing websites. Written for developers, with the actual steps rather than the theory.
Last updated
Why your style isn't applying, what's causing the horizontal scrollbar, and how to work out which rule actually won. A methodical approach to CSS bugs.
Read articleThe technical SEO work that belongs to developers: crawlability, indexing, canonicals, rendering, structured data and the checks to run before every release.
Read articleMeasure the right things, in the right order: Core Web Vitals, payload weight, render-blocking assets, third-party scripts and the fixes that move the numbers.
Read articleThe manual checks automated tools can't do, the ones they can, and how to test keyboard access, contrast, labels and screen reader output on a real page.
Read articleNewest first. Filter by topic, or read any of them on their own.
Run the W3C HTML and CSS validators on any page, read the results in the right order, and fix the handful of mistakes that cause most of the errors.
Read articleWhat WCAG contrast ratios mean, how to measure them for any text on a page, how to simulate color blindness, and how to fix low-contrast designs without losing the brand.
Read articleOutline every block, find the element causing horizontal scroll, see stacking order, and inspect flex and grid containers. A visual approach to the layout bugs that DevTools makes slow.
Read articleA repeatable way to test any web form: fill it in seconds, break client-side validation on purpose, check labels and autocomplete, and confirm the server rejects what the browser should have caught.
Read articleWhy an HTTPS page can still show as not fully secure, how to find every insecure image, script and stylesheet, and the fixes that stop mixed content for good.
Read articleSee exactly which title, description, canonical, robots and social tags a page sends, preview how it will look in search and when shared, and fix the mistakes that break link previews.
Read articleMeasure widths, heights, margins and gaps on any website, line elements up against guides, and check a build against the design without screenshots and guesswork.
Read articleSee every hop a URL takes, what each status code means for users and search engines, and how to fix redirect chains, loops and soft 404s after a migration.
Read articleRead console errors properly, find the line that threw, catch unhandled promise rejections, track down rogue event listeners and fix the five errors you'll see most.
Read articlePretty-print unreadable API responses, find the exact character that breaks a JSON file, validate against a schema, compare two payloads and decode JWTs, without pasting data into random websites.
Read articleEverything worth checking before a site goes live, grouped by risk: the things that lose money, the things that lose traffic, and the things people notice.
Read articleShortcuts, panels and console tricks that most developers never find, organised by the task you're trying to finish.
Read articleAudit every image on a page: what it weighs, whether it's oversized for its slot, which format it should be in, and whether the alt text is doing its job.
Read articleSecurity headers, cookie flags, mixed content, exposed secrets and third-party risk: the front-end checks you can run on any page in a few minutes.
Read articleIdentify the framework, CMS, CDN, analytics and hosting behind any site by reading the signals it leaves in headers, markup, globals and network requests.
Read articleFind, read, edit and clear client-side storage in Chrome, understand which mechanism to use for what, and debug the state bugs they cause.
Read articleThree kinds of rot that creep into every site, how to find each one quickly, and how to stop them coming back after the next release.
Read articleThe technical SEO work that belongs to developers: crawlability, indexing, canonicals, rendering, structured data and the checks to run before every release.
Read articleThe manual checks automated tools can't do, the ones they can, and how to test keyboard access, contrast, labels and screen reader output on a real page.
Read articleMeasure the right things, in the right order: Core Web Vitals, payload weight, render-blocking assets, third-party scripts and the fixes that move the numbers.
Read articleA working method for responsive testing: which widths matter, what device emulation gets wrong, and the checks that catch real mobile bugs.
Read articleSee request and response headers for any page or asset in Chrome, plus a reference for the headers that actually change how your site behaves.
Read articleTurn JavaScript off for one site or all sites in Chrome, using settings, DevTools or a per-site toggle, and know which method fits which job.
Read articleWhy your style isn't applying, what's causing the horizontal scrollbar, and how to work out which rule actually won. A methodical approach to CSS bugs.
Read articleOpen the inspector, read the DOM instead of the source, and track down the markup problems that cause layout, accessibility and SEO bugs.
Read article