# renderlint > renderlint (npm: @yitec/renderlint) is an open-source (MIT) command-line linter for the rendered UI. It opens a web app in headless Chromium at phone, tablet and desktop widths (375, 768 and 1280px by default, plus a sweep of 13 widths from 320 to 1920px), finds visual defects that code checks can't see, and exits non-zero until they are fixed. Each finding names the element, the source file, an annotated screenshot and a concrete fix, in plain text a coding agent can act on. Key facts: - 52 rules: text overflow and clipping, contrast measured from real pixels (works on gradients and images), overlap, unreachable content, menus cut off or drawn underneath, form-control layout, leaked placeholders (undefined, NaN), emoji icons, broken images, missing loading states, layout shift, alert()/confirm(), pages behind a login, and runtime errors. - Works with any framework that renders in a browser: Next.js, React, Vue, Nuxt, Svelte/SvelteKit, Astro, Angular, React Router/Remix, TanStack Router, Vite, plain HTML, WordPress and Elementor. Integrations: build scripts, a Vite plugin, a Claude Code Stop hook, AGENTS.md and skills for other agents, Playwright Test, Storybook, GitHub Actions annotations. - No baseline images: it judges each page on its own, unlike visual regression testing. - In an experiment with 22 headless Claude Code sessions, the 11 apps built without renderlint had 229 errors between them; the 11 built with it finished at 0. - Install: `npx -y @yitec/renderlint init` then `npx renderlint`. Requires Node.js 18.17+. Source: https://github.com/ngocanhnckh/renderlint ## Pages - [Blog: UI quality checks for the rendered page | renderlint](https://renderlint.yitec.net/blog/): Practical articles on UI defects that code review misses: text overflow, contrast on gradients, unreachable content, cut-off menus, loading states and more. - [All 52 rules: what renderlint checks on the rendered page](https://renderlint.yitec.net/rules/): Reference for every renderlint rule: text overflow, contrast from real pixels, overlap, unreachable content, menus, forms, loading states and more, with fixes. - [renderlint: a linter for the rendered UI](https://renderlint.yitec.net/): renderlint opens your app in a real browser, finds visual UI defects like overflow, low contrast and hidden menus, and fails the build until they are fixed. - [Get started with renderlint: install, run and gate your builds](https://renderlint.yitec.net/get-started/): Install renderlint in one command, check any app or static build, and make CI, Vite builds and Claude Code fail on visual UI defects. Setup for every framework. - [Before and after: real UI defects renderlint caught](https://renderlint.yitec.net/examples/): Real renderlint output on real pages: overflow, contrast, unreachable content, hidden menus, forms, loading states and alert(), each with its fix. ## Articles - [How to find text overflow and clipped text in responsive layouts](https://renderlint.yitec.net/blog/text-overflow-clipped-text-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. - [How to measure color contrast on gradients and background images](https://renderlint.yitec.net/blog/color-contrast-gradients-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. - [Content you can't scroll to: 100vh app shells, scroll locks and tall modals](https://renderlint.yitec.net/blog/content-you-cant-scroll-to/): 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. - [Why your dropdown is cut off: overflow hidden, z-index and stacking contexts](https://renderlint.yitec.net/blog/dropdown-cut-off-overflow-hidden-z-index/): 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. - [Loading states and layout shift: testing what users see on a slow network](https://renderlint.yitec.net/blog/loading-states-layout-shift/): 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. - [How to test every route and role behind a login](https://renderlint.yitec.net/blog/test-every-route-and-role-behind-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. - [How to catch UI bugs written by AI coding agents](https://renderlint.yitec.net/blog/catch-ui-bugs-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. - [Visual regression testing vs rendered-UI linting](https://renderlint.yitec.net/blog/visual-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. - [How to replace alert(), confirm() and prompt() in a web app](https://renderlint.yitec.net/blog/replace-alert-confirm-prompt/): 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. - [Form controls that render wrong: dropdown arrows, checkboxes and input icons](https://renderlint.yitec.net/blog/form-control-layout-bugs/): 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. ## Documentation (GitHub) - [README](https://github.com/ngocanhnckh/renderlint#readme): overview, usage, configuration, limitations - [Rules](https://github.com/ngocanhnckh/renderlint/blob/master/docs/rules.md) - [Configuration](https://github.com/ngocanhnckh/renderlint/blob/master/docs/configuration.md) - [Authentication](https://github.com/ngocanhnckh/renderlint/blob/master/docs/authentication.md) and [roles and coverage](https://github.com/ngocanhnckh/renderlint/blob/master/docs/roles-and-coverage.md) - [Results of the agent experiments](https://github.com/ngocanhnckh/renderlint/blob/master/docs/results.md) - [Changelog](https://github.com/ngocanhnckh/renderlint/blob/master/CHANGELOG.md) ## Optional - [Full text of this site](https://renderlint.yitec.net/llms-full.txt)