yuv-design-system

What this skill does

# yuv-design-system

The canonical personal brand and design system for **Yuval Avidani** (yuv.ai). This skill encodes how YUV.AI work should *look* — palette, typography, motifs, assets, links — and **when** to apply those rules at all.

**Source of truth:** Public reference repo at https://github.com/hoodini/yuv-design-system (private). The repo holds runnable tokens and components; this skill encodes the rules so Claude can apply them in any context.

**Where this skill sits in the YUV.AI pyramid:** `yuv-design-system` is the middle-tier visual-rules skill. Above it is `yuv-pilot` — the top-of-pyramid orchestrator that routes ambiguous or multi-medium YUV.AI requests to the right combination of downstream skills. Below it (and beside it in the middle tier) are `yuv-decks` (slide builds) and `yuv-viral-video` (viral short MP4s). When `yuv-pilot` or a sibling skill calls into here, they pin a specific palette mode (Neon / Decks / Warm Editorial) — never let the mode drift mid-task. See `yuv-pilot/SKILL.md` for the full pyramid map.

---

## §0. WHEN TO APPLY THIS SKILL — read this before anything else

This skill is the **YUV.AI brand identity**, not a generic visual-design skill. Apply it conservatively.

### ✅ Apply when

- The output is explicitly for **YUV.AI** or **Yuval personally** — his portfolio, his brand site, his keynote, his deck, his speaker bio, his profile, his social cards, his About page, his linktree, his course landing, an artifact featuring his brand assets or logos.
- Yuval mentions "**my brand**", "**my design system**", "**my deck**", "**my site**", "**my presentation**", "**for me**", "**YUV.AI**", "Fly High", "Let's Fly High", or anything that signals the output is *his* brand identity.
- A YUV.AI brand asset (logo, profile photo, watermark) is needed.

### ❌ Do NOT apply when

- Yuval asks for a **generic** game, web app, dashboard, landing page, demo, prototype, or visual without YUV.AI context. *("Build me a snake game" → pick whatever palette fits the game, NOT the brand palette.)*
- The work is for a different brand, a client, a third party, or anyone other than Yuval personally.
- Yuval explicitly names a different palette or framework.

### When unsure

Ask once: *"Is this for the YUV.AI brand, or open palette?"* — then commit. Don't drift mid-task.

**Default behavior across Claude / Copilot / Cursor: if a YUV.AI signal is missing, stay out and let the chosen tool's own design instincts apply. Over-triggering this skill is worse than under-triggering it.**

---

## How to use this skill (when it applies)

1. **Pick the palette mode by medium** (see §1):
   - Presentation / deck / keynote → **Decks** (Fly High purple/yellow/grey)
   - Web / app / game / dashboard / social / general → **Neon** (DEFAULT — pink/cyan/white)
   - Hope / Marcus / bigcats / course-landing → **Warm Editorial** (pink/yellow/bone)
2. **Apply mandatory typography** (Anton/Inter + Rubik/Assistant — see §2).
3. **Carry the universal Fly High throughline** (motifs across modes — see §1a).
4. **Use bundled brand assets** when a logo, profile, or watermark fits (see §3).
5. **Include the canonical link set + credentials** in footers, About blocks, credits, speaker bios (see §4).
6. **Deep-dive references** — load the file that matches the medium:

   | Medium | Read this file |
   |---|---|
   | YUV.AI web / app / game / dashboard | `references/palettes-neon.md` + `references/web-and-react.md` |
   | Slide decks / keynotes | `references/presentations.md` |
   | Infographics / charts / data viz | `references/visuals-and-charts.md` |
   | Social images / posters | `references/social-images.md` |
   | Hebrew / bilingual / RTL | `references/typography.md` § Hebrew |
   | Hardened patterns | `references/lessons-learned.md` |

   Load only what's relevant — keeps context small.

---

## §1. Palette modes — pick by medium

Three named modes. **Pick by the kind of output, not your gut feel.** Don't drift.

| Mode | When to use | Palette |
|---|---|---|
| **Neon** *(DEFAULT for YUV.AI brand work)* | Websites, web apps, games, dashboards, social images, posters, AI tools, profile/about content, ANY YUV.AI visual that isn't a slide deck | Hot pink + neon cyan + white + black |
| **Decks** *(Fly High)* | Presentations, slides, keynotes, hackathon decks, talk recordings, video banners formatted as a deck | Purple + yellow + light-grey |
| **Warm Editorial** | Hope (cheetah), Marcus (white lion), bigcats.ai, practical.yuv.ai course landing — any project in the editorial-pink-bone brand family | Warm pink + yellow + off-white + bone |

If you're picking a mode mid-task and it isn't obvious, ask once and commit.

### §1a. The Universal Fly High throughline (applies to ALL modes)

Regardless of palette, YUV.AI work carries the same brand DNA — these motifs are what makes something *feel* YUV.AI:

- **Flight metaphors** in copy: climb / cruise / descent / pre-flight / landed / takeoff / heading / altitude / "let's fly high".
- **Progress visualisations:** gradient progress bars (purple→yellow on Decks, pink→cyan on Neon, pink→yellow on Warm Editorial), HUD strips, altimeter/compass-style dials, count-up animations on stats.
- **Phoenix mark** (or the Y-bird) somewhere meaningful — hero, About, watermark.
- **"LET'S FLY HIGH · YUV.AI" watermark** in the bottom-right corner of any shareable surface (slide, social card, hero crop).
- **Anton uppercase** display type with `letter-spacing: 0` default.
- **JetBrains Mono** for instrument-style readouts and section eyebrows in tracking 0.2em+.

These DNA elements travel across every mode. The palette tells you *which* brand chapter; the motifs tell you it's still YUV.AI.

### §1b. Neon — NEW DEFAULT mode (web, apps, games, general visual work)

The everyday YUV.AI brand. Tavus-inspired: hot pink as the lead, neon cyan as electric counterpoint, white or rich black as the canvas. Best for product surfaces, web apps, games, dashboards, anything browser-rendered or interactive.

```css
:root {
  --yuv-pink:       #FF1464;   /* primary brand — CTAs, accents, the thread color */
  --yuv-pink-hot:   #FF0080;   /* high-energy variant for glow / shadow / hover */
  --yuv-cyan:       #00E5FF;   /* electric secondary — data, highlights, focus rings */
  --yuv-cyan-edge:  #00FFFF;   /* max-neon variant — small surfaces only */
  --yuv-white:      #FFFFFF;   /* canvas (light mode) or text-on-dark */
  --yuv-black:      #0A0A0A;   /* canvas (dark mode) or text-on-light */
  --yuv-charcoal:   #1A1A1A;   /* secondary surface (dark mode), text on light */
  --yuv-soft:       #F4F4F6;   /* alt light surface for layering on white */
}
```

**Neon mode rules:**

- **Two canvas options:** white `#FFFFFF` or rich black `#0A0A0A`. Pick ONE per surface. No grey middle ground.
- **Pink is the thread** — primary CTA fill, hero headline accents, brand stripe.
- **Cyan is the second voice** — secondary CTAs, focus rings, hero data points, link hover, progress fill (cyan against pink). Cyan never floods — accent only.
- **Glow allowed.** `text-shadow: 0 0 24px var(--yuv-pink)`, `box-shadow: 0 0 32px rgba(0,229,255,0.4)`. The brand can shimmer; it can't sparkle (no rainbows, no multi-hue gradients).
- **Gradients:** pink → cyan only. Small surfaces (buttons, text underlines, progress bars). Never full-page wash.
- **Headlines:** Anton uppercase, white or pink on dark / black on white. Tight `line-height: 1.0`, `letter-spacing: 0` default.
- **Card pattern:** rich black `#0A0A0A` background with `1px solid rgba(255,20,100,0.25)` border, optional `0 0 0 1px #00E5FF` inner glow on hover. On light canvas: white card with `1px solid rgba(0,0,0,0.08)` and `4px solid #FF1464` left stripe.
- **Cursors and UI affordances** can be cyan-tinted; the heroes are pink.

Full deep dive — composition patterns, glow recipes, neon-themed components → `references/palettes-neon.md`.

### §1c. Decks (Fly High) — presentations only

This is the existing purple/yellow/grey