renderlint
Lint the rendered UI: catches overflowing text, low contrast, overlaps, broken responsive layouts, emoji icons and more in any web framework. Built for AI codin
What is renderlint?
Lint the rendered UI: catches overflowing text, low contrast, overlaps, broken responsive layouts, emoji icons and more in any web framework. Built for AI coding agents.
Overview of renderlint
What it is
renderlint is a linter for the rendered UI. It opens your app in a real browser, finds visual defects coding agents ship, and fails the build until they're fixed. It renders every page at phone, tablet and desktop widths (and dark mode), sweeps the widths in between, and re-checks with longer text, bigger numbers and longer API data. Each defect is reported with the element, the source file, an annotated screenshot and a concrete fix.
Key features
- 51 rules tuned so that a finding is almost always a real defect, covering text overflow, contrast, element overlap, broken images, emoji icons, placeholder text, and more.
- Checks at multiple viewports (phone, tablet, desktop) and dark mode, with longer text and data.
- Reports defects with element, source file, annotated screenshot, and concrete fix.
- New in 0.2.0: checks for loading states (frozen pages), UX pass (--ux) that clicks buttons, fills forms, tests empty lists, dialogs, back button; supports authentication and roles; integrates with Playwright and Storybook.
- Provides skills for coding agents (Claude Code skills) and can be set up with
npx renderlint init.
Use cases
- Catching visual defects that TypeScript and ESLint cannot see because the code is fine but pixels are wrong.
- For AI coding agents to automatically detect and fix UI issues.
- For developers to ensure UI quality across different viewports and data scenarios.
- For testing pages behind login, with mocked APIs, and for server-rendered apps.
Getting started
bashnpx -y @ngocanhnckh/renderlint init # one-time setupnpx renderlint # checkOr install: npm i -D @ngocanhnckh/renderlint. To try once: npx -y @ngocanhnckh/renderlint http://localhost:3000.
License and pricing
MIT license, open source.
Based on the project's public README and repository metadata.