ui-ux-master 1.2.0 → 1.2.1

package/README.md

@@ -1,7 +1,10 @@
 # UI/UX Master 🎨✨
 
-[![npm version](https://badge.fury.io/js/ui-ux-master.svg)](https://badge.fury.io/js/ui-ux-master)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/ui-ux-master?logo=npm&label=npm)](https://www.npmjs.com/package/ui-ux-master)
+[![npm downloads](https://img.shields.io/npm/dm/ui-ux-master?logo=npm&label=downloads)](https://www.npmjs.com/package/ui-ux-master)
+[![License: MIT](https://img.shields.io/npm/l/ui-ux-master)](https://github.com/Seance1723/UI-UX-Skills/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/Seance1723/UI-UX-Skills?style=flat&logo=github)](https://github.com/Seance1723/UI-UX-Skills/stargazers)
+[![Last commit](https://img.shields.io/github/last-commit/Seance1723/UI-UX-Skills?logo=github)](https://github.com/Seance1723/UI-UX-Skills/commits/main)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
 
 **The ultimate UI/UX skill for AI coding agents.** Turn your AI into a Senior Product Designer, UX Researcher, and Frontend Lead in seconds.
@@ -107,6 +110,25 @@ Dry run:
 npx ui-ux-master install --project --dry-run
 ```
 
+## Package
+
+| Channel | Package | Purpose |
+|---|---|---|
+| npmjs | [`ui-ux-master`](https://www.npmjs.com/package/ui-ux-master) | Primary public package for normal installs and `npx` usage |
+| GitHub | [`Seance1723/UI-UX-Skills`](https://github.com/Seance1723/UI-UX-Skills) | Source, issues, releases, workflows, and open-source collaboration |
+| GitHub Packages | Optional scoped mirror | Use only if you want the repository Packages section to show a package |
+
+The canonical npm package is intentionally unscoped as `ui-ux-master`. GitHub Packages requires npm packages to be scoped, so a GitHub Packages mirror should use `@seance1723/ui-ux-master` while the public npmjs package remains `ui-ux-master`.
+
+Package entrypoints:
+
+- `ui-ux-master` - CLI installer and project integration tool.
+- `ui-ux-master-mcp` - local MCP server for tools, resources, and prompts.
+- `import { assets, bins, trigger } from "ui-ux-master"` - lightweight ESM metadata API.
+- `require("ui-ux-master")` - CommonJS metadata API.
+
+Package metadata is connected to GitHub through `repository`, `homepage`, `bugs`, license, funding, exports, engines, and npm provenance-ready publish settings in `package.json`.
+
 ## Supported Agents
 
 | Agent | Install target | Trigger |
@@ -194,6 +216,7 @@ ui-ux-master uninstall --project
 ## Package Structure
 
 - `SKILL.md` — main orchestration skill.
+- `index.mjs`, `index.cjs`, `index.d.ts` — ESM, CommonJS, and TypeScript metadata entrypoints.
 - `references/` — advanced playbooks and standards-aligned checklists.
 - `templates/` — briefs, audits, component specs, design-system specs, and project UI/UX memory template.
 - `agent-templates/` — Claude, Codex, Windsurf, Antigravity, Gemini, Cursor, and universal `/ui-ux-master` activation rules.
@@ -207,6 +230,20 @@ ui-ux-master uninstall --project
 - `scripts/build_deployment_zip.py` — clean deployment zip builder.
 - `tests/` — npm installer and package smoke tests.
 
+## GitHub Repository Setup
+
+Recommended About section:
+
+- Description: `Opt-in UI/UX master skill, CLI, and MCP server for AI coding agents. Accessibility, design systems, UX research, and frontend handoff in one workflow.`
+- Website: `https://www.npmjs.com/package/ui-ux-master`
+- Enable releases and issues. Enable discussions when you are ready to support community questions.
+
+Recommended GitHub topics:
+
+`ai-agent`, `ai-coding`, `ui-ux`, `ux-research`, `product-design`, `design-system`, `accessibility`, `wcag`, `mcp`, `model-context-protocol`, `claude-code`, `codex`, `windsurf`, `cursor`, `gemini-cli`, `npm-package`, `cli`, `prompt-engineering`, `frontend`, `llms-txt`
+
+For publishing and registry details, see `docs/package-publishing.md`.
+
 ## Validation and Testing
 
 Run from this folder:

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ui-ux-master
 description: "Use when an agent must design, audit, improve, prototype, specify, or hand off any UI/UX work end-to-end. Provides one-stop UX strategy, research, IA, flows, wireframes, visual design, design systems, accessibility, usability testing, conversion, and engineering handoff workflows."
-version: 1.2.0
+version: 1.2.1
 author: Rupak Biswas
 license: MIT
 platforms: [linux, macos, windows]

package/docs/package-publishing.md

@@ -0,0 +1,82 @@
+# Package Publishing
+
+UI/UX Master uses npmjs as the primary public registry and GitHub as the source of truth for code, issues, releases, and automation.
+
+## Registry Strategy
+
+| Registry | Package name | Role |
+|---|---|---|
+| npmjs | `ui-ux-master` | Primary public package for `npm install`, `npx`, and discoverability |
+| GitHub Packages | `@seance1723/ui-ux-master` | Optional scoped mirror to populate the GitHub repository Packages section |
+
+Keep the npmjs package as `ui-ux-master`. If you also publish to GitHub Packages, publish a scoped mirror from CI so the source package name does not need to change.
+
+## npmjs vs GitHub Packages
+
+npmjs is the default npm registry. It is where most developers expect public JavaScript packages to live, and it is the best place for public discoverability, downloads, search, and normal `npx` usage.
+
+GitHub Packages is GitHub's package registry. It is useful for packages tied tightly to a repository or organization, private packages, and showing a package in the repository Packages section. For npm packages, GitHub Packages expects scoped package names such as `@seance1723/ui-ux-master`.
+
+The GitHub "No packages published" message does not mean the npmjs package is broken. It only means nothing has been published to GitHub Packages for that repository.
+
+## GitHub Packages Setup
+
+Do not add a root `.npmrc` that changes the default registry, because that can accidentally route normal installs away from npmjs.
+
+Use this scoped configuration only when publishing or installing the GitHub Packages mirror:
+
+```ini
+@seance1723:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+```
+
+Local install from GitHub Packages:
+
+```bash
+npm install @seance1723/ui-ux-master --registry=https://npm.pkg.github.com
+```
+
+## Secrets
+
+Add these repository secrets:
+
+- `NPM_TOKEN` - npm automation token with publish access to `ui-ux-master`.
+
+GitHub Packages publishing uses the built-in `GITHUB_TOKEN` in Actions.
+
+## Release Strategy
+
+Use semantic versioning:
+
+- Patch: documentation fixes, metadata improvements, bug fixes that preserve behavior.
+- Minor: new agent templates, new MCP resources, new commands, backward-compatible workflow improvements.
+- Major: breaking CLI behavior, changed trigger contract, removed assets, changed package entrypoint semantics.
+
+Recommended flow:
+
+```bash
+npm run release:check
+npm version patch
+git push origin main --follow-tags
+```
+
+Create a GitHub release for the new tag, for example `v1.2.1`. The publish workflow will validate and publish.
+
+## npm Optimization Checklist
+
+- Keep `repository`, `homepage`, `bugs`, `license`, `author`, `funding`, and keywords current.
+- Keep `files` tight so generated assets and local graph/cache files stay out of the package.
+- Run `npm pack --dry-run` before publishing.
+- Prefer provenance publishing through GitHub Actions.
+- Keep README install examples short and copyable.
+- Keep `exports` stable once published.
+- Avoid runtime dependencies unless they clearly improve the CLI or MCP server.
+
+## GitHub Presentation Checklist
+
+- Add a concise About description and npm link.
+- Add SEO topics listed in README.
+- Use releases with human-written notes.
+- Keep Issues enabled and use issue templates.
+- Pin the repository on the maintainer profile.
+- Add screenshots or a short terminal GIF later if the CLI becomes more visual.

package/index.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+const path = require('node:path');
+
+const packageRoot = __dirname;
+
+const name = 'ui-ux-master';
+const version = '1.2.1';
+const trigger = '/ui-ux-master';
+
+const bins = Object.freeze({
+  cli: path.join(packageRoot, 'bin', 'ui-ux-master.mjs'),
+  mcp: path.join(packageRoot, 'bin', 'ui-ux-master-mcp.mjs'),
+});
+
+const assets = Object.freeze({
+  skill: path.join(packageRoot, 'SKILL.md'),
+  readme: path.join(packageRoot, 'README.md'),
+  llms: path.join(packageRoot, 'llms.txt'),
+  manifest: path.join(packageRoot, 'ai-discovery', 'ui-ux-master.manifest.json'),
+});
+
+function assetPath(name) {
+  if (!Object.hasOwn(assets, name)) {
+    throw new Error(`Unknown ui-ux-master asset: ${name}`);
+  }
+  return assets[name];
+}
+
+module.exports = {
+  assetPath,
+  assets,
+  bins,
+  name,
+  trigger,
+  version,
+};

package/index.d.ts

@@ -0,0 +1,17 @@
+export declare const name = "ui-ux-master";
+export declare const version = "1.2.1";
+export declare const trigger = "/ui-ux-master";
+
+export declare const bins: Readonly<{
+  cli: string;
+  mcp: string;
+}>;
+
+export declare const assets: Readonly<{
+  skill: string;
+  readme: string;
+  llms: string;
+  manifest: string;
+}>;
+
+export declare function assetPath(name: keyof typeof assets): string;

package/index.mjs

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = path.dirname(fileURLToPath(import.meta.url));
+
+export const name = 'ui-ux-master';
+export const version = '1.2.1';
+export const trigger = '/ui-ux-master';
+
+export const bins = Object.freeze({
+  cli: path.join(packageRoot, 'bin', 'ui-ux-master.mjs'),
+  mcp: path.join(packageRoot, 'bin', 'ui-ux-master-mcp.mjs'),
+});
+
+export const assets = Object.freeze({
+  skill: path.join(packageRoot, 'SKILL.md'),
+  readme: path.join(packageRoot, 'README.md'),
+  llms: path.join(packageRoot, 'llms.txt'),
+  manifest: path.join(packageRoot, 'ai-discovery', 'ui-ux-master.manifest.json'),
+});
+
+export function assetPath(name) {
+  if (!Object.hasOwn(assets, name)) {
+    throw new Error(`Unknown ui-ux-master asset: ${name}`);
+  }
+  return assets[name];
+}

package/package.json

@@ -1,17 +1,38 @@
 {
   "name": "ui-ux-master",
-  "version": "1.2.0",
-  "description": "One-stop UI/UX master skill for AI agents with opt-in /ui-ux-master activation, system prompt add-ons, AI discovery assets, and local MCP server support.",
+  "version": "1.2.1",
+  "description": "Opt-in UI/UX master skill, CLI, and MCP server for AI coding agents, with accessibility, design-system, UX research, and frontend handoff workflows.",
   "type": "module",
+  "packageManager": "npm@11.14.0",
+  "main": "./index.cjs",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    },
+    "./package.json": "./package.json",
+    "./skill": "./SKILL.md",
+    "./llms": "./llms.txt",
+    "./manifest": "./ai-discovery/ui-ux-master.manifest.json",
+    "./cli": "./bin/ui-ux-master.mjs",
+    "./mcp": "./bin/ui-ux-master-mcp.mjs"
+  },
   "bin": {
     "ui-ux-master": "./bin/ui-ux-master.mjs",
     "ui-ux-master-mcp": "./bin/ui-ux-master-mcp.mjs"
   },
+  "sideEffects": false,
   "files": [
     "SKILL.md",
     "README.md",
     "LICENSE",
     "package.json",
+    "index.cjs",
+    "index.d.ts",
+    "index.mjs",
     "references/",
     "templates/",
     "agent-templates/",
@@ -25,38 +46,91 @@
   ],
   "scripts": {
     "validate": "python scripts/validate_skill.py --release",
-    "test": "node --test tests/*.test.mjs",
+    "validate:release": "python scripts/validate_skill.py --release",
+    "check:syntax": "node --check index.mjs && node --check index.cjs && node --check bin/ui-ux-master.mjs && node --check bin/ui-ux-master-mcp.mjs",
+    "doctor": "node bin/ui-ux-master.mjs doctor --dry-run",
+    "test": "npm run test:smoke",
+    "test:smoke": "npm run check:syntax && npm run doctor",
+    "test:node": "node --test tests/*.test.mjs",
+    "ci": "npm run validate && npm run test:smoke && npm run test:node",
+    "release:check": "npm run ci && npm run pack:dry-run",
+    "pack:dry-run": "npm pack --dry-run",
     "prepack": "npm run validate && npm test",
     "build:zip": "python scripts/build_deployment_zip.py"
   },
   "keywords": [
+    "ai",
     "ai-agent",
+    "ai-agents",
+    "ai-coding",
+    "agent",
     "ui",
     "ux",
     "ui-ux",
+    "user-experience",
+    "product-design",
+    "ux-research",
+    "frontend",
+    "frontend-development",
     "design-system",
+    "design-systems",
     "accessibility",
     "wcag",
+    "wcag-2-2",
+    "aria",
+    "a11y",
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "cli",
+    "npx",
+    "prompt-engineering",
+    "system-prompt",
+    "ai-discovery",
+    "llms-txt",
     "claude-code",
+    "claude",
     "codex",
     "windsurf",
     "antigravity",
     "gemini-cli",
+    "gemini",
     "cursor",
     "slash-command",
-    "agent-skill",
-    "frontend",
-    "mcp",
-    "model-context-protocol",
-    "system-prompt",
-    "ai-discovery",
-    "llms-txt"
+    "agent-skill"
   ],
   "license": "MIT",
   "author": "Rupak Biswas",
+  "contributors": [
+    {
+      "name": "Rupak Biswas"
+    }
+  ],
+  "homepage": "https://github.com/Seance1723/UI-UX-Skills#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Seance1723/UI-UX-Skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Seance1723/UI-UX-Skills/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Seance1723"
+  },
   "engines": {
-    "node": ">=18"
+    "node": ">=18.18"
   },
+  "directories": {
+    "bin": "bin",
+    "doc": "docs",
+    "test": "tests"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
   "preferGlobal": true,
   "publishConfig": {
     "access": "public"