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

61 lines
3.0 KiB
Markdown

---
name: modern-ui-design-system
description: >-
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:
```html
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:
```html
<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.