Map products had no matching product type: "GIS dashboard web map"
routed to Analytics Dashboard, "geospatial analytics platform" to
Podcast Platform, and "satellite imagery earth observation viewer"
returned nothing, so --design-system fell back to a landing-page
pattern for a map tool.
Add two product types with matching rows in products.csv, colors.csv
and ui-reasoning.csv (No 193-194):
- GIS / Web Map Dashboard: map-first layout with layer panel and linked
list, muted basemap, one UI accent, colorblind-safe data ramps.
- Earth Observation / Satellite Imagery Viewer: imagery-first layout,
neutral dark-grey chrome so imagery colors read true, date timeline,
before/after compare, perceptual index ramps.
Reasoning rows require map attribution, a legend and a text
alternative, and list rainbow ramps, hidden attribution, glass panels
over the map and raw-count choropleths as anti-patterns, in line with
the Maps rows in ux-guidelines.csv. Color tokens pass the existing
contrast contract. Provenance records cover both reasoning rows.
The product, palette and reasoning sets grow from 192 to 194, so the
row-count contract in validate_data.py, test_data_contracts.py and the
published counts move to 194. Neighbouring product queries (analytics
dashboard, delivery tracking, public transit, drone fleet, podcast
platform) keep their product type; relevance metrics are unchanged.
Co-authored-by: Khanhle19 <201531944+Khanhle19@users.noreply.github.com>
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>
* test: verify IME retrieval and Enter shortcut example
* test: verify IME retrieval and Enter shortcut example
* docs: explain IME-safe Enter shortcuts and verification
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in .claude/skills/ui-ux-pro-max/SKILL.md
* chore: update UX guideline count in .claude/skills/ui-ux-pro-max/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in README.ko.md
* chore: update UX guideline count in README.md
* chore: update UX guideline count in README.zh.md
* chore: update UX guideline count in cli/assets/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in cli/assets/templates/platforms/agent.json
* chore: update UX guideline count in cli/assets/templates/platforms/amazonq.json
* chore: update UX guideline count in cli/assets/templates/platforms/augment.json
* chore: update UX guideline count in cli/assets/templates/platforms/autoclaw.json
* chore: update UX guideline count in cli/assets/templates/platforms/claude.json
* chore: update UX guideline count in cli/assets/templates/platforms/codebuddy.json
* chore: update UX guideline count in cli/assets/templates/platforms/codewhale.json
* chore: update UX guideline count in cli/assets/templates/platforms/codex.json
* chore: update UX guideline count in cli/assets/templates/platforms/continue.json
* chore: update UX guideline count in cli/assets/templates/platforms/copilot.json
* chore: update UX guideline count in cli/assets/templates/platforms/cursor.json
* chore: update UX guideline count in cli/assets/templates/platforms/droid.json
* chore: update UX guideline count in cli/assets/templates/platforms/gemini.json
* chore: update UX guideline count in cli/assets/templates/platforms/kilocode.json
* chore: update UX guideline count in cli/assets/templates/platforms/kimi.json
* chore: update UX guideline count in cli/assets/templates/platforms/kiro.json
* chore: update UX guideline count in cli/assets/templates/platforms/openclaw.json
* chore: update UX guideline count in cli/assets/templates/platforms/opencode.json
* chore: update UX guideline count in cli/assets/templates/platforms/qoder.json
* chore: update UX guideline count in cli/assets/templates/platforms/roocode.json
* chore: update UX guideline count in cli/assets/templates/platforms/trae.json
* chore: update UX guideline count in cli/assets/templates/platforms/universal.json
* chore: update UX guideline count in cli/assets/templates/platforms/warp.json
* chore: update UX guideline count in cli/assets/templates/platforms/windsurf.json
* chore: update UX guideline count in cli/assets/templates/platforms/zcode.json
* chore: update UX guideline count in src/ui-ux-pro-max/data/catalog-summary.json
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/agent.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/amazonq.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/augment.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/autoclaw.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/claude.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codebuddy.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codewhale.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/codex.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/continue.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/copilot.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/cursor.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/droid.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/gemini.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kilocode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kimi.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/kiro.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/openclaw.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/opencode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/qoder.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/roocode.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/trae.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/universal.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/warp.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/windsurf.json
* chore: update UX guideline count in src/ui-ux-pro-max/templates/platforms/zcode.json
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in README.az.md
* chore: update UX guideline count in README.id.md
* chore: update UX guideline count in README.ja.md
* chore: update UX guideline count in README.vi.md
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* test: align platform query contract with UX count
* docs: explain IME-safe Enter shortcuts and verification
* chore: update UX guideline count in skill.json
* docs: record official sources for IME guidance
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* chore: update UX guideline count in stack/README.md
* chore: update UX guideline count in stack/docs/STACK.md
* feat: add IME composition Enter guidance
* docs: include IME Enter guidance in quick reference
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* docs: include IME Enter guidance in quick reference
* test: align platform query contract with UX count
* docs: explain IME-safe Enter shortcuts and verification
* feat: add IME composition Enter guidance
* chore: refresh runtime fingerprint for IME guidance
* test: verify IME retrieval and Enter shortcut example
* docs: include IME Enter guidance in quick reference
* feat(data): add rtl_level to styles and products
Classify every style and product row for right-to-left interfaces:
full (mirrors unchanged), partial (mirrors with per-component work),
caveats (layout encodes reading direction).
One column is appended per row; existing fields, column order and LF
line endings are untouched. Mirrors under cli/assets and .claude are
synced with npm run sync:assets.
* feat(search): add --rtl filter to style and product searches
search() accepts rtl="all|full|partial|caveats" and projects the new
rtl_level column, so filtered rows still carry their compatibility
level. Without that projection the filter saw None and dropped every
row, which is what broke the earlier attempt.
The filter runs after BM25 scoring but before max_results truncation.
Filtering the corpus before indexing shifted IDF and made calibrated
searches abstain incorrectly (dashboard --domain style --rtl=partial
returned nothing); scoring first keeps the corpus and thresholds
stable while still preventing -n 1 from hiding a matching row.
--rtl requires an explicit style/product domain, and is rejected with
--design-system and --stack.
relevance thresholds: runtimeFingerprint refreshed; every metric is
identical to the committed baseline.
* test: cover rtl data contract and filter ordering
Pin the behaviour the RTL filter depends on:
- rtl_level is projected, not a search signal;
- every row in both CSVs carries a supported level;
- known layouts keep their curated level;
- filtering happens before max_results truncation (saas --domain
product -n 1 with --rtl=full returns Micro SaaS, while the unfiltered
top hit is a partial row);
- omitting --rtl keeps previous results;
- unsupported domains raise ValueError and exit non-zero through the
CLI.
* docs: document the rtl compatibility filter
Explain the three levels, the CLI flag and its domain restriction in
the README, CLAUDE.md, the generated skill content and the
hand-authored Claude skill. The agent guidance tells the skill to add
--rtl for Arabic, Hebrew, Persian and Urdu work and to respect the
returned level instead of silently mirroring a caveats layout.
* Add Nuxt UI 4.12.0 guidance
Add rows 77-83 to the nuxt-ui stack:
- UChart usage, categories and colors, donut data shape
- UApp automatic locale with @nuxtjs/i18n
- UCheckboxGroup max and UFileUpload reject event
- Security upgrade note for 4.11.3 (set/setAtPath prototype
pollution, ChatPrompt GET leak)
Existing rows are unchanged. Mirrored copies synced with
npm run sync:assets.
* Fix Nuxt UI 4.12.0 data gate
Move the nuxt-ui current target from 4.11.1 to 4.12.0 so the new rows
pass validation:
- Update the pin in core.py and test_web_stack_freshness.py.
- Retag the 76 existing rows to nuxt-ui 4.12.0. Verified At stays
unchanged. The 4.11.2 to 4.12.0 release notes list no breaking
changes.
- Use an official ui.nuxt.com URL for row 83 (High severity).
- Regenerate catalog-summary.json for the new row count.
- Refresh the relevance threshold runtimeFingerprint. Relevance
metrics are identical to the committed baseline.
The Three.js stack claims `threejs 0.185.1` but several rows still
recommend APIs that 0.185.1 deprecates and warns about at runtime:
- THREE.Clock (deprecated since r183) -> THREE.Timer with
timer.update(timestamp) once per frame, getDelta()/getElapsed(),
and timer.connect(document) to avoid a huge delta after a hidden tab.
Rows 13, 31, 34, 45. Row 45 also stops calling getElapsedTime()
per vertex (Clock.getElapsedTime() calls getDelta() internally).
- THREE.PCFSoftShadowMap (deprecated since r182, WebGLShadowMap warns
and falls back to PCFShadowMap) -> PCFShadowMap, with shadow.radius /
VSMShadowMap noted for softer edges. Rows 22, 23.
- GLTFLoader imported from three/examples/jsm -> three/addons, matching
the rest of the file. Row 52.
Bump Verified At on touched rows, extend the freshness test's
forbidden-token list (three.clock, clock.getdelta,
clock.getelapsedtime, pcfsoftshadowmap, three/examples/jsm/) and add a
positive Timer lookup, refresh the relevance runtime fingerprint and
baseline, and re-sync mirrored assets.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Reverify the full stack catalog against Nuxt UI 4.11.1 and correct stale API examples. Add Splitter, ProgressGroup, motion, Vite detection, and CommandPalette security guidance.
Co-authored-by: Ray <ray.tien@cloudeep.com.tw>
Squash-merged by github-maintain cron after maintainer approval (review 2026-06-20 by @mrgoonie) and conflict resolution (rebase to head 4bd45ba5, all checks green).
* fix(data): regenerate stale catalog-summary snapshot hashes
catalog-summary.json was not regenerated after google-fonts.csv,
google-font-licenses.json, icons.csv and phosphor-icons-upstream.json
changed, so `npm --prefix cli run verify:data` fails on a clean
checkout of main:
validate:semantic 4 stale snapshot errors
validate:catalog-summary "catalog-summary.json is stale"
test:python 1 failure / 153
check:assets 2 files out of sync
Regenerated with the existing --verified-at 2026-08-26: only the four
sha256 fields change. The date is a human attestation that the font
catalog was checked against the upstream google/fonts repository, so it
is deliberately left untouched -- no such verification was performed
here.
verify:data now exits 0.
Note: prepublishOnly runs sync:assets before verify:data, which
regenerates the snapshot at publish time. That is why released packages
are unaffected and the drift stayed invisible on main.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015UidECV1wVBD8SW6Abuj71
* fix(data): make catalog snapshot hashes line-ending independent
Root cause of the stale snapshot restored in the previous commit.
bd19ab9 (#462) regenerated catalog-summary.json from a CRLF checkout.
Every recorded sha256 was the CRLF hash of its source file, so the
check failed on every LF platform. The four committed values are
exactly sha256(crlf_bytes):
google-fonts.csv committed d03194d2… = CRLF hash
google-font-licenses.json committed 7c35e410… = CRLF hash
icons.csv committed 272ccf0e… = CRLF hash
phosphor-icons-upstream.json committed 81c37fb3… = CRLF hash
Two conditions had to combine: the digest hashed raw bytes, and no
.gitattributes pinned these files to LF, so Windows checkouts get CRLF
by default. Restoring the hashes alone would let the next contributor
on Windows reproduce the same commit.
Three changes:
- normalize line endings in generate-catalog-summary.py's digest(), so
the snapshot no longer depends on the checkout
- apply the same normalization in validate_data.py, which independently
recomputes the hashes and has to agree with the generator
- add .gitattributes pinning src/ui-ux-pro-max/data/*.{csv,json} to LF,
so a Windows checkout matches the committed bytes in the first place
sync-assets.mjs already normalizes to LF, so this only extends an
existing project convention to the two places that were missing it.
Adds test_catalog_summary_line_endings.py: LF and CRLF inputs must
digest identically, the committed snapshot must match the normalized
sources, and a simulated CRLF checkout must still produce the recorded
hashes. The third case fails against the pre-fix digest.
verify:data exits 0; the Python suite goes from 153 to 156 tests.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015UidECV1wVBD8SW6Abuj71
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Merged by github-maintain cron. Approved by @clark-cant and @jizc. Pre-existing pytest failure on main (ui-styling/shadcn test) is unrelated to PR scope.
Addresses the behavioral patterns that plausibly triggered the Gen
(Agent Trust Hub) High Risk rating on skills.sh, without changing
runtime functionality:
- Prerequisites no longer instruct agents to run sudo/brew/apt/winget
install commands; agents must ask the user to install Python instead
(SKILL.md, skill-content.md template, README.md, README.zh.md)
- Soften coercive invocation language ("Must Use" -> "Primary Use
Cases") and replace keyword-stuffed frontmatter descriptions with
factual ones (SKILL.md, quick-reference.md, claude/droid.json,
plugin.json)
- Remove design.csv, draft.csv and _sync_all.py: unused by the runtime
(not registered in core.py CSV_CONFIG) and containing prompt-shaped
"System Prompt: ... You are ..." blocks that read as injection risk
- Fix path traversal in --persist: new safe_slug() restricts project
and page names to [a-z0-9_-], so ../ in -p/--page can no longer
escape the design-system/ output folder
Verified: validate-csv.py (35 files), smoke-domains (12/12),
smoke-stacks (22/22), check:assets in sync, persist traversal attempt
stays confined.
Co-authored-by: Andras Polgar <5525341+ruredi@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
- add CSV structural validation and all-domain smoke tests
- repair malformed CSV rows in source and bundled CLI assets
- run data validation in CI and prepublish checks
- add npm build wrapper with TypeScript fallback when Bun is unavailable
- fix CLI asset resolution for TypeScript fallback builds
cli/assets had fallen out of sync with src/ui-ux-pro-max ahead of this
change (unrelated to the motion-domain feature) - colors.csv, products.csv,
google-fonts.csv, draft.csv, several platform templates, and sub-skill
scripts/tests had all drifted. Ran the project's own `sync-assets.mjs`
to bring cli/assets back in line with the source of truth per the
documented Sync Rules; `--check` now reports assets as in sync.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds a new searchable `motion` domain (motion.csv, 16 GSAP animation
skeletons across hover/scroll-reveal/stagger/page-transition/parallax/
loading, each tagged Subtle/Standard/Complex) plus three optional 1-10
dials on `--design-system` — --variance, --motion, --density — inspired
by taste-skill's DESIGN_VARIANCE/MOTION_INTENSITY/VISUAL_DENSITY sliders.
- --variance biases style search/selection toward centered-minimal (low)
or bold-asymmetric (high) categories
- --motion attaches a matching GSAP snippet (code + framework notes +
do/don't) from motion.csv
- --density overrides the --space-* token scale in ASCII/markdown/MASTER.md
output (spacious <-> dense/dashboard)
All three dials are optional and additive; output with no dials set is
byte-identical to before (verified via regression diff). Synced into
.claude/skills/ui-ux-pro-max and cli/assets alongside src/ui-ux-pro-max
(source of truth) so all three installed copies stay consistent.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds WPF, WinUI 3, UWP, Avalonia, and Uno Platform stacks (17 -> 22 total),
each with its own guidelines CSV, registered in core.py and synced to cli/assets.
- New stack CSVs in src/ and cli/assets/data/stacks/
- search.py / core.py registry updated
- smoke-stacks.sh: EXPECTED_STACK_COUNT 21 -> 22 with a smoke-test workflow
- platform template descriptions and README bumped to 22 technology stacks
* fix CLI asset sync
* fix(cli): normalize line endings in asset sync/check
check:assets hashed raw bytes, so identical CSV/JSON/py content with
CRLF vs LF (git autocrlf on checkout) was reported as stale drift,
blocking the release guard on Windows/mixed checkouts.
- fileHash now normalizes CRLF->LF before hashing, so check:assets
compares content, not line endings.
- sync:assets writes LF-normalized copies instead of a raw byte copy,
so re-syncing is deterministic across platforms.
All synced assets are text (csv/json/md/py); no binaries affected.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* ci: enforce CLI asset sync on PRs
Adds a Check asset sync workflow that runs `npm run check:assets` on any
PR touching src/ui-ux-pro-max/** or cli/assets/**, so the bundled CLI
assets can't silently drift from the source of truth.
The check uses only node builtins (no install step) and normalizes
line endings before hashing, so it hard-fails on real content drift
without the CRLF/LF soft-fail hack other approaches needed.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Breaking changes fixed:
- Row 8/9: icon format corrected from 'lucide:home' (v3) to 'i-lucide-home' (v4 Iconify i-prefix)
- Row 18: useOverlay API updated from .open(Component, {props}) to .create(Component).open({props})
New v4 guidelines added (rows 51-70):
- Auto-registered modules: do not re-add @nuxt/icon @nuxt/fonts @nuxtjs/color-mode
- Official nuxi init templates for project bootstrapping
- Local Iconify JSON install for SSR reliability
- Global icon overrides via appConfig.ui.icons
- New form components: UFileUpload, UInputDate, UInputTags, UColorPicker
- New data components: UTree, UMarquee
- UContextMenu for right-click menus
- Awaiting overlay result Promise for confirmation dialogs
- UCommandPalette grouped items and extractShortcuts
- UHeader/UFooter/UPageAside layout components
- ClientOnly pattern for color mode hydration safety
- Generated theme file (.nuxt/ui/) for slot discovery
- defineShortcuts whenever condition guard
- UApp locale prop for i18n (50+ built-in locales)
Sync cli/assets to match src.
- Merged STACK_CONFIG: kept main's full stack list + added angular & laravel from PR
- Updated platform templates: 161 palettes, 16 stacks across all descriptions
- Listed all 16 stacks in claude.json frontmatter description
BREAKING CHANGES:
- Moved canonical data/scripts to src/ui-ux-pro-max/
- Removed duplicate folders (.codex/, .gemini/, .trae/, .codebuddy/, .continue/, skills/, .qoder/)
- CLI now uses template system instead of copying pre-built folders
New features:
- Merged prompts.csv into styles.csv with 4 new columns:
- AI Prompt Keywords
- CSS/Technical Keywords
- Implementation Checklist
- Design System Variables
- All 67 styles now have complete prompt data
- Added Astro stack (53 guidelines)
- Added 10 new 2025 UI trend styles
CLI changes:
- New template rendering system (cli/src/utils/template.ts)
- Reduced cli/assets from ~34MB to ~564KB
- Assets now contain only: data/, scripts/, templates/
File structure:
- src/ui-ux-pro-max/ - Single source of truth
- .claude/skills/ - Symlinks to src/ for development
- .shared/ - Symlink to src/ui-ux-pro-max/
Bumped CLI version: 2.1.3 → 2.2.0
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>