Add ten sourced guidelines for web maps (MapLibre, Mapbox GL, Leaflet,
OpenLayers) to ux-guidelines.csv, rows 121-130:
- Map Attribution Visible (Critical)
- Map Text Alternative (Critical)
- Map Keyboard and Non-Drag Navigation (High)
- Map Symbology Not Color Alone (High)
- Normalized Choropleth Map (High)
- Perceptual Map Color Ramps (High)
- Safe Map Popup Content (High)
- Cluster Dense Map Points (Medium)
- Large Geodata as Vector Tiles (Medium)
- Map Camera Reduced Motion (Medium)
The Geographic Data chart row now asks for normalized choropleths,
proportional symbols for totals, colorblind-safe ramps and visible
attribution. Provenance records cite OSMF, Mapbox, MapLibre, Leaflet,
W3C WCAG 2.2, ColorBrewer, Esri, NASA Earth Observatory and OWASP; the
map publishers are added to the official source hosts.
Generic queries ("color alone", "keyboard navigation", "reduced motion",
"dragging movements") still return the generic rows first; relevance
metrics are unchanged. UX guideline count 120 -> 130.
Distilled from the MIT-licensed gis-ui-ux-pro skill.
Co-authored-by: Khanhle19 <201531944+Khanhle19@users.noreply.github.com>
Claude Website Design Stack
A ready-to-clone Claude Code project that makes the agent genuinely good at website design — not by hoping for better output, but by wiring in the three things generic AI design is missing: a knowledge layer, a taste layer, and a visual feedback layer.
Most AI design fails because the model never sees what it built and has no opinionated point of view. This repo fixes both: Claude plans with a real design database, commits to a distinctive aesthetic, then opens the page in a browser and iterates on what it sees — and self-reviews against WCAG AA before finishing.
The stack
| Layer | Tool | What it adds |
|---|---|---|
| 🧠 Knowledge | ui-ux-pro-max |
80 searchable UI styles, 192 color palettes, 74 font pairings, 130 UX rules, Core Web Vitals, 22 stacks — searchable, turned into a concrete design system |
| 🎨 Taste | frontend-design (official Anthropic) |
Forces a real aesthetic commitment before any CSS; kills "AI slop" defaults |
| 🧩 Components | shadcn MCP |
Search/add production components by natural language |
| 👁️ Visual feedback | @playwright/mcp + chrome-devtools-mcp |
Claude opens a real browser, screenshots, reads the console, exercises states, and fixes what it sees |
| ✅ Automated review | design-review subagent + /design-review |
7-phase audit across viewports: WCAG AA, responsive, interaction states |
Quickstart
# 1. Clone and enter
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill/stack
# 2. Install the skills/plugins + Playwright browser
./scripts/setup.sh
# 3. Open Claude Code — the MCP servers and CLAUDE.md workflow load automatically
claude
Then just ask for UI work. Claude will plan → commit to a look → build → screenshot and
iterate → run /design-review. See docs/WORKFLOW.md for a full walkthrough.
Try it in 30 seconds
> Build a pricing section for a developer tool. Plan it with ui-ux-pro-max,
> commit to a distinctive look, then screenshot it at mobile and desktop and fix any issues.
What's in here
.
├── .mcp.json # Playwright + Chrome DevTools + shadcn MCP servers
├── CLAUDE.md # The design loop Claude follows (the "brain")
├── .claude/
│ ├── settings.json # Enables the MCP servers + safe permissions
│ ├── agents/design-review.md # 7-phase design-review subagent
│ └── commands/
│ ├── design-review.md # /design-review — audit a URL/page
│ └── design-plan.md # /design-plan — generate a design system first
├── scripts/
│ ├── setup.sh # Installs skills/plugins + Playwright chromium
│ └── design-audit.mjs # Standalone multi-viewport screenshot + heuristic audit
├── .github/workflows/
│ └── design-review.yml # Runs the audit on every PR that touches UI
├── docs/
│ ├── STACK.md # Why each tool is in the stack
│ ├── SETUP.md # Install details + optional add-ons (Figma, Magic)
│ └── WORKFLOW.md # End-to-end worked example
└── examples/juniper-audit/ # Real audit run against a production site
Standalone audit (no MCP needed)
The same checks are available as a plain script for local runs and CI:
node scripts/design-audit.mjs --url http://localhost:3000 --out audit-output
# or audit a static file
node scripts/design-audit.mjs --file ./index.html
It screenshots 7 viewport tiers (360 → 1920 px) and reports heuristic findings
(horizontal overflow, missing focus styles, unsized media, contrast risks, tap-target size).
See examples/juniper-audit/ for a real report.
Requirements
- Node 18+ and Python 3.x
- Claude Code with plugins enabled (
/plugin)
License
MIT. The bundled tools keep their own licenses — see docs/STACK.md for links.
Built as a starter for teams who want Claude Code to ship distinctive, accessible, production-grade web UI instead of generic AI output.