What is this?
lintapple is a CLI tool that checks a running web app's UI for layout and design mistakes AI coding tools commonly make, like bad fonts, low contrast, misaligned elements, and inconsistent spacing.
lintapple is a CLI tool that checks a running web app's UI for layout and design mistakes AI coding tools commonly make, like bad fonts, low contrast, misaligned elements, and inconsistent spacing.Is it a linter I run from the terminal, or a library I import into code?It is a CLI linter: installing it adds a ui-policy.json config and a lint:ui npm script that checks your running app's URL, and it also has a helper you can call from Playwright tests.
It is a CLI linter: installing it adds a ui-policy.json config and a lint:ui npm script that checks your running app's URL, and it also has a helper you can call from Playwright tests.How do I add it to my project?Run the install command in your app's project directory; it creates ui-policy.json (where you set your fonts and sizes) and adds a lint:ui script pointing at your app's URL.
Run the install command in your app's project directory; it creates ui-policy.json (where you set your fonts and sizes) and adds a lint:ui script pointing at your app's URL.Do I need anything besides Node to run it?You need Node.js 22 or later, and your app must already be running locally so lintapple can check it at its URL.
You need Node.js 22 or later, and your app must already be running locally so lintapple can check it at its URL.Do all the checks work out of the box, or do I need to add markup?Font, contrast, control-size, and screen-bounds checks work with no extra markup, but spacing, alignment, and corner-radius checks need data-ui-* attributes added to your elements.
Font, contrast, control-size, and screen-bounds checks work with no extra markup, but spacing, alignment, and corner-radius checks need data-ui-* attributes added to your elements.What do the exit codes mean when I run lint:ui?Exit code 0 means the check passed, 1 means it found UI issues, and 2 means the check itself failed to complete.
Exit code 0 means the check passed, 1 means it found UI issues, and 2 means the check itself failed to complete.What information does each finding give me?Each finding reports the rule that was violated, the element involved, the measured value, and a suggested fix.
Each finding reports the rule that was violated, the element involved, the measured value, and a suggested fix.Can I check a different URL or save the results?Yes, lintapple lets you point it at another URL or save its output as a JSON report instead of just printing to the terminal.
Yes, lintapple lets you point it at another URL or save its output as a JSON report instead of just printing to the terminal.What are similar projects?testsprite-cli, e2e, agentic-playwright, playwright, midscene, SeleniumBase, playwright-python, expect
testsprite-cli, e2e, agentic-playwright, playwright, midscene, SeleniumBase, playwright-python, expectWhich topics is it in?e2e-testing, test-automation, linter, playwright, static-analysis, design, cli-tool, testing, ui, web-development, command-line-tool, npm
e2e-testing, test-automation, linter, playwright, static-analysis, design, cli-tool, testing, ui, web-development, command-line-tool, npm