Notes on UI that looks right in code and wrong on screen
Each article explains one class of visual defect: why the browser draws it that way, how to fix it in CSS or markup, and how to catch it automatically before it ships.
How to find text overflow and clipped text in responsive layouts
Text overflows when a box has a fixed width, nowrap or overflow hidden. Check every width, not three, and try longer text, long words and bigger numbers.
text-overflowtext-clippedtext-crowdingfragile-layoutHow to measure color contrast on gradients and background images
Text on a gradient or photo has no single background color. Measure the pixels behind each glyph, compare to WCAG AA 4.5:1 and 3:1, then fix the background.
contrastContent you can't scroll to: 100vh app shells, scroll locks and tall modals
Why content past a fixed-height shell can't be scrolled to, which CSS causes it (100vh, overflow hidden, min-height, scroll locks), and how to fix it.
unreachable-contentWhy your dropdown is cut off: overflow hidden, z-index and stacking contexts
A dropdown is cut off when an ancestor clips it with overflow or traps it in a stacking context. Here is why raising z-index fails and what fixes it.
popup-obscuredLoading states and layout shift: testing what users see on a slow network
Why pages with no loading state look fine on a dev machine and broken on a phone, what counts as a loading sign, and how to test it by holding requests.
loading-statelayout-shiftaction-feedbackerror-feedbackHow to test every route and role behind a login
Automated UI checks usually see only the login form. Here is how to check every route as every role, with no backend, and fail CI when a page goes unchecked.
auth-requiredpage-not-shownHow to catch UI bugs written by AI coding agents
Coding agents ship code that compiles and pages that look wrong. Here is why, what a 22-session experiment found, and how to make an agent check its own UI.
contrasttext-clippedemojifragile-layoutVisual regression testing vs rendered-UI linting
Visual regression tools diff screenshots against an approved baseline. A rendered-UI linter judges the page itself. When to use each, and how to run both in CI.
text-overflowcontrastfragile-layoutunreachable-contentHow to replace alert(), confirm() and prompt() in a web app
Native alert(), confirm() and prompt() block the page and can't be styled or translated. Replace them with toasts, inline messages and a promise-based dialog.
native-dialogdialog-focusForm controls that render wrong: dropdown arrows, checkboxes and input icons
Why checkboxes stretch, select arrows ignore padding, input icons cover text and fields get squashed, with the CSS fixes and how to catch them from pixels.
dropdown-arrowcheckbox-layoutinput-icon-overlapsquashed-control