impeccable 2.0.4 → 2.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -10
- package/README.npm.md +10 -10
- package/{README.bak.md → README.repo.md} +3 -3
- package/bin/{impeccable → cli.js} +9 -5
- package/package.json +32 -18
- package/src/detect-antipatterns-browser.js +2400 -0
- package/src/detect-antipatterns.mjs +3588 -0
- package/lib/download-providers.js +0 -24
package/README.md
CHANGED
|
@@ -29,27 +29,27 @@ npx impeccable detect --fast src/
|
|
|
29
29
|
|
|
30
30
|
## What It Detects
|
|
31
31
|
|
|
32
|
-
**AI Slop Tells
|
|
32
|
+
**AI Slop Tells**: patterns that scream "AI generated this":
|
|
33
33
|
- Side-tab accent borders, gradient text on headings
|
|
34
34
|
- Purple/violet gradients and cyan-on-dark palettes
|
|
35
35
|
- Dark mode with glowing accents, border + border-radius clashes
|
|
36
36
|
|
|
37
|
-
**Typography Issues
|
|
37
|
+
**Typography Issues**: overused fonts (Inter, Roboto), flat type hierarchy, single font families
|
|
38
38
|
|
|
39
|
-
**Color & Contrast
|
|
39
|
+
**Color & Contrast**: WCAG AA violations, gray text on colored backgrounds, pure black/white
|
|
40
40
|
|
|
41
|
-
**Layout & Composition
|
|
41
|
+
**Layout & Composition**: nested cards, monotonous spacing, everything-centered layouts
|
|
42
42
|
|
|
43
|
-
**Motion
|
|
43
|
+
**Motion**: bounce/elastic easing, layout property transitions
|
|
44
44
|
|
|
45
|
-
**Quality
|
|
45
|
+
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
46
46
|
|
|
47
47
|
25 detections in total. See the full list at [impeccable.style](https://impeccable.style).
|
|
48
48
|
|
|
49
49
|
## Exit Codes
|
|
50
50
|
|
|
51
|
-
- `0
|
|
52
|
-
- `2
|
|
51
|
+
- `0`: no issues found
|
|
52
|
+
- `2`: anti-patterns detected
|
|
53
53
|
|
|
54
54
|
## Options
|
|
55
55
|
|
|
@@ -69,8 +69,8 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
69
69
|
|
|
70
70
|
## Part of Impeccable
|
|
71
71
|
|
|
72
|
-
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes
|
|
72
|
+
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 22 steering commands for Claude, Cursor, Gemini, Codex, and more.
|
|
73
73
|
|
|
74
74
|
## License
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
[Apache 2.0](https://github.com/pbakaus/impeccable/blob/main/LICENSE)
|
package/README.npm.md
CHANGED
|
@@ -29,27 +29,27 @@ npx impeccable detect --fast src/
|
|
|
29
29
|
|
|
30
30
|
## What It Detects
|
|
31
31
|
|
|
32
|
-
**AI Slop Tells
|
|
32
|
+
**AI Slop Tells**: patterns that scream "AI generated this":
|
|
33
33
|
- Side-tab accent borders, gradient text on headings
|
|
34
34
|
- Purple/violet gradients and cyan-on-dark palettes
|
|
35
35
|
- Dark mode with glowing accents, border + border-radius clashes
|
|
36
36
|
|
|
37
|
-
**Typography Issues
|
|
37
|
+
**Typography Issues**: overused fonts (Inter, Roboto), flat type hierarchy, single font families
|
|
38
38
|
|
|
39
|
-
**Color & Contrast
|
|
39
|
+
**Color & Contrast**: WCAG AA violations, gray text on colored backgrounds, pure black/white
|
|
40
40
|
|
|
41
|
-
**Layout & Composition
|
|
41
|
+
**Layout & Composition**: nested cards, monotonous spacing, everything-centered layouts
|
|
42
42
|
|
|
43
|
-
**Motion
|
|
43
|
+
**Motion**: bounce/elastic easing, layout property transitions
|
|
44
44
|
|
|
45
|
-
**Quality
|
|
45
|
+
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
46
46
|
|
|
47
47
|
25 detections in total. See the full list at [impeccable.style](https://impeccable.style).
|
|
48
48
|
|
|
49
49
|
## Exit Codes
|
|
50
50
|
|
|
51
|
-
- `0
|
|
52
|
-
- `2
|
|
51
|
+
- `0`: no issues found
|
|
52
|
+
- `2`: anti-patterns detected
|
|
53
53
|
|
|
54
54
|
## Options
|
|
55
55
|
|
|
@@ -69,8 +69,8 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
69
69
|
|
|
70
70
|
## Part of Impeccable
|
|
71
71
|
|
|
72
|
-
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes
|
|
72
|
+
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 22 steering commands for Claude, Cursor, Gemini, Codex, and more.
|
|
73
73
|
|
|
74
74
|
## License
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
[Apache 2.0](https://github.com/pbakaus/impeccable/blob/main/LICENSE)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable
|
|
2
2
|
|
|
3
|
-
The vocabulary you didn't know you needed. 1 skill,
|
|
3
|
+
The vocabulary you didn't know you needed. 1 skill, 21 commands, and curated anti-patterns for impeccable frontend design.
|
|
4
4
|
|
|
5
5
|
> **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles.
|
|
6
6
|
|
|
@@ -12,7 +12,7 @@ Every LLM learned from the same generic templates. Without guidance, you get the
|
|
|
12
12
|
|
|
13
13
|
Impeccable fights that bias with:
|
|
14
14
|
- **An expanded skill** with 7 domain-specific reference files ([view source](source/skills/impeccable/))
|
|
15
|
-
- **
|
|
15
|
+
- **21 steering commands** to audit, review, polish, distill, animate, and more
|
|
16
16
|
- **Curated anti-patterns** that explicitly tell the AI what NOT to do
|
|
17
17
|
|
|
18
18
|
## What's Included
|
|
@@ -31,7 +31,7 @@ A comprehensive design skill with 7 domain-specific references ([view skill](sou
|
|
|
31
31
|
| [responsive-design](source/skills/impeccable/reference/responsive-design.md) | Mobile-first, fluid design, container queries |
|
|
32
32
|
| [ux-writing](source/skills/impeccable/reference/ux-writing.md) | Button labels, error messages, empty states |
|
|
33
33
|
|
|
34
|
-
###
|
|
34
|
+
### 21 Commands
|
|
35
35
|
|
|
36
36
|
| Command | What it does |
|
|
37
37
|
|---------|--------------|
|
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
*
|
|
6
6
|
* Usage:
|
|
7
7
|
* npx impeccable detect [file-or-dir-or-url...]
|
|
8
|
+
* npx impeccable live [--port=PORT]
|
|
9
|
+
* npx impeccable live stop
|
|
8
10
|
* npx impeccable skills help|install|update
|
|
9
11
|
* npx impeccable --help
|
|
10
12
|
*/
|
|
@@ -23,6 +25,7 @@ if (!command || command === '--help' || command === '-h') {
|
|
|
23
25
|
Commands:
|
|
24
26
|
detect [file-or-dir-or-url...] Scan for UI anti-patterns and design quality issues
|
|
25
27
|
live [--port=PORT] Start browser detection overlay server
|
|
28
|
+
live stop Stop a running live server
|
|
26
29
|
skills help List all available skills and commands
|
|
27
30
|
skills install Install impeccable skills into your project
|
|
28
31
|
skills update Update skills to the latest version
|
|
@@ -43,17 +46,18 @@ if (command === '--version' || command === '-v') {
|
|
|
43
46
|
|
|
44
47
|
if (command === 'detect') {
|
|
45
48
|
process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
|
|
46
|
-
const { detectCli } = await import('
|
|
49
|
+
const { detectCli } = await import('../src/detect-antipatterns.mjs');
|
|
47
50
|
await detectCli();
|
|
48
51
|
} else if (command === 'live') {
|
|
49
52
|
process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
|
|
50
|
-
const { liveCli } = await import('
|
|
53
|
+
const { liveCli } = await import('../src/detect-antipatterns.mjs');
|
|
51
54
|
await liveCli();
|
|
52
55
|
} else if (command === 'skills') {
|
|
53
56
|
const { run } = await import('./commands/skills.mjs');
|
|
54
57
|
await run(args.slice(1));
|
|
55
58
|
} else {
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
+
// Default: treat as detect arguments (allow `npx impeccable src/` shorthand)
|
|
60
|
+
process.argv = [process.argv[0], process.argv[1], ...args];
|
|
61
|
+
const { detectCli } = await import('../src/detect-antipatterns.mjs');
|
|
62
|
+
await detectCli();
|
|
59
63
|
}
|
package/package.json
CHANGED
|
@@ -1,29 +1,21 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.7",
|
|
4
4
|
"author": "Paul Bakaus",
|
|
5
|
-
"
|
|
6
|
-
"impeccable": "./bin/impeccable"
|
|
7
|
-
},
|
|
8
|
-
"files": [
|
|
9
|
-
"bin/",
|
|
10
|
-
"lib/download-providers.js",
|
|
11
|
-
"LICENSE"
|
|
12
|
-
],
|
|
13
|
-
"dependencies": {
|
|
14
|
-
"@impeccable/detect": "^2.0.4"
|
|
15
|
-
},
|
|
16
|
-
"description": "Detect UI anti-patterns and design quality issues from the command line",
|
|
5
|
+
"description": "Design skills, commands, and anti-pattern detection for AI coding agents",
|
|
17
6
|
"keywords": [
|
|
18
7
|
"design",
|
|
19
8
|
"frontend",
|
|
20
9
|
"ux",
|
|
10
|
+
"skills",
|
|
11
|
+
"ai",
|
|
21
12
|
"anti-patterns",
|
|
22
13
|
"lint",
|
|
23
14
|
"accessibility",
|
|
24
15
|
"css",
|
|
25
16
|
"html",
|
|
26
|
-
"
|
|
17
|
+
"detection",
|
|
18
|
+
"ci-cd"
|
|
27
19
|
],
|
|
28
20
|
"license": "Apache-2.0",
|
|
29
21
|
"homepage": "https://impeccable.style",
|
|
@@ -34,20 +26,42 @@
|
|
|
34
26
|
"engines": {
|
|
35
27
|
"node": ">=18"
|
|
36
28
|
},
|
|
29
|
+
"type": "module",
|
|
30
|
+
"bin": {
|
|
31
|
+
"impeccable": "bin/cli.js"
|
|
32
|
+
},
|
|
33
|
+
"main": "./src/detect-antipatterns.mjs",
|
|
34
|
+
"exports": {
|
|
35
|
+
".": "./src/detect-antipatterns.mjs",
|
|
36
|
+
"./browser": "./src/detect-antipatterns-browser.js"
|
|
37
|
+
},
|
|
38
|
+
"files": [
|
|
39
|
+
"bin/",
|
|
40
|
+
"src/",
|
|
41
|
+
"LICENSE"
|
|
42
|
+
],
|
|
37
43
|
"scripts": {
|
|
38
|
-
"prepublishOnly": "cp README.md README.bak.md && cp README.npm.md README.md",
|
|
39
|
-
"postpublish": "mv README.bak.md README.md",
|
|
40
44
|
"build": "bun run scripts/build.js",
|
|
45
|
+
"build:browser": "node scripts/build-browser-detector.js",
|
|
46
|
+
"build:extension": "node scripts/build-extension.js",
|
|
41
47
|
"clean": "rm -rf dist build",
|
|
42
48
|
"rebuild": "bun run clean && bun run build",
|
|
43
49
|
"dev": "bun run server/index.js",
|
|
44
50
|
"preview": "bun run build && wrangler pages dev",
|
|
45
51
|
"deploy": "bun run build && wrangler pages deploy build/",
|
|
46
|
-
"test": "bun test tests/build.test.js",
|
|
52
|
+
"test": "bun test tests/build.test.js tests/detect-antipatterns.test.js && node --test tests/detect-antipatterns-fixtures.test.mjs && node --test tests/detect-antipatterns-browser.test.mjs",
|
|
53
|
+
"prepack": "cp README.md README.repo.md && cp README.npm.md README.md",
|
|
54
|
+
"postpack": "cp README.repo.md README.md && rm README.repo.md",
|
|
47
55
|
"screenshot": "bun run scripts/screenshot-antipatterns.js",
|
|
48
56
|
"og-image": "bun run scripts/generate-og-image.js"
|
|
49
57
|
},
|
|
50
|
-
"
|
|
58
|
+
"dependencies": {
|
|
59
|
+
"jsdom": "^29.0.0",
|
|
60
|
+
"marked": "^16.1.0"
|
|
61
|
+
},
|
|
62
|
+
"optionalDependencies": {
|
|
63
|
+
"puppeteer": "^24.39.1"
|
|
64
|
+
},
|
|
51
65
|
"devDependencies": {
|
|
52
66
|
"archiver": "^7.0.1",
|
|
53
67
|
"motion": "^12.38.0",
|