wtf-html-css

WTF, HTML and CSS? is a curated list of the common mistakes, quirks, and frustrating moments that trip people up when building web pages. If you've ever styled a button and watched it inexplicably push your entire layout out of place, or spent an hour trying to center a simple image, this is the resource that explains why that happened and how to fix it.

At a high level, the project is a living document of pitfalls. It covers situations where web browsers interpret code differently than you'd expect, or where the underlying rules of web design behave in counterintuitive ways. Rather than teaching you how to code from scratch, it serves as a troubleshooting guide you can turn to when your page looks broken and you're not sure which rule is causing the problem.

This is primarily aimed at people who write web pages but don't necessarily consider themselves senior developers, which makes it perfect for vibe coders, product managers, or founders who occasionally tinker with front-end code. If you're building a personal portfolio, tweaking a landing page, or adjusting the look of an existing site, you'll inevitably run into confusing behavior. This guide helps you skip the frustration of searching for answers by gathering those common dilemmas in one place.

The project is notable for its community-driven approach and global reach. Anyone can suggest additions or improvements through the standard contribution process, which means the list reflects problems that real people actually encounter, not just theoretical issues. It has also been translated into several languages, including French, Spanish, Russian, and Chinese, reflecting how universal these web development headaches are across the world.