@fyow/copilot-everything 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: architect
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: build-error-resolver
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: code-reviewer
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: doc-updater
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: e2e-runner
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: git.commit
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: planner
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: refactor-cleaner
3
+ ---
@@ -0,0 +1,3 @@
1
+ ---
2
+ agent: tdd-guide
3
+ ---
@@ -0,0 +1,263 @@
1
+ # ui-ux-pro-max
2
+
3
+ Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
4
+
5
+ ## Prerequisites
6
+
7
+ Check if Python is installed:
8
+
9
+ ```bash
10
+ python3 --version || python --version
11
+ ```
12
+
13
+ If Python is not installed, install it based on user's OS:
14
+
15
+ **macOS:**
16
+ ```bash
17
+ brew install python3
18
+ ```
19
+
20
+ **Ubuntu/Debian:**
21
+ ```bash
22
+ sudo apt update && sudo apt install python3
23
+ ```
24
+
25
+ **Windows:**
26
+ ```powershell
27
+ winget install Python.Python.3.12
28
+ ```
29
+
30
+ ---
31
+
32
+ ## How to Use This Workflow
33
+
34
+ When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
35
+
36
+ ### Step 1: Analyze User Requirements
37
+
38
+ Extract key information from user request:
39
+ - **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
40
+ - **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.
41
+ - **Industry**: healthcare, fintech, gaming, education, etc.
42
+ - **Stack**: React, Vue, Next.js, or default to `html-tailwind`
43
+
44
+ ### Step 2: Generate Design System (REQUIRED)
45
+
46
+ **Always start with `--design-system`** to get comprehensive recommendations with reasoning:
47
+
48
+ ```bash
49
+ python3 .shared/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
50
+ ```
51
+
52
+ This command:
53
+ 1. Searches 5 domains in parallel (product, style, color, landing, typography)
54
+ 2. Applies reasoning rules from `ui-reasoning.csv` to select best matches
55
+ 3. Returns complete design system: pattern, style, colors, typography, effects
56
+ 4. Includes anti-patterns to avoid
57
+
58
+ **Example:**
59
+ ```bash
60
+ python3 .shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
61
+ ```
62
+
63
+ ### Step 3: Supplement with Detailed Searches (as needed)
64
+
65
+ After getting the design system, use domain searches to get additional details:
66
+
67
+ ```bash
68
+ python3 .shared/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
69
+ ```
70
+
71
+ **When to use detailed searches:**
72
+
73
+ | Need | Domain | Example |
74
+ |------|--------|---------|
75
+ | More style options | `style` | `--domain style "glassmorphism dark"` |
76
+ | Chart recommendations | `chart` | `--domain chart "real-time dashboard"` |
77
+ | UX best practices | `ux` | `--domain ux "animation accessibility"` |
78
+ | Alternative fonts | `typography` | `--domain typography "elegant luxury"` |
79
+ | Landing structure | `landing` | `--domain landing "hero social-proof"` |
80
+
81
+ ### Step 4: Stack Guidelines (Default: html-tailwind)
82
+
83
+ Get implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.
84
+
85
+ ```bash
86
+ python3 .shared/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
87
+ ```
88
+
89
+ Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`,`jetpack-compose`, `shadcn`
90
+
91
+ ---
92
+
93
+ ## Search Reference
94
+
95
+ ### Available Domains
96
+
97
+ | Domain | Use For | Example Keywords |
98
+ |--------|---------|------------------|
99
+ | `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
100
+ | `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
101
+ | `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |
102
+ | `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
103
+ | `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
104
+ | `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
105
+ | `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |
106
+ | `react` | React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
107
+ | `web` | Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
108
+ | `prompt` | AI prompts, CSS keywords | (style name) |
109
+
110
+ ### Available Stacks
111
+
112
+ | Stack | Focus |
113
+ |-------|-------|
114
+ | `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |
115
+ | `react` | State, hooks, performance, patterns |
116
+ | `nextjs` | SSR, routing, images, API routes |
117
+ | `vue` | Composition API, Pinia, Vue Router |
118
+ | `svelte` | Runes, stores, SvelteKit |
119
+ | `swiftui` | Views, State, Navigation, Animation |
120
+ | `react-native` | Components, Navigation, Lists |
121
+ | `flutter` | Widgets, State, Layout, Theming |
122
+ | `shadcn` | shadcn/ui components, theming, forms, patterns |
123
+ | `jetpack-compose` | Composables, Modifiers, State Hoisting, Recomposition |
124
+
125
+ ---
126
+
127
+ ## Example Workflow
128
+
129
+ **User request:** "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
130
+
131
+ ### Step 1: Analyze Requirements
132
+ - Product type: Beauty/Spa service
133
+ - Style keywords: elegant, professional, soft
134
+ - Industry: Beauty/Wellness
135
+ - Stack: html-tailwind (default)
136
+
137
+ ### Step 2: Generate Design System (REQUIRED)
138
+
139
+ ```bash
140
+ python3 .shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
141
+ ```
142
+
143
+ **Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
144
+
145
+ ### Step 3: Supplement with Detailed Searches (as needed)
146
+
147
+ ```bash
148
+ # Get UX guidelines for animation and accessibility
149
+ python3 .shared/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
150
+
151
+ # Get alternative typography options if needed
152
+ python3 .shared/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
153
+ ```
154
+
155
+ ### Step 4: Stack Guidelines
156
+
157
+ ```bash
158
+ python3 .shared/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
159
+ ```
160
+
161
+ **Then:** Synthesize design system + detailed searches and implement the design.
162
+
163
+ ---
164
+
165
+ ## Output Formats
166
+
167
+ The `--design-system` flag supports two output formats:
168
+
169
+ ```bash
170
+ # ASCII box (default) - best for terminal display
171
+ python3 .shared/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
172
+
173
+ # Markdown - best for documentation
174
+ python3 .shared/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
175
+ ```
176
+
177
+ ---
178
+
179
+ ## Tips for Better Results
180
+
181
+ 1. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"
182
+ 2. **Search multiple times** - Different keywords reveal different insights
183
+ 3. **Combine domains** - Style + Typography + Color = Complete design system
184
+ 4. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues
185
+ 5. **Use stack flag** - Get implementation-specific best practices
186
+ 6. **Iterate** - If first search doesn't match, try different keywords
187
+
188
+ ---
189
+
190
+ ## Common Rules for Professional UI
191
+
192
+ These are frequently overlooked issues that make UI look unprofessional:
193
+
194
+ ### Icons & Visual Elements
195
+
196
+ | Rule | Do | Don't |
197
+ |------|----|----- |
198
+ | **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |
199
+ | **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |
200
+ | **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |
201
+ | **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |
202
+
203
+ ### Interaction & Cursor
204
+
205
+ | Rule | Do | Don't |
206
+ |------|----|----- |
207
+ | **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |
208
+ | **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |
209
+ | **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |
210
+
211
+ ### Light/Dark Mode Contrast
212
+
213
+ | Rule | Do | Don't |
214
+ |------|----|----- |
215
+ | **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |
216
+ | **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |
217
+ | **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |
218
+ | **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |
219
+
220
+ ### Layout & Spacing
221
+
222
+ | Rule | Do | Don't |
223
+ |------|----|----- |
224
+ | **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |
225
+ | **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |
226
+ | **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |
227
+
228
+ ---
229
+
230
+ ## Pre-Delivery Checklist
231
+
232
+ Before delivering UI code, verify these items:
233
+
234
+ ### Visual Quality
235
+ - [ ] No emojis used as icons (use SVG instead)
236
+ - [ ] All icons from consistent icon set (Heroicons/Lucide)
237
+ - [ ] Brand logos are correct (verified from Simple Icons)
238
+ - [ ] Hover states don't cause layout shift
239
+ - [ ] Use theme colors directly (bg-primary) not var() wrapper
240
+
241
+ ### Interaction
242
+ - [ ] All clickable elements have `cursor-pointer`
243
+ - [ ] Hover states provide clear visual feedback
244
+ - [ ] Transitions are smooth (150-300ms)
245
+ - [ ] Focus states visible for keyboard navigation
246
+
247
+ ### Light/Dark Mode
248
+ - [ ] Light mode text has sufficient contrast (4.5:1 minimum)
249
+ - [ ] Glass/transparent elements visible in light mode
250
+ - [ ] Borders visible in both modes
251
+ - [ ] Test both modes before delivery
252
+
253
+ ### Layout
254
+ - [ ] Floating elements have proper spacing from edges
255
+ - [ ] No content hidden behind fixed navbars
256
+ - [ ] Responsive at 375px, 768px, 1024px, 1440px
257
+ - [ ] No horizontal scroll on mobile
258
+
259
+ ### Accessibility
260
+ - [ ] All images have alt text
261
+ - [ ] Form inputs have labels
262
+ - [ ] Color is not the only indicator
263
+ - [ ] `prefers-reduced-motion` respected
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fyow/copilot-everything",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "Everything you need for GitHub Copilot CLI - agents, skills, instructions, and hooks configurations",
5
5
  "main": "src/index.js",
6
6
  "bin": {
@@ -149,6 +149,15 @@ function init(flags = {}) {
149
149
  totalSkipped += instructionsResult.skipped;
150
150
  totalErrors.push(...instructionsResult.errors);
151
151
 
152
+ // Prompts (for "/" invocation)
153
+ const promptsSrc = path.join(githubSrc, 'prompts');
154
+ const promptsDest = path.join(githubDest, 'prompts');
155
+ const promptsResult = copyDir(promptsSrc, promptsDest, options);
156
+ console.log(` ✅ Prompts: ${promptsResult.copied} copied, ${promptsResult.skipped} skipped`);
157
+ totalCopied += promptsResult.copied;
158
+ totalSkipped += promptsResult.skipped;
159
+ totalErrors.push(...promptsResult.errors);
160
+
152
161
  // Hooks
153
162
  if (!skipHooks) {
154
163
  const hooksSrc = path.join(githubSrc, 'hooks');