a2host/.agents/skills/modern-ui-design-system/SKILL.md

3.0 KiB

name description
modern-ui-design-system Provides modern design system guidelines, glassmorphism aesthetics, institutional CPIC/SENA color palettes, micro-interactions, and visual polish. Use when styling, redesigning, or creating UI components to ensure a premium, coherent, and attractive aesthetic.

Modern UI Design System Skill

Visual Language & Design Tokens

  1. Color Palette:

    • Brand Primary: Emerald & Lime green institutional accents.
      • Dark Mode Accent: text-lime (#a3e635 / #84cc16), bg-lime/10, border-lime/20.
      • Light Mode Accent: #15803d (Emerald 700) / #16a34a (Emerald 600) for contrast.
    • Background Surfaces:
      • Dark Mode Base: Obsidian / Void black (#0a0a0a or #0a160a).
      • Dark Mode Cards: bg-white/[0.04] to bg-white/[0.08] with backdrop-blur-xl.
      • Light Mode Base: Soft neutral slate / alabaster (#f8fafc or #f3f4f6).
      • Light Mode Cards: bg-white/85 with backdrop-blur-xl.
    • Borders & Dividers:
      • Dark Mode: border-white/10 or border-white/[0.08].
      • Light Mode: border-black/[0.08] or border-slate-200/80.
    • Typography Shades:
      • Dark Mode: Primary text-white, secondary text-white/70, muted text-white/40.
      • Light Mode: Primary text-slate-900, secondary text-slate-700, muted text-slate-500.
  2. Glassmorphism Guidelines:

    • Always pair backdrop-blur-xl or backdrop-blur-2xl with a subtle 1px border.
    • Example container class:
      bg-white/80 dark:bg-[rgba(10,22,10,0.85)] backdrop-blur-2xl border border-black/8 dark:border-white/10 rounded-2xl shadow-[0_4px_24px_rgba(0,0,0,0.06)] dark:shadow-[0_4px_24px_rgba(0,0,0,0.25)]
      
    • Avoid solid opaque white or solid pitch black boxes unless explicitly serving as high-contrast dialogs.
  3. Micro-Interactions & Transitions:

    • Interactive Elements: All buttons, links, and cards must specify transitions: transition-all duration-200 ease-out.
    • Hover Effects:
      • Subtle elevation or scaling: hover:scale-[1.01] or hover:scale-[1.02].
      • Border highlight: hover:border-lime/30 or hover:bg-white/[0.08].
    • Active State Feedback:
      • Button press feel: active:scale-[0.98].
    • Focus Rings:
      • focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-lime focus-visible:ring-offset-2 focus-visible:ring-offset-black.
  4. Feedback & Loading States:

    • Never use raw text without containers or jarring layout shifts.
    • Skeleton Loaders: Use pulsating shimmer blocks:
      <div className="animate-pulse bg-white/10 dark:bg-white/5 rounded-xl h-10 w-full" />
      
    • Typing / Thinking Indicator: Smooth pulse or animated dot sequence (animate-bounce).
  5. Iconography:

    • Standardize on FontAwesome solid / regular icons with consistent sizing:
      • Inline buttons: text-sm or text-base.
      • Badges / chips: text-xs.
      • Navigation headers: w-5 h-5 / text-base centered in w-9 h-9 rounded containers.