The star history chart in README.md and README.zh.md is currently broken and fails to render because of GitHub stargazer API restrictions. Point the chart and its link to a working endpoint so visitors can still see the project's growth over time.
Clarify that the full repository archive is not a Claude.ai skill upload artifact and direct Claude Code users to the supported Marketplace and CLI installation paths.\n\nCloses #235.
* feat(cli): add --global flag to update command and support --ai universal (#435, #436)
* fix(cli): support dist package.json resolution in update command
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
Added the comparison between Basic and Premium versions to the README. Users were asking about this difference in Issue #156, so I added it here to improve the documentation.
Add README.zh.md with complete Chinese translation
Add language switcher links in both README files
Support for 简体中文 / English bilingual access
Features:
- Full translation of all UI/UX style names and terminology
- Consistent industry-standard Chinese terms (玻璃拟态、粗野主义等)
- Language switcher with flag icons at the top of both files
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>
Add Droid (Factory) references to CLAUDE.md and README.md to match the code changes from dd12a70 (feat: add Droid (Factory) support).
CLAUDE.md:
- Add .factory/skills/ui-ux-pro-max/ to architecture diagram
- Add .factory/ to symlinks description in Sync Rules
README.md:
- Add 'uipro init --ai droid' to CLI installation commands
- Add Droid (Factory) to Skill Mode supported platforms list
- Add .factory/skills/ path note for design system commands
- Add .factory/ to platform-specific files list in Architecture section
- Add .factory/ to contributor structure overview
- Remove .shared folder dependency - all platforms now self-contained
- Each platform installation includes its own data/ and scripts/
- Update platform configs: reference → full install type
- Simplify template.ts: remove ensureSharedExists logic
- Update Cursor to Skill Mode (auto-activate)
- Update README to reflect Cursor in Skill Mode
- Bump CLI version to 2.2.2
Fixes issue where users couldn't find search.py in shared folder.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Explain:
- Restructured codebase uses template-based generation
- Users should always use CLI to install
- Contributors: clone repo, make changes in src/, sync to CLI, test locally
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Remove Manual Installation section from README
- Add 67 styles table with # | Style | Best For format
- Update Supported Stacks table with all 13 stacks
- Simplify Usage section: group by Skill mode vs Workflow mode
- Fix counts: 57 font pairings (was 56), 99 UX guidelines (was 98)
- Change Windsurf from Workflow to Skill mode
- Update CLAUDE.md: remove prompt domain, add missing stacks
- Bump CLI version to 2.2.1
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
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>
- Add --persist flag to save design system to design-system/MASTER.md
- Add --page flag to create page-specific override files in design-system/pages/
- MASTER.md includes hierarchical override logic header, color palette, typography, spacing, shadows, component specs, and anti-patterns
- Page override files are templates for documenting deviations from Master
- Updated documentation for all AI assistants (Claude, Cursor, Windsurf, Kiro, Qoder, Roo)
- Updated README.md with usage examples
This enables persistent design context across chat sessions using a 'Master + Overrides' pattern where page-specific rules override the global design system.
- Add Conversion and CTA placement details
- Add numbered Sections list
- Add Style keywords, Best For, Performance/Accessibility
- Add color names and Notes
- Add Typography Mood, Best For, Google Fonts
- Add Pre-Delivery Checklist (7 items)
- Fix ASCII box alignment for consistent right border
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
## Major Features
- Add --design-system flag for AI-powered design recommendations
- 100 industry-specific reasoning rules in ui-reasoning.csv
- Multi-domain parallel search (product, style, color, landing, typography)
- Anti-patterns to avoid for each industry
## New Files
- data/ui-reasoning.csv - 100 UI category rules with style priority, effects, anti-patterns
- scripts/design_system.py - Reasoning engine with BM25 ranking
## Workflow Updates
- All agent workflows updated with new design system generation step
- Step 2 now requires --design-system for comprehensive recommendations
- Updated example workflow with beauty spa case study
## CLI Updates
- Version bumped to 2.0.0
- Added Qoder and Roo Code support
- Synced all agent folders to cli/assets/
## README Updates
- Added version badges and PayPal donation button
- New "What's New in v2.0" section with architecture diagram
- Updated CLI installation instructions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add GitHubRateLimitError and GitHubDownloadError for better error handling
- Detect rate limits (403 with remaining=0, 429)
- Try downloading from GitHub releases first
- Fall back to bundled assets on network error, rate limit, or download failure
- Add --offline flag to skip GitHub download
- Use GitHub auto-generated archive URL as fallback when no ZIP asset exists
- Update CLI to v1.9.0
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* feat(trae): add support for Trae AI assistant
Add Trae as a new supported AI assistant with version bump to 1.7.0. Includes:
- New .trae folder for skill files
- Updated CLI to detect and copy Trae skill files
- Added Trae to AIType enum and documentation
- Implemented search functionality for Trae-specific queries
- Added Trae skill data and scripts
* feat: update trae skill documentation and readme example
- Refactor SKILL.md to improve clarity and organization
- Add explicit usage instructions and prerequisites
- Update README.md example to clarify frontend-only scope
---------
Co-authored-by: Alex Le <alex.le@bytedance.com>
* feat: add CodeX support
* fix: ensure Codex detection in detectAIType function
* feat: Add UI/UX Pro Max search engine and guidelines
- Introduced a new CSV file containing UX guidelines for various categories, issues, and best practices.
- Implemented a BM25 search engine in core.py to facilitate searching through style guides and UX guidelines.
- Created a search script (search.py) for command-line usage, allowing users to query the guidelines with options for domain and stack-specific searches.
- Added functionality to format search results for better readability and usability.
* feat: Add UI/UX Pro Max search engine and guidelines
- Introduced a new CSV file containing UX guidelines for various categories, issues, and best practices.
- Implemented a BM25 search engine in core.py to facilitate searching through style guides and UX guidelines.
- Created a search script (search.py) for command-line usage, allowing users to query the guidelines with options for domain and stack-specific searches.
- Added functionality to format search results for better readability and usability.
* fix: update script paths in SKILL.md for Codex search functionality
---------
Co-authored-by: Viet Tran <viettranx@gmail.com>
