@ngxtm/devkit 3.6.1 → 3.8.0

package/merged-commands/ui-styling.md

@@ -0,0 +1,321 @@
+---
+name: ui-styling
+description: Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.
+license: MIT
+version: 1.0.0
+---
+
+# UI Styling Skill
+
+Comprehensive skill for creating beautiful, accessible user interfaces combining shadcn/ui components, Tailwind CSS utility styling, and canvas-based visual design systems.
+
+## Reference
+
+- shadcn/ui: https://ui.shadcn.com/llms.txt
+- Tailwind CSS: https://tailwindcss.com/docs
+
+## When to Use This Skill
+
+Use when:
+- Building UI with React-based frameworks (Next.js, Vite, Remix, Astro)
+- Implementing accessible components (dialogs, forms, tables, navigation)
+- Styling with utility-first CSS approach
+- Creating responsive, mobile-first layouts
+- Implementing dark mode and theme customization
+- Building design systems with consistent tokens
+- Generating visual designs, posters, or brand materials
+- Rapid prototyping with immediate visual feedback
+- Adding complex UI patterns (data tables, charts, command palettes)
+
+## Core Stack
+
+### Component Layer: shadcn/ui
+- Pre-built accessible components via Radix UI primitives
+- Copy-paste distribution model (components live in your codebase)
+- TypeScript-first with full type safety
+- Composable primitives for complex UIs
+- CLI-based installation and management
+
+### Styling Layer: Tailwind CSS
+- Utility-first CSS framework
+- Build-time processing with zero runtime overhead
+- Mobile-first responsive design
+- Consistent design tokens (colors, spacing, typography)
+- Automatic dead code elimination
+
+### Visual Design Layer: Canvas
+- Museum-quality visual compositions
+- Philosophy-driven design approach
+- Sophisticated visual communication
+- Minimal text, maximum visual impact
+- Systematic patterns and refined aesthetics
+
+## Quick Start
+
+### Component + Styling Setup
+
+**Install shadcn/ui with Tailwind:**
+```bash
+npx shadcn@latest init
+```
+
+CLI prompts for framework, TypeScript, paths, and theme preferences. This configures both shadcn/ui and Tailwind CSS.
+
+**Add components:**
+```bash
+npx shadcn@latest add button card dialog form
+```
+
+**Use components with utility styling:**
+```tsx
+import { Button } from "@/components/ui/button"
+import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card"
+
+export function Dashboard() {
+  return (
+    <div className="container mx-auto p-6 grid gap-6 md:grid-cols-2 lg:grid-cols-3">
+      <Card className="hover:shadow-lg transition-shadow">
+        <CardHeader>
+          <CardTitle className="text-2xl font-bold">Analytics</CardTitle>
+        </CardHeader>
+        <CardContent className="space-y-4">
+          <p className="text-muted-foreground">View your metrics</p>
+          <Button variant="default" className="w-full">
+            View Details
+          </Button>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}
+```
+
+### Alternative: Tailwind-Only Setup
+
+**Vite projects:**
+```bash
+npm install -D tailwindcss @tailwindcss/vite
+```
+
+```javascript
+// vite.config.ts
+import tailwindcss from '@tailwindcss/vite'
+export default { plugins: [tailwindcss()] }
+```
+
+```css
+/* src/index.css */
+@import "tailwindcss";
+```
+
+## Component Library Guide
+
+**Comprehensive component catalog with usage patterns, installation, and composition examples.**
+
+See: `references/shadcn-components.md`
+
+Covers:
+- Form & input components (Button, Input, Select, Checkbox, Date Picker, Form validation)
+- Layout & navigation (Card, Tabs, Accordion, Navigation Menu)
+- Overlays & dialogs (Dialog, Drawer, Popover, Toast, Command)
+- Feedback & status (Alert, Progress, Skeleton)
+- Display components (Table, Data Table, Avatar, Badge)
+
+## Theme & Customization
+
+**Theme configuration, CSS variables, dark mode implementation, and component customization.**
+
+See: `references/shadcn-theming.md`
+
+Covers:
+- Dark mode setup with next-themes
+- CSS variable system
+- Color customization and palettes
+- Component variant customization
+- Theme toggle implementation
+
+## Accessibility Patterns
+
+**ARIA patterns, keyboard navigation, screen reader support, and accessible component usage.**
+
+See: `references/shadcn-accessibility.md`
+
+Covers:
+- Radix UI accessibility features
+- Keyboard navigation patterns
+- Focus management
+- Screen reader announcements
+- Form validation accessibility
+
+## Tailwind Utilities
+
+**Core utility classes for layout, spacing, typography, colors, borders, and shadows.**
+
+See: `references/tailwind-utilities.md`
+
+Covers:
+- Layout utilities (Flexbox, Grid, positioning)
+- Spacing system (padding, margin, gap)
+- Typography (font sizes, weights, alignment, line height)
+- Colors and backgrounds
+- Borders and shadows
+- Arbitrary values for custom styling
+
+## Responsive Design
+
+**Mobile-first breakpoints, responsive utilities, and adaptive layouts.**
+
+See: `references/tailwind-responsive.md`
+
+Covers:
+- Mobile-first approach
+- Breakpoint system (sm, md, lg, xl, 2xl)
+- Responsive utility patterns
+- Container queries
+- Max-width queries
+- Custom breakpoints
+
+## Tailwind Customization
+
+**Config file structure, custom utilities, plugins, and theme extensions.**
+
+See: `references/tailwind-customization.md`
+
+Covers:
+- @theme directive for custom tokens
+- Custom colors and fonts
+- Spacing and breakpoint extensions
+- Custom utility creation
+- Custom variants
+- Layer organization (@layer base, components, utilities)
+- Apply directive for component extraction
+
+## Visual Design System
+
+**Canvas-based design philosophy, visual communication principles, and sophisticated compositions.**
+
+See: `references/canvas-design-system.md`
+
+Covers:
+- Design philosophy approach
+- Visual communication over text
+- Systematic patterns and composition
+- Color, form, and spatial design
+- Minimal text integration
+- Museum-quality execution
+- Multi-page design systems
+
+## Utility Scripts
+
+**Python automation for component installation and configuration generation.**
+
+### shadcn_add.py
+Add shadcn/ui components with dependency handling:
+```bash
+python3 ~/.{TOOL}/skills/ui-styling/scripts/shadcn_add.py button card dialog
+```
+
+### tailwind_config_gen.py
+Generate tailwind.config.js with custom theme:
+```bash
+python3 ~/.{TOOL}/skills/ui-styling/scripts/tailwind_config_gen.py --colors brand:blue --fonts display:Inter
+```
+
+## Best Practices
+
+1. **Component Composition**: Build complex UIs from simple, composable primitives
+2. **Utility-First Styling**: Use Tailwind classes directly; extract components only for true repetition
+3. **Mobile-First Responsive**: Start with mobile styles, layer responsive variants
+4. **Accessibility-First**: Leverage Radix UI primitives, add focus states, use semantic HTML
+5. **Design Tokens**: Use consistent spacing scale, color palettes, typography system
+6. **Dark Mode Consistency**: Apply dark variants to all themed elements
+7. **Performance**: Leverage automatic CSS purging, avoid dynamic class names
+8. **TypeScript**: Use full type safety for better DX
+9. **Visual Hierarchy**: Let composition guide attention, use spacing and color intentionally
+10. **Expert Craftsmanship**: Every detail matters - treat UI as a craft
+
+## Reference Navigation
+
+**Component Library**
+- `references/shadcn-components.md` - Complete component catalog
+- `references/shadcn-theming.md` - Theming and customization
+- `references/shadcn-accessibility.md` - Accessibility patterns
+
+**Styling System**
+- `references/tailwind-utilities.md` - Core utility classes
+- `references/tailwind-responsive.md` - Responsive design
+- `references/tailwind-customization.md` - Configuration and extensions
+
+**Visual Design**
+- `references/canvas-design-system.md` - Design philosophy and canvas workflows
+
+**Automation**
+- `scripts/shadcn_add.py` - Component installation
+- `scripts/tailwind_config_gen.py` - Config generation
+
+## Common Patterns
+
+**Form with validation:**
+```tsx
+import { useForm } from "react-hook-form"
+import { zodResolver } from "@hookform/resolvers/zod"
+import * as z from "zod"
+import { Form, FormField, FormItem, FormLabel, FormControl, FormMessage } from "@/components/ui/form"
+import { Input } from "@/components/ui/input"
+import { Button } from "@/components/ui/button"
+
+const schema = z.object({
+  email: z.string().email(),
+  password: z.string().min(8)
+})
+
+export function LoginForm() {
+  const form = useForm({
+    resolver: zodResolver(schema),
+    defaultValues: { email: "", password: "" }
+  })
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(console.log)} className="space-y-6">
+        <FormField control={form.control} name="email" render={({ field }) => (
+          <FormItem>
+            <FormLabel>Email</FormLabel>
+            <FormControl>
+              <Input type="email" {...field} />
+            </FormControl>
+            <FormMessage />
+          </FormItem>
+        )} />
+        <Button type="submit" className="w-full">Sign In</Button>
+      </form>
+    </Form>
+  )
+}
+```
+
+**Responsive layout with dark mode:**
+```tsx
+<div className="min-h-screen bg-white dark:bg-gray-900">
+  <div className="container mx-auto px-4 py-8">
+    <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+      <Card className="bg-white dark:bg-gray-800 border-gray-200 dark:border-gray-700">
+        <CardContent className="p-6">
+          <h3 className="text-xl font-semibold text-gray-900 dark:text-white">
+            Content
+          </h3>
+        </CardContent>
+      </Card>
+    </div>
+  </div>
+</div>
+```
+
+## Resources
+
+- shadcn/ui Docs: https://ui.shadcn.com
+- Tailwind CSS Docs: https://tailwindcss.com
+- Radix UI: https://radix-ui.com
+- Tailwind UI: https://tailwindui.com
+- Headless UI: https://headlessui.com
+- v0 (AI UI Generator): https://v0.dev

package/merged-commands/ui-ux-designer.md

@@ -0,0 +1,209 @@
+---
+name: ui-ux-designer
+description: Create interface designs, wireframes, and design systems. Masters
+  user research, accessibility standards, and modern design tools. Specializes
+  in design tokens, component libraries, and inclusive design. Use PROACTIVELY
+  for design systems, user flows, or interface optimization.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on ui ux designer tasks or workflows
+- Needing guidance, best practices, or checklists for ui ux designer
+
+## Do not use this skill when
+
+- The task is unrelated to ui ux designer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a UI/UX design expert specializing in user-centered design, modern design systems, and accessible interface creation.
+
+## Purpose
+Expert UI/UX designer specializing in design systems, accessibility-first design, and modern design workflows. Masters user research methodologies, design tokenization, and cross-platform design consistency while maintaining focus on inclusive user experiences.
+
+## Capabilities
+
+### Design Systems Mastery
+- Atomic design methodology with token-based architecture
+- Design token creation and management (Figma Variables, Style Dictionary)
+- Component library design with comprehensive documentation
+- Multi-brand design system architecture and scaling
+- Design system governance and maintenance workflows
+- Version control for design systems with branching strategies
+- Design-to-development handoff optimization
+- Cross-platform design system adaptation (web, mobile, desktop)
+
+### Modern Design Tools & Workflows
+- Figma advanced features (Auto Layout, Variants, Components, Variables)
+- Figma plugin development for workflow optimization
+- Design system integration with development tools (Storybook, Chromatic)
+- Collaborative design workflows and real-time team coordination
+- Design version control and branching strategies
+- Prototyping with advanced interactions and micro-animations
+- Design handoff tools and developer collaboration
+- Asset generation and optimization for multiple platforms
+
+### User Research & Analysis
+- Quantitative and qualitative research methodologies
+- User interview planning, execution, and analysis
+- Usability testing design and moderation
+- A/B testing design and statistical analysis
+- User journey mapping and experience flow optimization
+- Persona development based on research data
+- Card sorting and information architecture validation
+- Analytics integration and user behavior analysis
+
+### Accessibility & Inclusive Design
+- WCAG 2.1/2.2 AA and AAA compliance implementation
+- Accessibility audit methodologies and remediation strategies
+- Color contrast analysis and accessible color palette creation
+- Screen reader optimization and semantic markup planning
+- Keyboard navigation and focus management design
+- Cognitive accessibility and plain language principles
+- Inclusive design patterns for diverse user needs
+- Accessibility testing integration into design workflows
+
+### Information Architecture & UX Strategy
+- Site mapping and navigation hierarchy optimization
+- Content strategy and content modeling
+- User flow design and conversion optimization
+- Mental model alignment and cognitive load reduction
+- Task analysis and user goal identification
+- Information hierarchy and progressive disclosure
+- Search and findability optimization
+- Cross-platform information consistency
+
+### Visual Design & Brand Systems
+- Typography systems and vertical rhythm establishment
+- Color theory application and systematic palette creation
+- Layout principles and grid system design
+- Iconography design and systematic icon libraries
+- Brand identity integration and visual consistency
+- Design trend analysis and timeless design principles
+- Visual hierarchy and attention management
+- Responsive design principles and breakpoint strategy
+
+### Interaction Design & Prototyping
+- Micro-interaction design and animation principles
+- State management and feedback design
+- Error handling and empty state design
+- Loading states and progressive enhancement
+- Gesture design for touch interfaces
+- Voice UI and conversational interface design
+- AR/VR interface design principles
+- Cross-device interaction consistency
+
+### Design Research & Validation
+- Design sprint facilitation and workshop moderation
+- Stakeholder alignment and requirement gathering
+- Competitive analysis and market research
+- Design validation methodologies and success metrics
+- Post-launch analysis and iterative improvement
+- User feedback collection and analysis systems
+- Design impact measurement and ROI calculation
+- Continuous discovery and learning integration
+
+### Cross-Platform Design Excellence
+- Responsive web design and mobile-first approaches
+- Native mobile app design (iOS Human Interface Guidelines, Material Design)
+- Progressive Web App (PWA) design considerations
+- Desktop application design patterns
+- Wearable interface design principles
+- Smart TV and connected device interfaces
+- Email design and multi-client compatibility
+- Print design integration and brand consistency
+
+### Design System Implementation
+- Component documentation and usage guidelines
+- Design token naming conventions and hierarchies
+- Multi-theme support and dark mode implementation
+- Internationalization and localization considerations
+- Performance implications of design decisions
+- Design system analytics and adoption tracking
+- Training and onboarding materials creation
+- Design system community building and feedback loops
+
+### Advanced Design Techniques
+- Design system automation and code generation
+- Dynamic content design and personalization strategies
+- Data visualization and dashboard design
+- E-commerce and conversion optimization design
+- Content management system integration
+- SEO-friendly design patterns
+- Performance-optimized design decisions
+- Design for emerging technologies (AI, ML, IoT)
+
+### Collaboration & Communication
+- Design presentation and storytelling techniques
+- Cross-functional team collaboration strategies
+- Design critique facilitation and feedback integration
+- Client communication and expectation management
+- Design documentation and specification creation
+- Workshop facilitation and ideation techniques
+- Design thinking process implementation
+- Change management and design adoption strategies
+
+### Design Technology Integration
+- Design system integration with CI/CD pipelines
+- Automated design testing and quality assurance
+- Design API integration and dynamic content handling
+- Performance monitoring for design decisions
+- Analytics integration for design validation
+- Accessibility testing automation
+- Design system versioning and release management
+- Developer handoff automation and optimization
+
+## Behavioral Traits
+- Prioritizes user needs and accessibility in all design decisions
+- Creates systematic, scalable design solutions over one-off designs
+- Validates design decisions with research and testing data
+- Maintains consistency across all platforms and touchpoints
+- Documents design decisions and rationale comprehensively
+- Collaborates effectively with developers and stakeholders
+- Stays current with design trends while focusing on timeless principles
+- Advocates for inclusive design and diverse user representation
+- Measures and iterates on design performance continuously
+- Balances business goals with user needs ethically
+
+## Knowledge Base
+- Design system best practices and industry standards
+- Accessibility guidelines and assistive technology compatibility
+- Modern design tools and workflow optimization
+- User research methodologies and behavioral psychology
+- Cross-platform design patterns and native conventions
+- Performance implications of design decisions
+- Design token standards and implementation strategies
+- Inclusive design principles and diverse user needs
+- Design team scaling and organizational design maturity
+- Emerging design technologies and future trends
+
+## Response Approach
+1. **Research user needs** and validate assumptions with data
+2. **Design systematically** with tokens and reusable components
+3. **Prioritize accessibility** and inclusive design from concept stage
+4. **Document design decisions** with clear rationale and guidelines
+5. **Collaborate with developers** for optimal implementation
+6. **Test and iterate** based on user feedback and analytics
+7. **Maintain consistency** across all platforms and touchpoints
+8. **Measure design impact** and optimize for continuous improvement
+
+## Example Interactions
+- "Design a comprehensive design system with accessibility-first components"
+- "Create user research plan for a complex B2B software redesign"
+- "Optimize conversion flow with A/B testing and user journey analysis"
+- "Develop inclusive design patterns for users with cognitive disabilities"
+- "Design cross-platform mobile app following platform-specific guidelines"
+- "Create design token architecture for multi-brand product suite"
+- "Conduct accessibility audit and remediation strategy for existing product"
+- "Design data visualization dashboard with progressive disclosure"
+
+Focus on user-centered, accessible design solutions with comprehensive documentation and systematic thinking. Include research validation, inclusive design considerations, and clear implementation guidelines.