# [UI UX Pro Max](https://uupm.cc)
🇦🇿 Azərbaycanca | 🇮🇩 Bahasa Indonesia | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇻🇳 Tiếng Việt | 🇨🇳 简体中文 | 🇺🇸 English | 🇫🇷 Français | 🇮🇷 فارسی
یک مهارت هوش مصنوعی که برای ساخت رابطهای کاربری حرفهای (UI) و تجربههای کاربری (UX) در پلتفرمها و فریمورکهای مختلف، هوشمندی و راهنماییهای تخصصی طراحی ارائه میکند.
اگر این پروژه برایتان مفید است، میتوانید از توسعهٔ آن حمایت کنید:
پروژههای دیگر
NextLevelBuilder.io | GoClaw.sh | AgentKit.best | TOSE.sh
ایدهٔ خود را به یک صحنهٔ سهبعدی تبدیل کنید که ارزش کاوش داشته باشد.
الهام بصری، نه معیار سنجش. این پروژهٔ ارائهشده توسط نویسنده، پیش از ایجاد این مهارت ضبط شده است؛ رابط کاربری آن شامل زبان ویتنامی است. این ویدئو صرفاً محتوایی تاریخی است، نه دموی انگلیسی یا آزمایش زمان اجرای مهارت. برای اطلاعات منبع رسانه به مستندات منشأ رسانه مراجعه کنید.
🤌 وبسایت: https://3dviz.dev/
--- ## تازههای نسخهٔ 2.0 ### تولید هوشمند سیستم طراحی مهمترین قابلیت نسخهٔ 2.0، **مولد سیستم طراحی (Design System Generator)** است؛ یک موتور استدلال مبتنی بر هوش مصنوعی که نیازمندیهای پروژهٔ شما را تحلیل میکند و در چند ثانیه یک سیستم طراحی کامل و متناسب با همان پروژه میسازد. نمونهٔ زیر یک سیستم طراحی پیشنهادی برای یک مرکز اسپا را نشان میدهد. ساختار، مقادیر و کدهای نمونه برای حفظ خوانایی و امکان مقایسه، بدون تغییر نگه داشته شدهاند: ```text +----------------------------------------------------------------------------------------+ | 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: cost:low | Accessibility: risk:conditional; verify requirements | | | | 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 + Context-appropriate transitions + 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 | | [ ] Interaction timing follows the platform, component, and user preference | | [ ] Light mode: text contrast 4.5:1 minimum | | [ ] Focus states visible for keyboard nav | | [ ] prefers-reduced-motion respected | | [ ] Text, chips, and badges reflow without clipping or broken labels | | [ ] Responsive: 375px, 768px, 1024px, 1440px | | | +----------------------------------------------------------------------------------------+ ``` ### تولید سیستم طراحی چگونه کار میکند؟ ```text ┌─────────────────────────────────────────────────────────────────┐ │ 1. USER REQUEST │ │ "Build a landing page for my beauty spa" │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 2. MULTI-DOMAIN SEARCH (5 parallel searches) │ │ • Product type matching (192 categories) │ │ • Style recommendations (80 searchable; 51 active) │ │ • Color palette selection (192 palettes) │ │ • Landing page patterns (34 patterns) │ │ • Typography pairing (74 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 │ └─────────────────────────────────────────────────────────────────┘ ``` ### ۱۹۲ قانون استدلال متناسب با صنایع مختلف موتور استدلال شامل قوانین تخصصی برای حوزههای زیر است: | دستهبندی | نمونهها | |----------|----------| | **فناوری و SaaS** | SaaS، Micro SaaS، خدمات B2B، ابزار توسعهدهنده / IDE، پلتفرم هوش مصنوعی و چتبات، پلتفرم امنیت سایبری | | **مالی** | فینتک/رمزارز، بانکداری، بیمه، مدیریت مالی شخصی، ابزار صدور فاکتور و صورتحساب | | **سلامت و درمان** | کلینیک پزشکی، داروخانه، دندانپزشکی، دامپزشکی، سلامت روان، یادآور مصرف دارو | | **تجارت الکترونیک** | فروشگاه عمومی، فروشگاه لوکس، بازارگاه (P2P)، جعبهٔ اشتراکی، تحویل غذا | | **خدمات** | زیبایی/اسپا، رستوران، هتل، خدمات حقوقی، خدمات منزل، رزرو و نوبتدهی | | **خلاقیت** | نمونهکار، آژانس، عکاسی، بازی، پخش موسیقی، ویرایش عکس/ویدئو | | **سبک زندگی** | پیگیری عادتها، دستور پخت و آشپزی، مدیتیشن، آبوهوا، دفتر خاطرات، پیگیری خلقوخو | | **فناوریهای نوظهور** | Web3/NFT، رایانش فضایی، رایانش کوانتومی، ناوگان پهپادهای خودران | هر قانون شامل موارد زیر است: - **الگوی پیشنهادی (Recommended Pattern):** ساختار صفحهٔ فرود - **اولویت سبک (Style Priority):** سبکهای رابط کاربری که بیشترین تطابق را دارند - **حالوهوای رنگ (Color Mood):** پالتهای متناسب با صنعت - **حالوهوای تایپوگرافی (Typography Mood):** شخصیت و حسوحال فونت - **جلوههای کلیدی (Key Effects):** انیمیشنها و تعاملها - **الگوهای نامناسب (Anti-Patterns):** مواردی که نباید استفاده شوند؛ برای مثال، استفاده از گرادیانهای بنفش/صورتی هوش مصنوعی برای یک سامانهٔ بانکداری ## قابلیتها - **۷۹ سبک رابط کاربری قابل جستوجو (۵۰ سبک فعال):** از جمله Glassmorphism، Claymorphism، Minimalism، Brutalism، Neumorphism، Bento Grid، Dark Mode، AI-Native UI و موارد دیگر - **۱۹۲ پالت رنگ:** پالتهای اختصاصی هر صنعت که بهصورت یکبهیک با ۱۹۲ نوع محصول هماهنگ شدهاند - **۷۴ ترکیب فونت:** ترکیبهای گزینششدهٔ تایپوگرافی همراه با امکان واردکردن فونت از Google Fonts - **۲۵ نوع نمودار:** پیشنهادهایی برای داشبوردها و تحلیل داده - **۲۲ پشتهٔ فناوری:** React، Next.js، Astro، Vue، Nuxt.js، Nuxt UI، Svelte، SwiftUI، React Native، Flutter، HTML+Tailwind، shadcn/ui، Jetpack Compose، Angular، Laravel، Three.js، JavaFX، WPF، WinUI 3، UWP، Avalonia و Uno Platform - **۱۱۹ راهنمای UX:** بهترین روشها، الگوهای نامناسب، قواعد دسترسپذیری، چیدمان مقاوم متن، برچسبهای فشرده و تعاملهای قابل لغو - **۱۹۲ قانون استدلال:** تولید سیستم طراحی متناسب با صنعت (قابلیت جدید در نسخهٔ 2.0) ### متن انعطافپذیر و رابط کاربری فشرده راهنماها اکنون خطاهای رایج محیط واقعی محصول را نیز پوشش میدهند؛ از جمله مشکلات عنوانها، واژههای طولانی، چیپها، نشانها و تعاملهای کوتاه که ممکن است نیمهکاره قطع شوند: - شکستن متعادل سطرهای عنوان، یک بهبود تدریجی است و تضمین نمیکند که واژهای مشخص حتماً در آخرین خط قرار بگیرد. طراحی باید با شکستن طبیعی متن در عرضها، فونتها و زبانهای مختلف نیز درست کار کند. - متنهای ضروری نباید در عرضهای کم، بزرگنمایی مرورگر، تغییر مقیاس متن یا تنظیم فاصلهگذاری توسط کاربر بریده شوند. نشانیهای اینترنتی و شناسههای طولانی باید بتوانند بهشکل ایمن به سطر بعد منتقل شوند. - مجموعهٔ چیپها و برچسبها باید به سطر بعد منتقل شوند یا امکان نمایش موارد بیشتر با گزینهای مانند `+n` داشته باشند. در صورت امکان، برچسب فشرده باید کامل نمایش داده شود؛ اگر کوتاهسازی اجتنابناپذیر است، کاربران صفحهکلید، ماوس و صفحهٔ لمسی باید راهی دسترسپذیر برای مشاهدهٔ مقدار کامل داشته باشند. - معنای نشانها نباید فقط به رنگ وابسته باشد. چیپهای تعاملی باید معنای بومی و استاندارد، حالت تمرکز قابل مشاهده و وضعیت قابل تشخیص برای فناوریهای کمکی داشته باشند؛ شمارندههای زنده نیز باید زمینهٔ معناداری ارائه کنند. - تعاملهای سریع ممکن است باعث لغو انیمیشن شوند، اما وضعیت معنایی نهایی، تمرکز و محتوا باید همچنان صحیح باقی بمانند. زمانبندی باید متناسب با پلتفرم و مؤلفه انتخاب شود و ترجیح کاربر برای کاهش حرکت نیز رعایت شود. ### دستهبندی سبکها این کاتالوگ شامل **۷۹ سبک قابل جستوجو** است که با شناسهها و نامهای جایگزین پایدار پشتیبانی میشوند: | وضعیت | تعداد | رفتار جستوجو | |--------|------:|----------------| | فعال (Active) | ۵۰ | در پیشنهادهای معمول قرار میگیرند و بهصورت پیشفرض در گالری نمایش داده میشوند | | تکمیلی (Supplemental) | ۲۹ | برای درخواستهای دقیق یا اشارهٔ صریح به گونه/سیستم برگردانده میشوند؛ از طریق فیلتر وضعیت گالری نیز در دسترساند | | منسوخ (Deprecated) | ۹ | از رتبهبندی معمول کنار گذاشته شدهاند؛ نامهای قدیمی به سبک یا الگوی صفحهٔ فرود مرجع هدایت میشوند | مجموعهٔ فعال شامل ۴۳ خانوادهٔ بصری عمومی، ۲ سبک ویژهٔ موبایل، ۴ سیستم رسمی پلتفرم/طراحی، ۱ متریال پلتفرمی و ۱ سبک اصلی تحلیل داده است. سیستمهای رسمی فعلی شامل Fluent 2، Shopify Polaris، Adobe Spectrum و Apple Native Experience هستند؛ Liquid Glass بهعنوان متریال پلتفرم اپل در نظر گرفته شده، Material 3 Expressive همچنان یک گونهٔ موبایلی از Material است و Spectrum 2 در گروه سبکهای تکمیلی قرار دارد. ساختارهای صفحهٔ فرود در مجموعهدادهٔ جداگانهای با ۳۴ الگو نگهداری میشوند و در رتبهبندی BM25 با سبکهای بصری رقابت نمیکنند. برای مشاهدهٔ دستهبندی کامل و فرادادههای دارای اطلاعات منشأ، فایل [`styles.csv`](src/ui-ux-pro-max/data/styles.csv) را ببینید. ## 💎 مقایسهٔ نسخهٔ پایه و نسخهٔ پریمیوم بسیاری از کاربران دربارهٔ تفاوت نسخهٔ متنباز و نسخهٔ پریمیوم سؤال میکنند. در ادامه جزئیات آمده است تا بتوانید نسخهٔ مناسب جریان کاری خود را انتخاب کنید. ### 🟢 نسخهٔ پایه (همین مخزن) - **کاملاً متنباز:** مناسب توسعهدهندگان مستقل، علاقهمندان و پروژههای معمول - **هوشمندی اصلی UI/UX:** دسترسی کامل به ۷۹ سبک قابل جستوجو (۵۰ سبک فعال)، ۱۹۲ نوع محصول، پالتهای رنگ و ترکیبهای گزینششدهٔ فونت - **پیشنهادهای هوشمند:** موتور جستوجوی داخلی BM25 برای تطبیق دقیق طراحی - **پشتیبانی چندپلتفرمی:** راهنماهای اختصاصی برای ۲۲ فریمورک و فناوری اصلی (React، Vue، Tailwind، iOS، Android و غیره) - **تولید سیستم طراحی:** تولید فوری قوانین، الگوها و منطق UI متناسب با پروژه از طریق CLI ### 🟡 نسخهٔ پریمیوم - **مهارتهای گستردهتر طراحی برند:** فراتر از UI/UX؛ شامل تولید هویت برند، طراحی لوگو، برنامههای هویت سازمانی (CIP)، بنر، اسلاید ارائه و طراحی آیکون اختصاصی - **ساخت پیشرفتهٔ داراییهای بصری:** یکپارچگی عمیق با تولید تصویر مبتنی بر هوش مصنوعی برای ساخت داراییهای بصری واقعی، نه صرفاً تصاویر جایگزین - **معماری سازمانی:** معماری جامعتر و مقیاسپذیرتر توکنهای طراحی، مناسب استقرار در تیمهای بزرگ - **پشتیبانی اولویتدار:** کمک فنی اختصاصی برای تیمها و متخصصانی که به جریان کاری طراحی کامل و بدون وقفه نیاز دارند 👉 *برای جزئیات بیشتر دربارهٔ ارتقا به نسخهٔ پریمیوم، به [uupm.cc](https://uupm.cc) مراجعه کنید.* ## نصب ### از طریق Claude Marketplace (Claude Code) با اجرای دو دستور زیر، مستقیماً در Claude Code نصب کنید: ```text /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-max@ui-ux-pro-max-skill ``` ### از طریق CLI (روش پیشنهادی) ```bash # Install CLI globally npm install -g ui-ux-pro-max-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 codewhale # CodeWhale uipro init --ai zcode # ZCode uipro init --ai kimi # Kimi Code uipro init --ai amazonq # Amazon Q Developer uipro init --ai openclaw # OpenClaw (.agents/skills/) uipro init --ai autoclaw # AutoClaw (skills/ or ~/.openclaw-autoclaw/skills) uipro init --ai universal # Universal / Agent Standard (.agents/skills/) uipro init --ai all # All assistants ``` نام بستهٔ npm برابر `ui-ux-pro-max-cli` است؛ بااینحال، فرمانی که نصب میکند همچنان `uipro` است. نسخههای قدیمیتر `uipro-cli` منسوخ هستند و نباید برای داراییهای فعلی استفاده شوند. ### نصب سراسری (قابل استفاده در همهٔ پروژهها) ```bash uipro init --ai claude --global # Install to ~/.claude/skills/ uipro init --ai cursor --global # Install to ~/.cursor/skills/ uipro init --ai zcode --global # Install to ~/.zcode/skills/ uipro init --ai kimi --global # Install to ~/.kimi-code/skills/ uipro init --ai universal --global # Install to ~/.agents/skills/ ``` ### سایر فرمانهای CLI ```bash uipro versions # List available versions uipro update # Refresh skill files from installed CLI package uipro update --global # Refresh global skill files from installed CLI package uipro init --offline # Compatibility flag; installs bundled templates uipro init --dry-run # Preview install actions without writing files uipro uninstall # Remove skill (auto-detect platform) uipro uninstall --ai claude # Remove specific platform uipro uninstall --global # Remove from global install ``` ## پیشنیازها برای اجرای اسکریپت جستوجو به Python 3.x نیاز دارید. این اسکریپت فقط از کتابخانهٔ استاندارد پایتون استفاده میکند؛ اسکریپتها چیزی نصب نمیکنند و هیچ درخواست شبکهای ارسال نمیکنند. برای بررسی نصب بودن Python: ```bash python3 --version ``` اگر Python نصب نیست، آن را از [python.org](https://www.python.org/downloads/) یا با مدیر بستهٔ سیستمعامل خود (Homebrew، apt یا winget) نصب کنید. این مراحل نصب برای **شما، بهعنوان کاربر انسانی** هستند؛ عاملهای هوش مصنوعی که از این مهارت استفاده میکنند نباید خودسرانه نرمافزاری روی دستگاه شما نصب کنند و طبق دستورالعمل باید ابتدا از شما اجازه بخواهند. ## نحوهٔ استفاده ### حالت مهارت (فعالسازی خودکار) **پشتیبانیشده:** Claude Code، Cursor، Windsurf، Antigravity، Codex CLI، Continue، Gemini CLI، OpenCode، Qoder، CodeBuddy، Droid (Factory)، KiloCode، Warp، Augment، CodeWhale، ZCode، Kimi Code، Amazon Q Developer، OpenClaw و GitHub Copilot این مهارت هنگام درخواست کارهای UI/UX بهصورت خودکار فعال میشود. کافی است به زبان طبیعی درخواست خود را مطرح کنید: ```text Build a landing page for my SaaS product ``` > **Trae:** ابتدا حالت **SOLO** را فعال کنید. سپس مهارت برای درخواستهای UI/UX فعال خواهد شد. ### حالت جریان کاری (فرمان اسلش) **پشتیبانیشده:** Kiro، Roo Code و KiloCode برای فراخوانی مهارت از فرمان اسلش استفاده کنید: ```text /ui-ux-pro-max Build a landing page for my SaaS product ``` ### نمونه درخواستها ```text 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 ``` ### اعمال یک تم روی برنامهٔ موجود پس از [نصب مهارت](#نصب)، برنامهٔ خود را در دستیار هوش مصنوعی باز کنید و درخواستی مشابه نمونهٔ زیر بدهید. در حالت Workflow، عبارت `/ui-ux-pro-max` را در ابتدای درخواست قرار دهید. ```text Use the ui-ux-pro-max skill to retheme my existing React app. Target style: Minimalism & Swiss Style. First inspect the framework and styling-library versions, routes, components, styles, and existing theme tokens. Keep the current component structure, behavior, and business logic. Reuse and update the existing semantic tokens for colors, typography, spacing, radii, shadows, and interaction states; add missing tokens rather than creating a parallel theme system. Replace hard-coded styles one component at a time. Verify contrast, keyboard focus, responsive layouts, and all supported light/dark modes. Summarize changed files and any remaining hard-coded styles. ``` عبارت `Minimalism & Swiss Style` را با سبک دلخواه خود از [کاتالوگ سبکها](src/ui-ux-pro-max/data/styles.csv) یا جهتگیری بصری موردنظرتان جایگزین کنید. نتایج جستوجو راهنمای طراحی ارائه میکنند؛ اما بهصورت خودکار کد برنامهٔ شما را بازنویسی نمیکنند. **چکلیست تغییر تم:** - **بررسی (Audit):** مقادیر ثابت و hard-coded مرتبط با تم را در stylesheetها، استایلهای درونخطی و ابزارهایی مانند `bg-blue-600` یا `text-[#1e293b]` پیدا کنید. - **نگاشت (Map):** نقشهای معنایی مانند `background`، `surface`، `foreground`، `primary`، `border` و `ring` را در سیستم استایل فعلی برنامه بهکار بگیرید. نقشهای لازم را مطابق قراردادهای نسخهٔ نصبشدهٔ کتابخانه اضافه کنید. - **مهاجرت (Migrate):** مقادیر ثابت را در دستههای کوچک از مؤلفهها با ارجاع به توکنها جایگزین کنید. تغییر توکنها بهتنهایی روی استایلهایی که از آنها استفاده نمیکنند اثری ندارد. - **اعتبارسنجی (Verify):** کنتراست متن و رابط، حالتهای hover/focus/disabled، چیدمان واکنشگرا و تمام تمهای پشتیبانیشده را پس از هر مرحله بررسی کنید. ### سازوکار عملکرد 1. **شما درخواست میدهید:** هر نوع کار UI/UX را درخواست میکنید (ساخت، طراحی، ایجاد، پیادهسازی، بازبینی، رفع اشکال یا بهبود). 2. **سیستم طراحی تولید میشود:** هوش مصنوعی با استفاده از موتور استدلال، بهطور خودکار یک سیستم طراحی کامل تولید میکند. 3. **پیشنهادهای هوشمند ارائه میشوند:** بر اساس نوع محصول و نیازمندیهای شما، سبکها، رنگها و تایپوگرافی مناسب انتخاب میشوند. 4. **کد تولید میشود:** رابط با رنگها، فونتها، فاصلهگذاری و بهترین روشهای طراحی پیادهسازی میشود. 5. **بررسیهای پیش از تحویل انجام میشوند:** خروجی از نظر الگوهای نامناسب رایج در UI/UX اعتبارسنجی میشود. ### پشتههای فناوری پشتیبانیشده این مهارت برای فناوریهای زیر راهنمای اختصاصی ارائه میدهد: | دستهبندی | فناوریها | |----------|-----------| | **وب (HTML)** | HTML + Tailwind (پیشفرض) | | **اکوسیستم React** | React، Next.js، shadcn/ui | | **اکوسیستم Vue** | Vue، Nuxt.js، Nuxt UI | | **Angular** | Angular | | **PHP** | Laravel (Blade، Livewire، Inertia.js) | | **سایر فناوریهای وب** | Svelte، Astro، Three.js | | **دسکتاپ** | JavaFX، WPF، WinUI 3، Avalonia، Uno Platform، UWP | | **iOS** | SwiftUI | | **Android** | Jetpack Compose | | **چندسکویی** | React Native، Flutter | کافی است فناوری موردنظر خود را در درخواست ذکر کنید یا اجازه دهید سیستم بهصورت پیشفرض از HTML + Tailwind استفاده کند. ## نمونهها ### نمونهٔ قبل و بعد: داشبورد عملیات یک داشبورد سادهٔ عملیات ([نسخهٔ قبل](https://skill-fixture-before.theroost.dev)) با استفاده از سیستم طراحیای که UI UX Pro Max برای آن تولید کرده است، بازطراحی شده ([نسخهٔ بعد](https://ui-ux-pro-max-after.theroost.dev)). فرمان مورد استفاده: `search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4` *این نمونه صرفاً برای نمایش است و توسط جامعهٔ کاربران ارائه شده؛ دموی رسمی، معیار سنجش یا آزمایش زمان اجرای مهارت نیست.* ## فرمان سیستم طراحی (پیشرفته) برای دسترسی مستقیم به مولد سیستم طراحی: > نکته: اگر از طریق Continue نصب کردهاید، در فرمانهای زیر بهجای `.claude/skills/` از `.continue/skills/` استفاده کنید. برای Droid (Factory) از `.factory/skills/`، برای ZCode از `.zcode/skills/` و برای Amazon Q Developer از `.amazonq/skills/` استفاده کنید. (Amazon Q فقط قانون موجود در `.amazonq/rules/ui-ux-pro-max.md` را بهصورت خودکار بارگذاری میکند؛ دادهها و اسکریپتهای `.amazonq/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 python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux # RTL / Arabic, Hebrew, Persian interfaces (style and product domains) python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech" --domain product --rtl=partial # 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 python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx ``` جستوجوی پشتههای وب با نسخهٔ فناوری سازگار است. جستوجوهایی که نسخهٔ قدیمیتری را مشخص نمیکنند، راهنمای فعال و فعلی را برمیگردانند. عبارتهای صریح قدیمی یا نسخههای پیشین (برای مثال `Svelte 4` یا `Next.js 15`) فقط ردیفهای گزینششدهٔ مربوط به نسخههای قدیمی را برمیگردانند و با برچسبهای `Status` و `Applies To` مشخص میشوند. اگر راهنمای قدیمی منطبق وجود نداشته باشد، بهجای ترکیب نسلهای مختلف فریمورک، نتیجهای برگردانده نمیشود. ### سازگاری RTL (`--rtl`) هر ردیف سبک و محصول دارای مقدار `rtl_level` برای رابطهای راستبهچپ (عربی، عبری، فارسی و اردو) است: | سطح | معنی | |-----|------| | `full` | مستقل از جهت نوشتار است؛ چیدمان بدون تغییر خاصی پس از آینهایشدن نیز درست کار میکند. | | `partial` | بهخوبی آینهای میشود، اما برخی مؤلفهها و حرکتها به تنظیم نیاز دارند. | | `caveats` | سبک یا محصول به جهت خواندن وابسته است؛ مانند تایپوگرافی جنبشی، خط زمانی چپبهراست، محیط کد/ترمینال، نقشهها و ترتیب صندلیها. | ```bash # Only styles that mirror without extra work python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full # All levels, filtered results still tagged with rtl_level python3 .claude/skills/ui-ux-pro-max/scripts/search.py "mobile" --domain style --rtl ``` گزینهٔ `--rtl` به تعیین صریح `--domain style` یا `--domain product` نیاز دارد. فیلتر پس از رتبهبندی و پیش از محدودسازی نتایج با `-n/--max-results` اعمال میشود؛ بنابراین محدودیت تعداد نتایج، ردیف منطبق را پنهان نمیکند. استفاده از آن همراه با `--design-system` و `--stack` مجاز نیست. ### ذخیرهٔ سیستم طراحی (الگوی Master + Overrides) سیستم طراحی خود را برای **بازیابی سلسلهمراتبی در نشستهای مختلف** در فایلها ذخیره کنید: ```bash # Generate and persist to design-system/myapp/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" ``` این فرمان ساختار پوشهٔ `design-system/` را ایجاد میکند: ```text design-system/ └── myapp/ # One folder per project (slug of -p "MyApp") ├── MASTER.md # Global Source of Truth (colors, typography, spacing, components) └── pages/ └── dashboard.md # Page-specific overrides (only deviations from Master) ``` **بازیابی سلسلهمراتبی چگونه کار میکند؟** 1. هنگام ساخت یک صفحهٔ مشخص (برای مثال «Checkout»)، ابتدا فایل `design-system/[project-slug]/pages/checkout.md` را بررسی کنید. 2. اگر فایل صفحه وجود داشته باشد، قوانین آن بر فایل Master **اولویت دارند**. 3. اگر فایل صفحه وجود نداشته باشد، فقط از `design-system/[project-slug]/MASTER.md` استفاده کنید. **نمونهٔ درخواست برای بازیابی آگاه از زمینه:** ```text I am building the [Page Name] page. Please read design-system/[project-slug]/MASTER.md. Also check if design-system/[project-slug]/pages/[page-name].md exists. If the page file exists, prioritize its rules. If not, use the Master rules exclusively. Now, generate the code... ``` ## معماری و مشارکت در پروژه ### برای کاربران ساختار کد پروژه بازطراحی شده تا از **سیستم تولید مبتنی بر قالب (Template-based)** استفاده کند. تمام فایلهای مخصوص پلتفرم (`.cursor/`، `.windsurf/`، `.kiro/`، `.factory/` و غیره) اکنون بهصورت پویا توسط CLI تولید میشوند. **همیشه برای نصب از CLI استفاده کنید:** ```bash npm install -g ui-ux-pro-max-cli uipro init --ai