--- name: ui-ux-pro-max-skill summary: "ui-ux-pro-max-skill is an open-source Python project in the ui components space with 88.5k GitHub stars. The repository has seen commits within the last year." language: Python license: MIT repo: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill source: https://opensources.dev/resource/ui-ux-pro-max-skill health: 97 --- # ui-ux-pro-max-skill ui-ux-pro-max-skill is an open-source Python project in the ui components space with 88.5k GitHub stars. The repository has seen commits within the last year. # [UI UX Pro Max](https://uupm.cc) An AI skill that provides design intelligence for building professional UI/UX across multiple platforms and frameworks. ## What's New in v2.0 ### Intelligent Design System Generation The flagship feature of v2.0 is the **Design System Generator** - an AI-powered reasoning engine that analyzes your project requirements and generates a complete, tailored design system in seconds. ```tsx +----------------------------------------------------------------------------------------+ | TARGET: Serenity Spa - RECOMMENDED DESIGN SYSTEM | +----------------------------------------------------------------------------------------+ | | | PATTERN: Hero-Centric + Social Proof | | Conversion: Emotion-driven with trust elements | | CTA: Above fold, repeated after testimonials | | Sections: | | 1. Hero | | 2. Services | | 3. Testimonials | | 4. Booking | | 5. Contact | | | | STYLE: Soft UI Evolution | | Keywords: Soft shadows, subtle depth, calming, premium feel, organic shapes | | Best For: Wellness, beauty, lifestyle brands, premium services | | Performance: Excellent | Accessibility: WCAG AA | | | | COLORS: | | Primary: #E8B4B8 (Soft Pink) | | Secondary: #A8D5BA (Sage Green) | | CTA: #D4AF37 (Gold) | | Background: #FFF5F5 (Warm White) | | Text: #2D3436 (Charcoal) | | Notes: Calming palette with gold accents for luxury feel | | | | TYPOGRAPHY: Cormorant Garamond / Montserrat | | Mood: Elegant, calming, sophisticated | | Best For: Luxury brands, wellness, beauty, editorial | | Google Fonts: https://fonts.google.com/share?selection.family=... | | | | KEY EFFECTS: | | Soft shadows + Smooth transitions (200-300ms) + Gentle hover states | | | | AVOID (Anti-patterns): | | Bright neon colors + Harsh animations + Dark mode + AI purple/pink gradients | | | | PRE-DELIVERY CHECKLIST: | | [ ] No emojis as icons (use SVG: Heroicons/Lucide) | | [ ] cursor-pointer on all clickable elements | | [ ] Hover states with smooth transitions (150-300ms) | | [ ] Light mode: text contrast 4.5:1 minimum | | [ ] Focus states visible for keyboard nav | | [ ] prefers-reduced-motion respected | | [ ] Responsive: 375px, 768px, 1024px, 1440px | | | +----------------------------------------------------------------------------------------+ ``` ### How Design System Generation Works ```tsx ┌─────────────────────────────────────────────────────────────────┐ │ 1. USER REQUEST │ │ "Build a landing page for my beauty spa" │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 2. MULTI-DOMAIN SEARCH (5 parallel searches) │ │ • Product type matching (161 categories) │ │ • Style recommendations (67 styles) │ │ • Color palette selection (161 palettes) │ │ • Landing page patterns (24 patterns) │ │ • Typography pairing (57 font combinations) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 3. REASONING ENGINE │ │ • Match product → UI category rules │ │ • Apply style priorities (BM25 ranking) │ │ • Filter anti-patterns for industry │ │ • Process decision rules (JSON conditions) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 4. COMPLETE DESIGN SYSTEM OUTPUT │ │ Pattern + Style + Colors + Typography + Effects │ │ + Anti-patterns to avoid + Pre-delivery checklist │ └─────────────────────────────────────────────────────────────────┘ ``` ### 161 Industry-Specific Reasoning Rules The reasoning engine includes specialized rules for: CategoryExamples**Tech & SaaS**SaaS, Micro SaaS, B2B Service, Developer Tool / IDE, AI/Chatbot Platform, Cybersecurity Platform**Finance**Fintech/Crypto, Banking, Insurance, Personal Finance Tracker, Invoice & Billing Tool**Healthcare**Medical Clinic, Pharmacy, Dental, Veterinary, Mental Health, Medication Reminder**E-commerce**General, Luxury, Marketplace (P2P), Subscription Box, Food Delivery**Services**Beauty/Spa, Restaurant, Hotel, Legal, Home Services, Booking & Appointment**Creative**Portfolio, Agency, Photography, Gaming, Music Streaming, Photo/Video Editor**Lifestyle**Habit Tracker, Recipe & Cooking, Meditation, Weather, Diary, Mood Tracker**Emerging Tech**Web3/NFT, Spatial Computing, Quantum Computing, Autonomous Drone Fleet Each rule includes: - **Recommended Pattern** - Landing page structure - **Style Priority** - Best matching UI styles - **Color Mood** - Industry-appropriate palettes - **Typography Mood** - Font personality matching - **Key Effects** - Animations and interactions - **Anti-Patterns** - What NOT to do (e.g., "AI purple/pink gradients" for banking) ## Features - **67 UI Styles** - Glassmorphism, Claymorphism, Minimalism, Brutalism, Neumorphism, Bento Grid, Dark Mode, AI-Native UI, and more - **161 Color Palettes** - Industry-specific palettes aligned 1:1 with the 161 product types - **57 Font Pairings** - Curated typography combinations with Google Fonts imports - **25 Chart Types** - Recommendations for dashboards and analytics - **15 Tech Stacks** - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel - **99 UX Guidelines** - Best practices, anti-patterns, and accessibility rules - **161 Reasoning Rules** - Industry-specific design system generation (NEW in v2.0) ### Available Styles (67) #StyleBest For1Minimalism & Swiss StyleEnterprise apps, dashboards, documentation2NeumorphismHealth/wellness apps, meditation platforms3GlassmorphismModern SaaS, financial dashboards4BrutalismDesign portfolios, artistic projects53D & HyperrealismGaming, product showcase, immersive6Vibrant & Block-basedStartups, creative agencies, gaming7Dark Mode (OLED)Night-mode apps, coding platforms8Accessible & EthicalGovernment, healthcare, education9ClaymorphismEducational apps, children's apps, SaaS10Aurora UIModern SaaS, creative agencies11Retro-FuturismGaming, entertainment, music platforms12Flat DesignWeb apps, mobile apps, startup MVPs13SkeuomorphismLegacy apps, gaming, premium products14Liquid GlassPremium SaaS, high-end e-commerce15Motion-DrivenPortfolio sites, storytelling platforms16Micro-interactionsMobile apps, touchscreen UIs17Inclusive DesignPublic services, education, healthcare18Zero InterfaceVoice assistants, AI platforms19Soft UI EvolutionModern enterprise apps, SaaS20NeubrutalismGen Z brands, startups, Figma-style21Bento Box GridDashboards, product pages, portfolios22Y2K AestheticFashion brands, music, Gen Z23Cyberpunk UIGaming, tech products, crypto apps24Organic BiophilicWellness apps, sustainability brands25AI-Native UIAI products, chatbots, copilots26Memphis DesignCreative agencies, music, youth brands27VaporwaveMusic platforms, gaming, portfolios28Dimensional LayeringDashboards, card layouts, modals29Exaggerated MinimalismFashion, architecture, portfolios30Kinetic TypographyHero sections, marketing sites31Parallax StorytellingBrand storytelling, product launches32Swiss Modernism 2.0Corporate sites, architecture, editorial33HUD / Sci-Fi FUISci-fi games, space tech, cybersecurity34Pixel ArtIndie games, retro tools, creative35Bento GridsProduct features, dashboards, personal36Spatial UI (VisionOS)Spatial computing apps, VR/AR37E-Ink / PaperReading apps, digital newspapers38Gen Z Chaos / MaximalismGen Z lifestyle, music artists39Biomimetic / Organic 2.0Sustainability tech, biotech, health40Anti-Polish / Raw AestheticCreative portfolios, artist sites41Tactile Digital / Deformable UIModern mobile apps, playful brands42Nature DistilledWellness brands, sustainable products43Interactive Cursor DesignCreative portfolios, interactive44Voice-First MultimodalVoice assistants, accessibility apps453D Product PreviewE-commerce, furniture, fashion46Gradient Mesh / Aurora EvolvedHero sections, backgrounds, creative47Editorial Grid / MagazineNews sites, blogs, magazines48Chromatic Aberration / RGB SplitMusic platforms, gaming, tech49Vintage Analog / Retro FilmPhotography, music/vinyl brands #StyleBest For1Hero-Centric DesignProducts with strong visual identity2Conversion-OptimizedLead generation, sales pages3Feature-Rich ShowcaseSaaS, complex products4Minimal & DirectSimple products, apps5Social Proof-FocusedServices, B2C products6Interactive Product DemoSoftware, tools7Trust & AuthorityB2B, enterprise, consulting8Storytelling-DrivenBrands, agencies, nonprofits #StyleBest For1Data-Dense DashboardComplex data analysis2Heat Map & Heatmap StyleGeographic/behavior data3Executive DashboardC-suite summaries4Real-Time MonitoringOperations, DevOps5Drill-Down AnalyticsDetailed exploration6Comparative Analysis DashboardSide-by-side comparisons7Predictive AnalyticsForecasting, ML insights8User Behavior AnalyticsUX research, product analytics9Financial DashboardFinance, accounting10Sales Intelligence DashboardSales teams, CRM ## Installation ### Using Claude Marketplace (Claude Code) Install directly in Claude Code with two commands: ```tsx /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-max@ui-ux-pro-max-skill ``` ### Using CLI (Recommended) ```bash # Install CLI globally npm install -g uipro-cli # Go to your project cd /path/to/your/project # Install for your AI assistant uipro init --ai claude # Claude Code uipro init --ai cursor # Cursor uipro init --ai windsurf # Windsurf uipro init --ai antigravity # Antigravity uipro init --ai copilot # GitHub Copilot uipro init --ai kiro # Kiro uipro init --ai codex # Codex CLI uipro init --ai qoder # Qoder uipro init --ai roocode # Roo Code uipro init --ai gemini # Gemini CLI uipro init --ai trae # Trae uipro init --ai opencode # OpenCode uipro init --ai continue # Continue uipro init --ai codebuddy # CodeBuddy uipro init --ai droid # Droid (Factory) uipro init --ai kilocode # KiloCode uipro init --ai warp # Warp uipro init --ai augment # Augment uipro init --ai all # All assistants ``` ### Global Install (Available for All Projects) ```bash uipro init --ai claude --global # Install to ~/.claude/skills/ uipro init --ai cursor --global # Install to ~/.cursor/skills/ ``` ### Other CLI Commands ```bash uipro versions # List available versions uipro update # Update to latest version uipro init --offline # Skip GitHub download, use bundled assets uipro uninstall # Remove skill (auto-detect platform) uipro uninstall --ai claude # Remove specific platform uipro uninstall --global # Remove from global install ``` ## Prerequisites Python 3.x is required for the search script. ```bash # Check if Python is installed python3 --version # macOS brew install python3 # Ubuntu/Debian sudo apt update && sudo apt install python3 # Windows winget install Python.Python.3.12 ``` ## Usage ### Skill Mode (Auto-activate) **Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment The skill activates automatically when you request UI/UX work. Just chat naturally: ```tsx Build a landing page for my SaaS product ``` > **Trae**: Switch to **SOLO** mode first. The skill will activate for UI/UX requests. ### Workflow Mode (Slash Command) **Supported:** Kiro, GitHub Copilot, Roo Code, KiloCode Use the slash command to invoke the skill: ```tsx /ui-ux-pro-max Build a landing page for my SaaS product ``` ### Example Prompts ```tsx Build a landing page for my SaaS product Create a dashboard for healthcare analytics Design a portfolio website with dark mode Make a mobile app UI for e-commerce Build a fintech banking app with dark theme ``` ### How It Works 1. **You ask** - Request any UI/UX task (build, design, create, implement, review, fix, improve) 2. **Design System Generated** - The AI automatically generates a complete design system using the reasoning engine 3. **Smart recommendations** - Based on your product type and requirements, it finds the best matching styles, colors, and typography 4. **Code generation** - Implements the UI with proper colors, fonts, spacing, and best practices 5. **Pre-delivery checks** - Validates against common UI/UX anti-patterns ### Supported Stacks The skill provides stack-specific guidelines for: CategoryStacks**Web (HTML)**HTML + Tailwind (default)**React Ecosystem**React, Next.js, shadcn/ui**Vue Ecosystem**Vue, Nuxt.js, Nuxt UI**Angular**Angular**PHP**Laravel (Blade, Livewire, Inertia.js)**Other Web**Svelte, Astro**iOS**SwiftUI**Android**Jetpack Compose**Cross-Platform**React Native, Flutter Just mention your preferred stack in the prompt, or let it default to HTML + Tailwind. ## Design System Command (Advanced) For direct access to the design system generator: > Note: If you installed via Continue, replace `.claude/skills/` with `.continue/skills/` in the commands below. For Droid (Factory), use `.factory/skills/`. ```bash # Generate design system with ASCII output python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa" # Generate with Markdown output python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown # Domain-specific search python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart # Stack-specific guidelines python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind ``` ### Persist Design System (Master + Overrides Pattern) Save your design system to files for **hierarchical retrieval across sessions**: ```bash # Generate and persist to design-system/MASTER.md python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" # Also create a page-specific override file python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard" ``` This creates a `design-system/` folder structure: ```tsx design-system/ ├── MASTER.md # Global Source of Truth (colors, typography, spacing, components) └── pages/ └── dashboard.md # Page-specific overrides (only deviations from Master) ``` **How hierarchical retrieval works:** 1. When building a specific page (e.g., "Checkout"), first check `design-system/pages/checkout.md` 2. If the page file exists, its rules **override** the Master file 3. If not, use `design-system/MASTER.md` exclusively **Context-aware retrieval prompt:** ```tsx I am building the [Page Name] page. Please read design-system/MASTER.md. Also check if design-system/pages/[page-name].md exists. If the page file exists, prioritize its rules. If not, use the Master rules exclusively. Now, generate the code... ``` ## Architecture & Contributing ### For Users The codebase has been restructured to use a **template-based generation system**. All platform-specific files (`.cursor/`, `.windsurf/`, `.kiro/`, `.factory/`, etc.) are now generated dynamically by the CLI. **Always use the CLI to install:** ```bash npm install -g uipro-cli uipro init --ai ``` This ensures you get the latest templates and correct file structure for your AI assistant. ### For Contributors If you want to contribute to this project: ```bash # 1. Clone the repository git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git cd ui-ux-pro-max-skill # 2. Understand the structure src/ui-ux-pro-max/ # Source of truth (data, scripts, templates) cli/ # CLI installer (generates files from templates) .claude/ # Local dev/test for Claude Code skill .factory/ # Local dev/test for Droid (Factory) skill # 3. Make changes in src/ui-ux-pro-max/ # - data/*.csv → Database files # - scripts/*.py → Search engine & design system # - templates/ → Platform-specific templates # 4. Sync to CLI and test locally cp -r src/ui-ux-pro-max/data/* cli/assets/data/ cp -r src/ui-ux-pro-max/scripts/* cli/assets/scripts/ cp -r src/ui-ux-pro-max/templates/* cli/assets/templates/ # 5. Build and test CLI cd cli && bun run build node dist/index.js init --ai claude --offline # Test in a temp folder # 6. Create PR (never push directly to main) git checkout -b feat/your-feature git commit -m "feat: description" git push -u origin feat/your-feature gh pr create ``` See [CLAUDE.md](CLAUDE.md) for detailed development guidelines. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=nextlevelbuilder/ui-ux-pro-max-skill&type=Date)](https://star-history.com/#nextlevelbuilder/ui-ux-pro-max-skill&Date) ## License This project is licensed under the [MIT License](LICENSE).