ui-ux-master 1.1.0

package/templates/ui-ux-audit-report.md

@@ -0,0 +1,146 @@
+# UI/UX Audit Report
+
+## Executive Summary
+
+- Overall score:
+- Top strengths:
+- Top risks:
+- Highest-impact recommendation:
+- Evidence confidence: high / medium / low:
+
+## Scope
+
+- Screens/pages reviewed:
+- User goal reviewed:
+- Devices/viewports reviewed:
+- Platform conventions reviewed:
+- Evidence used:
+
+## Scorecard
+
+| Area | Score 1-5 | Evidence Confidence | Notes |
+|---|---:|---|---|
+| Clarity |  |  |  |
+| Hierarchy |  |  |  |
+| Flow |  |  |  |
+| Content design |  |  |  |
+| Accessibility |  |  |  |
+| Consistency |  |  |  |
+| Responsiveness |  |  |  |
+| Feedback/states |  |  |  |
+| Trust |  |  |  |
+| Platform fit |  |  |  |
+| Internationalization/content resilience |  |  |  |
+| Ethics/privacy/dark-pattern risk |  |  |  |
+| Performance perception |  |  |  |
+| Conversion/task success |  |  |  |
+| Data visualization/dashboard UX if applicable |  |  |  |
+| Implementation readiness |  |  |  |
+
+## Heuristic Findings
+
+| Location | Heuristic/Principle | Severity | Evidence | Recommendation |
+|---|---|---|---|---|
+|  |  |  |  |  |
+
+## Severity-Ranked Findings
+
+### Critical
+
+1. Finding:
+   - Heuristic/WCAG/platform rule:
+   - Evidence:
+   - Evidence confidence:
+   - Impact:
+   - Recommendation:
+   - Acceptance criteria:
+
+### High
+
+1. Finding:
+   - Heuristic/WCAG/platform rule:
+   - Evidence:
+   - Evidence confidence:
+   - Impact:
+   - Recommendation:
+   - Acceptance criteria:
+
+### Medium
+
+1. Finding:
+   - Heuristic/WCAG/platform rule:
+   - Evidence:
+   - Evidence confidence:
+   - Impact:
+   - Recommendation:
+   - Acceptance criteria:
+
+### Low
+
+1. Finding:
+   - Heuristic/WCAG/platform rule:
+   - Evidence:
+   - Evidence confidence:
+   - Impact:
+   - Recommendation:
+   - Acceptance criteria:
+
+## Measured Evidence and Quality Gates
+
+- Primary task success metric:
+- Accessibility gate:
+- Responsive/platform gate:
+- Performance perception gate:
+- Analytics/events needed:
+- Usability validation recommended:
+
+## Quick Wins
+
+- [ ] Quick win 1:
+- [ ] Quick win 2:
+- [ ] Quick win 3:
+
+## Recommended Revised Structure
+
+- Header/nav:
+- Main content:
+- Primary CTA:
+- Secondary actions:
+- Supporting content:
+- Footer/persistent actions:
+
+## Copy Improvements
+
+| Current | Suggested | Reason |
+|---|---|---|
+|  |  |  |
+
+## Accessibility Fixes
+
+- [ ] Contrast:
+- [ ] Keyboard:
+- [ ] Focus:
+- [ ] Labels:
+- [ ] Semantics:
+- [ ] Motion:
+- [ ] Complex widgets/ARIA:
+
+## Responsive and Platform Fixes
+
+- Mobile:
+- Tablet:
+- Desktop:
+- Wide:
+- Native/platform convention issues:
+
+## QA Checklist
+
+- [ ] Main user task succeeds.
+- [ ] Keyboard-only task succeeds.
+- [ ] Screen reader labels are meaningful.
+- [ ] Loading, empty, error, success states are present.
+- [ ] Mobile layout works at 320px.
+- [ ] Text contrast meets WCAG AA.
+- [ ] Platform conventions are respected.
+- [ ] Content survives expected localization/text expansion.
+- [ ] No dark patterns or unclear privacy/permission prompts remain.

package/templates/ui-ux-brief.md

@@ -0,0 +1,86 @@
+# UI/UX Brief
+
+## Project
+
+- Product/project name:
+- Platform: web / iOS / Android / desktop / email / kiosk / TV / wearable / other:
+- Existing URL/app/repo:
+- Stage: idea / MVP / beta / production / redesign
+- UI/UX memory location if available:
+
+## Goal
+
+- Primary user goal:
+- Business goal:
+- Success metric:
+- Guardrail metric:
+- Deadline or scope limit:
+
+## Users
+
+- Primary users:
+- Secondary users:
+- User jobs-to-be-done:
+- Context of use:
+- Accessibility needs:
+- Device, input, bandwidth, stress, and environment constraints:
+
+## Current Problem
+
+- What is not working now:
+- Evidence: analytics, support tickets, screenshots, feedback, stakeholder opinion:
+- Research confidence: high / medium / low / assumption only:
+- Main friction points:
+- Unknowns that require research:
+
+## Research and Evidence Plan
+
+- Research objective:
+- Method: interview / survey / analytics / usability test / card sort / tree test / heuristic review / accessibility test / other:
+- Participants or evidence source:
+- Consent/privacy notes:
+- Expected output:
+
+## Constraints
+
+- Brand/design system:
+- Tech stack:
+- Devices/browsers:
+- Platform conventions to follow:
+- Compliance/legal:
+- Ethics/privacy/safety risks:
+- Content/localization: locales, languages, RTL, reading level, legal copy:
+- Must keep:
+- Must avoid:
+
+## Competitive/Reference Direction
+
+- Products liked:
+- Products disliked:
+- Desired personality:
+- What to extract as method, not copy:
+
+## Deliverables Needed
+
+- UX strategy:
+- IA/site map:
+- User flows:
+- Journey map/service blueprint:
+- Wireframes:
+- Visual direction:
+- Prototype:
+- Design system:
+- Accessibility audit:
+- Usability test plan:
+- Developer handoff:
+- Measurement/quality gates:
+
+## Assumptions
+
+- Assumption 1:
+- Assumption 2:
+
+## Open Questions
+
+- Question 1:
+- Question 2:

package/templates/ui-ux-memory.md

@@ -0,0 +1,204 @@
+# UI/UX Memory
+
+This file stores stable UI/UX and branding decisions for this application. Read this before creating or modifying frontend. Update it only with durable design-system decisions.
+
+## Product Summary
+
+- Product name:
+- Product type:
+- Primary platform:
+- One-sentence promise:
+
+## Target Users and Jobs
+
+- Primary users:
+- Primary job-to-be-done:
+- Secondary users/jobs:
+- Main success moment:
+
+## Brand Personality
+
+- Personality keywords:
+- Trust level needed:
+- Emotional tone:
+- Should feel like:
+- Should not feel like:
+
+## Design Method Blend
+
+Use methods from `top-100-brand-website-analysis.md`.
+
+- Primary method:
+- Supporting method 1:
+- Supporting method 2:
+- Rationale:
+
+## Existing Branding Baseline
+
+- Logo/wordmark:
+- Current color scheme:
+- Current fonts:
+- Current layout style:
+- Current component style:
+- Current tone of voice:
+- Screens/components used as baseline:
+
+## Design Tokens
+
+### Colors
+
+| Token | Value | Usage |
+|---|---|---|
+| color.background |  |  |
+| color.surface |  |  |
+| color.surface-muted |  |  |
+| color.text-primary |  |  |
+| color.text-secondary |  |  |
+| color.border |  |  |
+| color.primary |  |  |
+| color.primary-hover |  |  |
+| color.secondary |  |  |
+| color.success |  |  |
+| color.warning |  |  |
+| color.danger |  |  |
+| color.focus |  |  |
+
+### Typography
+
+| Token | Value | Usage |
+|---|---|---|
+| font.primary |  |  |
+| font.mono |  |  |
+| text.display |  |  |
+| text.h1 |  |  |
+| text.h2 |  |  |
+| text.h3 |  |  |
+| text.body |  |  |
+| text.body-sm |  |  |
+| text.label |  |  |
+| text.caption |  |  |
+
+### Spacing and Layout
+
+- Spacing scale:
+- Container max width:
+- Page padding:
+- Section spacing:
+- Grid columns/gaps:
+- Mobile layout rules:
+
+### Shape, Elevation, Motion
+
+- Radius scale:
+- Shadow/elevation style:
+- Border style:
+- Motion duration/easing:
+- Reduced motion behavior:
+
+## Component Rules
+
+### Buttons
+
+- Primary:
+- Secondary:
+- Tertiary/ghost:
+- Destructive:
+- Disabled/loading:
+
+### Forms
+
+- Input style:
+- Label style:
+- Helper text:
+- Validation style:
+- Error copy style:
+
+### Cards/Panels
+
+- Card structure:
+- Padding:
+- Border/elevation:
+- Hover/focus behavior:
+
+### Navigation
+
+- Header/sidebar style:
+- Current state:
+- Mobile behavior:
+
+### Tables/Lists
+
+- Density:
+- Sorting/filtering:
+- Empty/loading/error:
+- Mobile behavior:
+
+### Modals/Drawers/Popovers
+
+- Usage rule:
+- Focus behavior:
+- Close behavior:
+- Mobile behavior:
+
+## Interaction and State Rules
+
+- Loading:
+- Empty:
+- Error:
+- Success:
+- Disabled:
+- Permission denied:
+- Offline/network:
+- Hover/focus/active:
+
+## Accessibility Rules
+
+- WCAG target:
+- Focus indicator:
+- Contrast requirements:
+- Keyboard rules:
+- Screen reader rules:
+- Touch target rules:
+- Motion rules:
+
+## Content and Microcopy Voice
+
+- Voice:
+- CTA style:
+- Error style:
+- Empty-state style:
+- Confirmation style:
+- Words to use:
+- Words to avoid:
+
+## Responsive Rules
+
+- 320px:
+- 375px:
+- 768px:
+- 1024px:
+- 1440px:
+
+## Do / Don't
+
+### Do
+
+- 
+
+### Don't
+
+- 
+
+## Local Exceptions
+
+Use this only for intentional one-off deviations.
+
+| Area | Exception | Reason | Date |
+|---|---|---|---|
+|  |  |  |  |
+
+## Design Decision Change Log
+
+| Date | Decision | Reason | Scope |
+|---|---|---|---|
+|  |  |  |  |

package/tests/install-smoke.test.mjs

@@ -0,0 +1,71 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import test from 'node:test';
+
+const root = path.resolve(import.meta.dirname, '..');
+const bin = path.join(root, 'bin', 'ui-ux-master.mjs');
+const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+const templates = [
+  'agent-templates/claude/commands/ui-ux-master.md',
+  'agent-templates/universal/ui-ux-master-trigger.md',
+  'agent-templates/codex/AGENTS.append.md',
+  'agent-templates/windsurf/rules/ui-ux-master.md',
+  'agent-templates/antigravity/AGENTS.append.md',
+  'agent-templates/gemini/GEMINI.append.md',
+  'agent-templates/cursor/rules/ui-ux-master.mdc',
+];
+
+function run(args, cwd = root) {
+  return execFileSync(process.execPath, [bin, ...args], { cwd, encoding: 'utf8' });
+}
+
+test('package exposes ui-ux-master bin', () => {
+  assert.equal(pkg.bin['ui-ux-master'], './bin/ui-ux-master.mjs');
+  assert.ok(fs.existsSync(bin));
+  assert.ok(fs.readFileSync(bin, 'utf8').startsWith('#!/usr/bin/env node'));
+});
+
+test('agent templates include trigger and avoid local absolute paths', () => {
+  for (const rel of templates) {
+    const text = fs.readFileSync(path.join(root, rel), 'utf8');
+    assert.match(text, /\/ui-ux-master/);
+    assert.match(text, /\.ui-ux-master\/SKILL\.md|\.ui-ux-master\/|\.ui-ux-master/);
+    assert.match(text, /UI\/UX|ui-ux-master/i);
+    assert.doesNotMatch(text, /C:\\|C:\/xampp|C:\/Users|\/workspace/);
+  }
+});
+
+test('cli help doctor and where work', () => {
+  assert.match(run(['--help']), /ui-ux-master install/);
+  assert.match(run(['where']).trim(), /UI-UX Skills|ui-ux-master/i);
+  assert.match(run(['doctor', '--dry-run']), /trigger: \/ui-ux-master/);
+});
+
+test('project install dry-run does not write', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ui-ux-master-dry-'));
+  fs.writeFileSync(path.join(dir, 'package.json'), '{}');
+  const out = run(['install', '--project', '--dry-run', '--dir', dir]);
+  assert.match(out, /dry-run/);
+  assert.equal(fs.existsSync(path.join(dir, 'AGENTS.md')), false);
+});
+
+test('project install writes expected files and is idempotent', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ui-ux-master-install-'));
+  fs.writeFileSync(path.join(dir, 'package.json'), '{}');
+  run(['install', '--project', '--dir', dir]);
+  run(['install', '--project', '--dir', dir]);
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'SKILL.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'references', 'ui-ux-memory-workflow.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'templates', 'ui-ux-memory.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.claude', 'commands', 'ui-ux-master.md')));
+  assert.ok(fs.existsSync(path.join(dir, 'AGENTS.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.windsurf', 'rules', 'ui-ux-master.md')));
+  assert.ok(fs.existsSync(path.join(dir, 'GEMINI.md')));
+  const agents = fs.readFileSync(path.join(dir, 'AGENTS.md'), 'utf8');
+  assert.equal((agents.match(/ui-ux-master:start/g) || []).length, 1);
+  assert.match(agents, /\.ui-ux-master\/SKILL\.md/);
+  assert.match(agents, /\/ui-ux-master/);
+});