renderlintv0.2.0

Before and after

Seven small pages, each with one kind of defect, and the same pages fixed. Every screenshot and report here is renderlint’s real output from a run on that page; the fixed pages report 0 errors. The pages are in the site’s source, so you can run them yourself.

Text that doesn’t fit its box

text-overflow text-clipped

renderlint’s annotated screenshot at 375px: the Monthly spend and Invoices values cut off inside their cards (boxes 3 and 4, text-clipped), the email running past the account card and the button label cut off (boxes 1 and 2, text-overflow)
Before renderlint’s annotated screenshot
The fixed billing page at 375px: the cards stack, the full value $1,284,930.55 is shown, the email wraps inside the account card and the button fits its label
After 0 errors

A billing page at 375px: a long email and a button label spill out of their card, and two KPI values are cut off by theirs.

Fix: overflow-wrap: anywhere instead of white-space: nowrap, min-width: 0 on the grid items, a fluid font size for the value and no fixed button width.

✖ text-clipped (1)
  error Text is cut off by an overflow:hidden container (137px past the right edge). (×2 similar elements)
        at main > div.grid:nth-of-type(1) > div.card.kpi:nth-of-type(1) > div.v:nth-of-type(2)  "$1,284,930.55"
✖ text-overflow (2)
  error Text spills outside its container (227px past the right edge).
        at main > div.card.acct:nth-of-type(2) > p:nth-of-type(2)  "Email: dana.whitfield-procurement@northwind-enter…
  error Text spills outside its box (46px past the right edge).
        at main > div.card.acct:nth-of-type(2) > p:nth-of-type(3) > span.btn  "Start your free trial today"
✖ viewport-overflow (1)
  …
⚠ fragile-layout (1)

✖ 5 error(s), 1 warning(s)

Content no one can scroll to

unreachable-content

renderlint’s screenshot of an orders screen at 1280px: a dark sidebar and a column of order cards that stops at the bottom edge of the window, outlined in red as unreachable-content
Before renderlint’s annotated screenshot
The fixed orders screen at 1280px: the same list, now inside a scrolling area
After 0 errors

An app shell with height: 100vh; overflow: hidden. The orders list grows past the screen, but its area is not a scroller.

Fix: The area that grows scrolls: flex: 1 1 0%; min-height: 0; overflow-y: auto.

✖ unreachable-content (1)
  error Content can't be scrolled to: 30 pieces of text, reaching 1224px below the bottom of this box (overflow-y: hidden), and neither it nor anyt…
        at div.app > div.mainc > section  "Order #4801 Shipped to Porto, 2 items, paid by card. Order #4802 Ship…"

✖ 1 error(s), 0 warnings

White text on a light gradient

contrast

renderlint’s screenshot at 768px: a weather card on a light-blue gradient, with the title, the description and each day tile boxed in red as contrast errors
Before renderlint’s annotated screenshot
The fixed weather card at 768px: the same white text on a dark blue gradient
After 0 errors

Every text on this weather card is white or near-white over a sky-blue gradient. Measured from the pixels behind each glyph, none reaches WCAG AA.

Fix: A darker gradient (#1d4ed8 to #1e3a8a) so every stop the text sits on passes 4.5:1.

✖ contrast (10)
  error Low text contrast: 1.64:1, needs 3:1 — #ffffff on a non-uniform background (≈#9bd0fc).
        at main > section.hero > h1  "Lisbon, 21°"
  error Low text contrast: 1.59:1, needs 4.5:1 — #e0f2fe on a non-uniform background (≈#8dc5fb).
        at main > section.hero > p  "Light breeze from the north-west. Clear skies until the evening."
  error Low text contrast: 1.66:1, needs 4.5:1 — #ffffff on a non-uniform background (≈#a0cdfc).
        at main > section.hero > div.days > div.day:nth-of-type(1)  "Tue 22° Sunny"
  …

✖ 10 error(s), 0 warnings
renderlint’s screenshot of an alert-settings form: the search icon over the placeholder, the select arrow jammed against the border and a checkbox stretched above its label, each boxed
Before renderlint’s annotated screenshot
The fixed alert-settings form: padding before the placeholder, a custom chevron inset from the border, and the checkbox in a row with its label
After 0 errors

A search icon over the placeholder, a native select arrow 3px from the border, and a checkbox stretched by a global input { width: 100% }.

Fix: padding-left: 40px on the search field, appearance: none with an inset chevron, and a flex row with a fixed-size checkbox.

✖ checkbox-layout (1)
  error A checkbox is stretched to 289px wide, so the box is drawn in the middle of that space, away from its label (usually a global `input { widt…
        at #e
✖ dropdown-arrow (1)
  error The dropdown arrow sits 3px from the right border while the text starts 27px from the left, so the arrow looks jammed against the edge. The…
        at #f  "Every hour Daily digest"
✖ input-icon-overlap (1)
  error An icon is drawn over the area where the field shows its text and placeholder (16px of overlap on the left). Typed text will run underneath…
        at #q

✖ 3 error(s), 0 warnings

A blank card while the data loads

loading-state

renderlint’s side-by-side screenshot at 375px: left, one second into the held request, the Recent orders card is empty and boxed; right, the table that filled it once the data arrived
Before renderlint’s annotated screenshot
The fixed dashboard at 375px: the Recent orders table, which now shows skeleton rows while it loads
After 0 errors

renderlint held GET /orders.json for a second, as a slow network would. The “Recent orders” card showed nothing while it waited.

Fix: Skeleton rows with aria-busy="true" until the data arrives, and an error message with a retry if the request fails.

⚠ loading-state (1)
  warn  While this page waited for its data (GET /orders.json; renderlint held it 1s, as on a slow network), the area where "Order · Customer · Tot…
        at #orders  "Order Customer Total Status A-1042 Lena Fischer €184.00 Paid A-1043 T…"

✔ 0 errors, 1 warning(s)

The browser’s alert() box

native-dialog

✖ native-dialog (1)
  error alert() "Your trial ends in 3 days" opened the browser's native dialog, called at /dialog-before.html:4:51. Replace it with the app's own t…

✖ 1 error(s), 0 warnings
Before renderlint’s report (a native dialog can’t be screenshotted)
The fixed project settings page: the trial notice as an inline status message, and the delete confirmation as a styled modal dialog
After 0 errors

The page opens alert("Your trial ends in 3 days") on load. A native dialog can’t be screenshotted, so renderlint reports where it was called.

Fix: An inline status message for the notice, and a <dialog> opened with showModal() for the delete confirmation.

Reproduce: node bin/renderlint.js site/examples-src/overflow-before.html --no-crawl from a clone of the repository.

Gallery

More findings from real apps

From the README and the gallery: example pages, apps built by Claude Code in headless sessions, and a WordPress site. More in docs/gallery.md.

Six overflow bugs renderlint caught: a long email running off its card, a total cut off only at 1024px, a heading running off a phone screen, chart labels cut off by the SVG edge, a heading clipped by its card, a feature list spilling out of a pricing card
Six times text didn’t fit its box, from example pages, apps Claude built in headless sessions, and an Elementor page.
Left: a run dashboard whose Findings tab stops at the screen edge with no scrollbar. Right: the same tab without the clipping, most of it shaded as never reachable, next to renderlint’s unreachable-content finding
A tab inside a fixed-height app shell that never became a scroller (unreachable-content).
Bar-chart labels overlapping and donut labels cut off by the SVG edge
Colliding bar-chart labels (text-overlap) and donut labels cut off by the SVG edge (text-clipped).
Donut labels clipped at 375px without renderlint, wrapped with it
A real Claude Haiku session: donut labels clipped on phones, then fixed.
KPI tiles showing $undefined, NaN% and Invalid Date
Leaked $undefined, NaN% and Invalid Date (placeholder-text).
Broken avatar, squashed avatar and an unsized icon grown to 204px
Broken and squashed images, and an unsized 24×24 icon at 204px.
KPI cards: fine at 1280px, the spend value cut off at 1024px and boxed by renderlint
The width sweep: fine at 1280px, cut off at 1024px.
An alert-settings form: native select arrows on the border, a checkbox stretched above its label, and a search icon over the placeholder, each boxed by renderlint
Form controls that render but are built wrong.
renderlint’s screenshot of a dashboard: while the orders request is held, the Recent orders card is empty (boxed in red); once the data arrives, the table fills it
loading-state: the orders card is blank while its request is held.
renderlint’s annotated screenshot of an Elementor page with findings boxed
An Elementor page: findings name the widget and link to the editor.
renderlint’s dev overlay on a React dashboard, listing findings with source file and line
The Vite plugin’s live overlay: each finding links to its component file and line.