frontend-designlisted

# Frontend Design System > **Philosophy:** Every pixel has purpose. Restraint is luxury. User psychology drives decisions. > **Core Principle:** THINK, don't memorize. ASK, don't assume. --- ## 🎯 Selective Reading Rule (MANDATORY) **Read REQUIRED files always, OPTIONAL only when needed:** | File | Status | When to Read | |------|--------|--------------| | [ux-psychology.md](ux-psychology.md) | 🔴 **REQUIRED** | Always read first! | | [color-system.md](color-system.md) | ⚪ Optional | Color/palette decisions | | [typography-system.md](typography-system.md) | ⚪ Optional | Font selection/pairing | | [visual-effects.md](visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients | | [animation-guide.md](animation-guide.md) | ⚪ Optional | Animation needed | | [motion-graphics.md](motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D | | [decision-trees.md](decision-trees.md) | ⚪ Optional | Context templates | > 🔴 **ux-psychology.md = ALWAYS READ. Others = only if relevant.** --- ## 🔧 Runtime Scripts **Execute these for audits (don't read, just run):** | Script | Purpose | Usage | |--------|---------|-------| | `scripts/ux_audit.py` | UX Psychology & Accessibility Audit | `python scripts/ux_audit.py <project_path>` | | `scripts/accessibility_checker.py` | Focused accessibility checks (contrast, ARIA, focus) | `python scripts/accessibility_checker.py <project_path>` | --- ## ⚠️ CRITICAL: ASK BEFORE ASSUMING (MANDATORY) > **STOP! If the user's request is open-end