Compare commits

..
4 Commits
Author SHA1 Message Date
Duy /zuey/ cc3d1be743 fix(cli): publish under fallback npm package (#393) 2026-06-26 11:02:09 +07:00
Alexander 318e0b2e40 fix(cli): use npm-canonical bin path so the uipro command survives publish (#392)
The bin mapping was "./dist/index.js". On publish, npm normalizes bin
values and the leading ./ triggers a warning -- on the npm version in the
release runner it reports `bin[uipro] script name dist/index.js was
invalid and removed`, i.e. the published package ships with no `uipro`
command, so `npx uipro-cli init` would not work even once publishing
succeeds (see #353).

Change the value to the canonical `dist/index.js` (exactly what
`npm pkg fix` produces). src/index.ts already has the
`#!/usr/bin/env node` shebang, which bun build preserves, so the bin is
executable.

Verified: `npm publish --dry-run` no longer emits the bin warning, and
dist/index.js is included in the tarball; typecheck passes.

Addresses the package-metadata half of #353. Actually landing on npm
still requires a release run with a token that has publish rights for
uipro-cli.
2026-06-25 20:17:09 +07:00
Alexander d86f44368d fix(scripts): force UTF-8 stdout/stderr in design_system.py on Windows (#390)
design_system.py prints box-drawing characters and swatches (--, OK marks,
block swatches), but unlike search.py it never reconfigured stdout. On a
non-UTF-8 Windows console (cp1252/gbk) running the CLI crashes with
UnicodeEncodeError, the same failure reported in #112 for search.py.

Mirror the wrapper search.py already uses: re-wrap stdout/stderr in a
UTF-8 TextIOWrapper when the console encoding is not UTF-8. Applied to
the source of truth and the synced cli/assets copy.

Verified: the CLI runs clean under PYTHONIOENCODING=cp1252 (exit 0, no
UnicodeEncodeError) while still emitting the box/swatch output;
check:assets passes.

Related to #112 (search.py is already fixed on main; this covers the
remaining design_system.py instance).
2026-06-25 18:30:49 +07:00
Alexander 7d62cd093b fix(manifests): correct style/font-pairing/stack counts (#289) (#391)
The marketplace-facing manifests understated the catalog. Actual data:
84 styles (styles.csv), 73 font pairings (typography.csv), and 17 stacks
(data/stacks/*.csv), but plugin.json, marketplace.json, and skill.json
all claimed 67 styles / 57 font pairings / 15 stacks.

Update the three manifests to 84 / 73 / 17, and extend the stack
enumeration to the full 17 (adding Angular, Laravel, JavaFX, Three.js,
and Nuxt UI). Palettes (161) and charts (25) were already correct.

Resolves the count-drift finding in #289 (supersedes the stuck #282 and
#329, which only partially corrected the numbers).
2026-06-25 18:16:15 +07:00
14 changed files with 53 additions and 33 deletions
+2 -2
View File
@@ -5,14 +5,14 @@
"name": "nextlevelbuilder"
},
"metadata": {
"description": "UI/UX design intelligence skill with 67 styles, 161 palettes, 57 font pairings, 25 charts, and 15 stack guidelines",
"description": "UI/UX design intelligence skill with 84 styles, 161 palettes, 73 font pairings, 25 charts, and 17 stack guidelines",
"version": "2.6.2"
},
"plugins": [
{
"name": "ui-ux-pro-max",
"source": "./",
"description": "Professional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and Jetpack Compose.",
"description": "Professional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, and Three.js.",
"version": "2.6.2",
"author": {
"name": "nextlevelbuilder"
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence. 67 styles, 161 palettes, 57 font pairings, 25 charts, 15 stacks (React, Next.js, Vue, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Nuxt, Jetpack Compose). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.",
"description": "UI/UX design intelligence. 84 styles, 161 palettes, 73 font pairings, 25 charts, 17 stacks (React, Next.js, Vue, Nuxt.js, Nuxt UI, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, Three.js). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.",
"version": "2.6.2",
"author": {
"name": "nextlevelbuilder"
+1 -1
View File
@@ -42,7 +42,7 @@ src/ui-ux-pro-max/ # Source of Truth
├── base/ # Base templates (skill-content.md, quick-reference.md)
└── platforms/ # Platform configs (claude.json, cursor.json, ...)
cli/ # CLI installer (uipro-cli on npm)
cli/ # CLI installer (ui-ux-pro-max-cli on npm)
├── src/
│ ├── commands/init.ts # Install command with template generation
│ └── utils/template.ts # Template rendering engine
+2 -2
View File
@@ -51,7 +51,7 @@ ui-ux-pro-max-skill/
│ ├── data/ # CSV databases (styles, colors, typography, rules)
│ ├── scripts/ # Python search engine & design system generator
│ └── templates/ # Platform-specific skill templates
├── cli/ # npm CLI installer (uipro-cli)
├── cli/ # npm CLI installer (ui-ux-pro-max-cli)
├── .claude/ # Local dev/test files for Claude Code
├── .factory/ # Local dev/test files for Droid (Factory)
├── docs/ # Documentation
@@ -140,7 +140,7 @@ Types:
feat: add Skeuomorphism 2.0 style to general styles
fix: correct color palette for fintech industry rule
docs: translate README to Spanish
chore: update uipro-cli to v2.6.0
chore: update ui-ux-pro-max-cli to v2.6.0
```
---
+13 -11
View File
@@ -9,8 +9,8 @@
</p>
<p align="center">
<a href="https://www.npmjs.com/package/uipro-cli"><img src="https://img.shields.io/npm/v/uipro-cli?style=flat-square&logo=npm&label=CLI" alt="npm"></a>
<a href="https://www.npmjs.com/package/uipro-cli"><img src="https://img.shields.io/npm/dm/uipro-cli?style=flat-square&label=downloads" alt="npm downloads"></a>
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/v/ui-ux-pro-max-cli?style=flat-square&logo=npm&label=CLI" alt="npm"></a>
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/dm/ui-ux-pro-max-cli?style=flat-square&label=downloads" alt="npm downloads"></a>
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/stargazers"><img src="https://img.shields.io/github/stars/nextlevelbuilder/ui-ux-pro-max-skill?style=flat-square&logo=github" alt="GitHub stars"></a>
<a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Support%20Development-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal"></a>
</p>
@@ -266,7 +266,7 @@ Install directly in Claude Code with two commands:
```bash
# Install CLI globally
npm install -g uipro-cli
npm install -g ui-ux-pro-max-cli
# Go to your project
cd /path/to/your/project
@@ -293,6 +293,8 @@ uipro init --ai augment # Augment
uipro init --ai all # All assistants
```
The npm package is `ui-ux-pro-max-cli`; it still installs the `uipro` command. Older `uipro-cli` releases are stale and should not be used for current assets.
### Global Install (Available for All Projects)
```bash
@@ -464,7 +466,7 @@ The codebase has been restructured to use a **template-based generation system**
**Always use the CLI to install:**
```bash
npm install -g uipro-cli
npm install -g ui-ux-pro-max-cli
uipro init --ai <platform>
```
@@ -524,16 +526,16 @@ Use these commit types for correct version bumps:
- `feat:` -> minor release
- `feat!:` or `BREAKING CHANGE:` -> major release
The release workflow only needs the default `GITHUB_TOKEN`; it does not publish to npm.
The release workflow uses the default `GITHUB_TOKEN` for GitHub releases and the repository `NPM_TOKEN` secret to publish `ui-ux-pro-max-cli` to npm.
## Troubleshooting
### `uipro: unknown command 'uninstall'` or `unknown command 'update'`
Your installed version of `uipro-cli` is outdated. Update it and retry:
Your installed version of `ui-ux-pro-max-cli` is outdated. Update it and retry:
```bash
npm install -g uipro-cli@latest
npm install -g ui-ux-pro-max-cli@latest
uipro uninstall
```
@@ -561,20 +563,20 @@ rm -rf .agents/skills/ui-ux-pro-max # Antigravity
This is a known issue with versions prior to v2.5.1. The repository used symlinks internally which some installation tools can't handle. **Fix:** use the CLI installer instead:
```bash
npm install -g uipro-cli
npm install -g ui-ux-pro-max-cli
uipro init --ai claude
```
Or wait for the next release where this is resolved.
### `npm install -g uipro-cli` fails with permission error
### `npm install -g ui-ux-pro-max-cli` fails with permission error
```bash
# macOS/Linux — use a Node version manager (recommended) or sudo
sudo npm install -g uipro-cli
sudo npm install -g ui-ux-pro-max-cli
# Or use npx without installing globally
npx uipro-cli init --ai claude
npx ui-ux-pro-max-cli init --ai claude
```
### Python not found when running design system commands
+3 -3
View File
@@ -1,11 +1,11 @@
# uipro-cli
# ui-ux-pro-max-cli
CLI to install UI/UX Pro Max skill for AI coding assistants.
## Installation
```bash
npm install -g uipro-cli
npm install -g ui-ux-pro-max-cli
```
## Usage
@@ -70,7 +70,7 @@ uipro update # updates the global CLI to the latest release
uipro init --ai codex --force # regenerate skill files from the new package
```
`uipro update` runs `npm install -g uipro-cli@latest` for you (it shells out to `npm` only on Windows, where `npm` is a `.cmd`). You can still run that command manually if you prefer. When the CLI is already current, `uipro update` just refreshes the installed skill files.
`uipro update` runs `npm install -g ui-ux-pro-max-cli@latest` for you (it shells out to `npm` only on Windows, where `npm` is a `.cmd`). You can still run that command manually if you prefer. When the CLI is already current, `uipro update` just refreshes the installed skill files.
## Development
+8
View File
@@ -16,10 +16,18 @@ Usage:
import csv
import json
import os
import sys
import io
from datetime import datetime
from pathlib import Path
from core import search, DATA_DIR
# Force UTF-8 for stdout/stderr to handle emojis/box-drawing chars on Windows (cp1252 default)
if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
# ============ CONFIGURATION ============
REASONING_FILE = "ui-reasoning.csv"
+2 -2
View File
@@ -1,11 +1,11 @@
{
"name": "uipro-cli",
"name": "ui-ux-pro-max-cli",
"version": "2.5.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "uipro-cli",
"name": "ui-ux-pro-max-cli",
"version": "2.5.0",
"license": "MIT",
"dependencies": {
+2 -2
View File
@@ -1,10 +1,10 @@
{
"name": "uipro-cli",
"name": "ui-ux-pro-max-cli",
"version": "2.5.0",
"description": "CLI to install UI/UX Pro Max skill for AI coding assistants",
"type": "module",
"bin": {
"uipro": "./dist/index.js"
"uipro": "dist/index.js"
},
"files": [
"dist",
+4 -3
View File
@@ -10,6 +10,7 @@ import { initCommand } from './init.js';
import type { AIType } from '../types/index.js';
const __dirname = dirname(fileURLToPath(import.meta.url));
const CLI_PACKAGE_NAME = 'ui-ux-pro-max-cli';
interface UpdateOptions {
ai?: AIType;
@@ -44,7 +45,7 @@ export async function updateCommand(options: UpdateOptions): Promise<void> {
// reach the shell that npm.cmd requires on Windows.
if (!/^\d+\.\d+\.\d+([.-][0-9A-Za-z.-]+)?$/.test(latestVersion)) {
logger.warn(`Installed CLI is ${chalk.cyan(currentVersion)}; latest release is ${chalk.cyan(release.tag_name)}.`);
logger.info(`Update the CLI package: ${chalk.cyan(`npm install -g uipro-cli@${latestVersion}`)}`);
logger.info(`Update the CLI package: ${chalk.cyan(`npm install -g ${CLI_PACKAGE_NAME}@${latestVersion}`)}`);
logger.info('Then rerun: uipro init --ai <platform> --force');
return;
}
@@ -58,13 +59,13 @@ export async function updateCommand(options: UpdateOptions): Promise<void> {
// On Windows npm is npm.cmd, which Node only spawns via a shell.
execFileSync(
isWindows ? 'npm.cmd' : 'npm',
['install', '-g', `uipro-cli@${latestVersion}`],
['install', '-g', `${CLI_PACKAGE_NAME}@${latestVersion}`],
{ stdio: 'inherit', shell: isWindows }
);
} catch {
console.log();
logger.error('Automatic update failed (you may need elevated/admin permissions).');
logger.info(`Update manually: ${chalk.cyan(`npm install -g uipro-cli@${latestVersion}`)}`);
logger.info(`Update manually: ${chalk.cyan(`npm install -g ${CLI_PACKAGE_NAME}@${latestVersion}`)}`);
process.exit(1);
}
+4 -3
View File
@@ -4,6 +4,7 @@ import type { Release } from '../types/index.js';
const REPO_OWNER = 'nextlevelbuilder';
const REPO_NAME = 'ui-ux-pro-max-skill';
const API_BASE = 'https://api.github.com';
const USER_AGENT = 'ui-ux-pro-max-cli';
export class GitHubRateLimitError extends Error {
constructor(message: string) {
@@ -56,7 +57,7 @@ export async function fetchReleases(token?: string): Promise<Release[]> {
const response = await fetch(url, {
headers: {
'Accept': 'application/vnd.github.v3+json',
'User-Agent': 'uipro-cli',
'User-Agent': USER_AGENT,
...getAuthHeaders(token),
},
});
@@ -76,7 +77,7 @@ export async function getLatestRelease(token?: string): Promise<Release> {
const response = await fetch(url, {
headers: {
'Accept': 'application/vnd.github.v3+json',
'User-Agent': 'uipro-cli',
'User-Agent': USER_AGENT,
...getAuthHeaders(token),
},
});
@@ -93,7 +94,7 @@ export async function getLatestRelease(token?: string): Promise<Release> {
export async function downloadRelease(url: string, dest: string, token?: string): Promise<void> {
const response = await fetch(url, {
headers: {
'User-Agent': 'uipro-cli',
'User-Agent': USER_AGENT,
'Accept': 'application/octet-stream',
...getAuthHeaders(token),
},
@@ -6,7 +6,7 @@
|------|------|--------|
| **src/ui-ux-pro-max/** | **唯一源码**。所有 CSV、脚本、模板都在这里改,是“唯一真相来源”。 | ❌ 不能删,这是你要维护的那一份。 |
| **.claude/skills/ui-ux-pro-max/** | 给 **Cursor / Claude Code** 用的 Skill。AI 从这里读 SKILL.md 和运行 `scripts/search.py`。设计上这里的 data、scripts 应是**指向 src 的符号链接**,这样不用维护两份。 | ❌ 不能删(否则 Skill 不工作);但可以改成只链到 src,不保留副本。 |
| **cli/assets/** | 给 **npm 包 uipro-cli** 打包用。用户执行 `npm i -g uipro-cli` 再 `uipro init` 时,安装的是这里打包进去的 data/scripts/templates。 | ❌ 不能删;发布前用脚本从 src 同步过来即可。 |
| **cli/assets/** | 给 **npm 包 ui-ux-pro-max-cli** 打包用。用户执行 `npm i -g ui-ux-pro-max-cli` 再 `uipro init` 时,安装的是这里打包进去的 data/scripts/templates。 | ❌ 不能删;发布前用脚本从 src 同步过来即可。 |
## 可以只保留一个吗?
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "ui-ux-pro-max",
"displayName": "UI/UX Pro Max",
"description": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.",
"description": "AI-powered design intelligence with 84 UI styles, 161 color palettes, 73 font pairings, 99 UX guidelines, and 25 chart types across 17 tech stacks.",
"version": "2.6.2",
"author": "NextLevelBuilder",
"license": "MIT",
@@ -38,5 +38,5 @@
"antigravity",
"openclaw"
],
"install": "npx uipro-cli init --ai {{platform}}"
"install": "npx ui-ux-pro-max-cli init --ai {{platform}}"
}
@@ -16,10 +16,18 @@ Usage:
import csv
import json
import os
import sys
import io
from datetime import datetime
from pathlib import Path
from core import search, DATA_DIR
# Force UTF-8 for stdout/stderr to handle emojis/box-drawing chars on Windows (cp1252 default)
if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
# ============ CONFIGURATION ============
REASONING_FILE = "ui-reasoning.csv"