mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-17 16:46:31 +03:00
Paul BakausandClaude Fable 5
90f9eeb99b
The public repo keeps the OSS promise surface: skill, CLI, extension, tests, and the provider build. The site, labs, concept/composition catalogs, image pipeline, Cloudflare functions, and authoring guide move to pbakaus/impeccable-site. concept-seed tests run against a synthetic fixture catalog; the plugin icon and skill categories moved in-repo; build validation narrows to README prose and non-site counts; release notes read from a sibling impeccable-site checkout. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
710 lines
33 KiB
HTML
710 lines
33 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>/impeccable delight | Impeccable</title>
|
|
<meta name="description" content="Small moments of personality that turn functional into memorable.">
|
|
<meta name="theme-color" content="#fafafa">
|
|
<link rel="canonical" href="https://impeccable.style/docs/delight">
|
|
<link rel="icon" type="image/svg+xml" href="../favicon.svg">
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,600;1,400&family=Instrument+Sans:wght@400;500;600;700&family=Space+Grotesk:wght@400;500;600&display=swap" rel="stylesheet">
|
|
<link rel="stylesheet" href="../css/sub-pages.css">
|
|
|
|
</head>
|
|
<body class="sub-page skills-layout-page">
|
|
<a href="#main" class="skip-link">Skip to content</a>
|
|
<!-- site-header v1 -->
|
|
<header class="site-header" data-site-header>
|
|
<a href="/" class="site-header-brand" aria-label="Impeccable home">
|
|
<svg class="site-header-brand-logo" viewBox="0 0 32 32" aria-hidden="true"><rect width="32" height="32" rx="6" fill="#1a1a1a"/><text x="16" y="24" font-family="system-ui, -apple-system, sans-serif" font-size="22" font-weight="500" fill="#f5f3ef" text-anchor="middle">/</text></svg>
|
|
<span class="site-header-brand-name">Impeccable</span>
|
|
</a>
|
|
<div class="site-header-right">
|
|
<nav class="site-header-nav" aria-label="Primary">
|
|
<a href="/" data-nav="home">Home</a>
|
|
<a href="/designing" data-nav="designing">Designing</a>
|
|
<a href="/docs" data-nav="docs" aria-current="page">Docs</a>
|
|
<a href="/slop" data-nav="slop">Slop</a>
|
|
<a href="/live-mode" data-nav="live">Live</a>
|
|
</nav>
|
|
<a href="https://github.com/pbakaus/impeccable" class="site-header-github" target="_blank" rel="noopener" aria-label="Impeccable on GitHub, 21k stars">
|
|
<svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"/></svg>
|
|
<span class="site-header-github-label">21k</span>
|
|
<svg class="site-header-github-star" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 2l2.76 6.36L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l7.24-.91L12 2z"/></svg>
|
|
</a>
|
|
</div>
|
|
</header>
|
|
<main id="main">
|
|
|
|
<div class="skills-layout">
|
|
|
|
<aside class="skills-sidebar" aria-label="Documentation">
|
|
<button class="skills-sidebar-toggle" type="button" aria-expanded="false" aria-controls="skills-sidebar-inner">
|
|
<span class="skills-sidebar-toggle-label">/delight</span>
|
|
<svg class="skills-sidebar-toggle-chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M6 9l6 6 6-6"/></svg>
|
|
</button>
|
|
<div class="skills-sidebar-inner" id="skills-sidebar-inner">
|
|
<p class="skills-sidebar-label">Docs</p>
|
|
|
|
<div class="skills-sidebar-group" data-category="tutorials">
|
|
<p class="skills-sidebar-group-title">Tutorials</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/tutorials/getting-started">Getting started</a></li>
|
|
<li><a href="/tutorials/iterate-live">Iterate on UI with Live Mode</a></li>
|
|
<li><a href="/tutorials/brand-vs-product">Brand vs product, pick a register</a></li>
|
|
<li><a href="/tutorials/critique-with-overlay">Critique with the visual overlay</a></li>
|
|
</ul>
|
|
</div>
|
|
<hr class="skills-sidebar-divider">
|
|
|
|
<div class="skills-sidebar-group" data-category="create">
|
|
<p class="skills-sidebar-group-title">Create</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/impeccable">/impeccable</a></li>
|
|
<li><a href="/docs/craft">craft</a></li>
|
|
<li><a href="/docs/shape">shape</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="skills-sidebar-group" data-category="evaluate">
|
|
<p class="skills-sidebar-group-title">Evaluate</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/audit">audit</a></li>
|
|
<li><a href="/docs/critique">critique</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="skills-sidebar-group" data-category="refine">
|
|
<p class="skills-sidebar-group-title">Refine</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/animate">animate</a></li>
|
|
<li><a href="/docs/bolder">bolder</a></li>
|
|
<li><a href="/docs/colorize">colorize</a></li>
|
|
<li><a href="/docs/delight" aria-current="page">delight</a></li>
|
|
<li><a href="/docs/layout">layout</a></li>
|
|
<li><a href="/docs/overdrive">overdrive</a></li>
|
|
<li><a href="/docs/quieter">quieter</a></li>
|
|
<li><a href="/docs/typeset">typeset</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="skills-sidebar-group" data-category="simplify">
|
|
<p class="skills-sidebar-group-title">Simplify</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/adapt">adapt</a></li>
|
|
<li><a href="/docs/clarify">clarify</a></li>
|
|
<li><a href="/docs/distill">distill</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="skills-sidebar-group" data-category="harden">
|
|
<p class="skills-sidebar-group-title">Harden</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/harden">harden</a></li>
|
|
<li><a href="/docs/onboard">onboard</a></li>
|
|
<li><a href="/docs/optimize">optimize</a></li>
|
|
<li><a href="/docs/polish">polish</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="skills-sidebar-group" data-category="system">
|
|
<p class="skills-sidebar-group-title">System</p>
|
|
<ul class="skills-sidebar-list">
|
|
<li><a href="/docs/document">document</a></li>
|
|
<li><a href="/docs/extract">extract</a></li>
|
|
<li><a href="/docs/live">live</a></li>
|
|
<li><a href="/docs/teach">teach</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
</div>
|
|
</aside>
|
|
<div class="skills-main">
|
|
|
|
<article class="skill-detail">
|
|
<div class="skill-detail-hero skill-detail-hero--has-demo">
|
|
<header class="skill-detail-header">
|
|
<p class="skill-detail-eyebrow"><a href="/docs">Docs</a> / Refine</p>
|
|
<h1 class="skill-detail-title"><span class="skill-detail-title-namespace"><span class="skill-detail-title-slash">/</span>impeccable</span>delight</h1>
|
|
<p class="skill-detail-tagline">Small moments of personality that turn functional into memorable.</p>
|
|
|
|
<div class="skill-meta-strip">
|
|
<span class="skill-meta-chip skill-meta-category" data-category="refine">Refine</span>
|
|
<span class="skill-meta-chip">User-invocable</span>
|
|
<span class="skill-meta-chip skill-meta-args">[target]</span>
|
|
</div>
|
|
</header>
|
|
|
|
<section class="skill-demo" aria-label="Before and after demo">
|
|
<div class="split-comparison" data-demo="skill-delight">
|
|
<p class="skill-demo-eyebrow">Drag or hover to compare</p>
|
|
<div class="split-container">
|
|
<div class="split-before">
|
|
<div class="split-content">
|
|
<div style="width: 100%; max-width: 200px; display: flex; flex-direction: column; align-items: center; gap: 16px;">
|
|
<div style="text-align: center;">
|
|
<div style="font-size: 13px; color: #666; margin-bottom: 8px;">Milestone reached</div>
|
|
<div style="font-size: 24px; font-weight: bold; color: #333;">100</div>
|
|
<div style="font-size: 12px; color: #999;">tasks completed</div>
|
|
</div>
|
|
<button style="padding: 8px 16px; background: #e0e0e0; border: none; border-radius: 4px; font-size: 12px; color: #666;">Dismiss</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="split-after">
|
|
<div class="split-content">
|
|
<div style="width: 100%; max-width: 240px; display: flex; flex-direction: column; align-items: center; gap: 16px; position: relative;">
|
|
<div style="position: absolute; top: -20px; left: 50%; transform: translateX(-50%); display: flex; gap: 4px;">
|
|
<span style="animation: confettiFall 1s ease-out 0.0s both; font-size: 16px;">🎊</span>
|
|
<span style="animation: confettiFall 1s ease-out 0.1s both; font-size: 14px;">✨</span>
|
|
<span style="animation: confettiFall 1s ease-out 0.2s both; font-size: 16px;">🎉</span>
|
|
<span style="animation: confettiFall 1s ease-out 0.15s both; font-size: 14px;">✨</span>
|
|
<span style="animation: confettiFall 1s ease-out 0.25s both; font-size: 16px;">🎊</span>
|
|
</div>
|
|
<div style="text-align: center; animation: celebratePop 0.6s cubic-bezier(0.34, 1.56, 0.64, 1) both;">
|
|
<div style="font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.1em; color: var(--color-accent); margin-bottom: 8px; font-weight: 600;">Milestone unlocked!</div>
|
|
<div style="font-family: var(--font-display); font-size: 3.5rem; font-weight: 300; font-style: italic; color: var(--color-ink); line-height: 1;">100</div>
|
|
<div style="font-size: 0.875rem; color: var(--color-ash); margin-top: 4px;">tasks completed</div>
|
|
</div>
|
|
<div style="display: flex; align-items: center; gap: 6px; padding: 8px 16px; background: color-mix(in oklch, var(--color-accent) 10%, var(--color-paper)); border-radius: 20px; animation: badgeSlide 0.5s ease-out 0.3s both;">
|
|
<span style="font-size: 14px;">🏆</span>
|
|
<span style="font-size: 0.75rem; font-weight: 600; color: var(--color-accent);">Centurion Badge Earned</span>
|
|
</div>
|
|
</div>
|
|
<style>
|
|
@keyframes confettiFall {
|
|
0% { opacity: 0; transform: translateY(-20px) rotate(0deg); }
|
|
50% { opacity: 1; }
|
|
100% { opacity: 0; transform: translateY(40px) rotate(180deg); }
|
|
}
|
|
@keyframes celebratePop {
|
|
0% { opacity: 0; transform: scale(0.5); }
|
|
70% { transform: scale(1.05); }
|
|
100% { opacity: 1; transform: scale(1); }
|
|
}
|
|
@keyframes badgeSlide {
|
|
from { opacity: 0; transform: translateY(10px); }
|
|
to { opacity: 1; transform: translateY(0); }
|
|
}
|
|
</style>
|
|
</div>
|
|
</div>
|
|
<div class="split-divider"></div>
|
|
</div>
|
|
<div class="split-labels">
|
|
<span class="split-label-item" data-point="before">Before</span>
|
|
<p class="skill-demo-caption">Functional feedback → Moment of joy</p>
|
|
<span class="split-label-item" data-point="after">After</span>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
|
|
<section class="skill-detail-editorial prose">
|
|
<h2 id="when-to-use-it">When to use it</h2>
|
|
<p><code>/impeccable delight</code> is for interfaces that work but do not feel like anything. Use it when the core experience is solid and you want to add the small human touches that make people remember it: a considered empty state, a loading message with a point of view, a success animation that feels earned, a microcopy moment that makes someone smile.</p>
|
|
<p>It is a finishing skill. Never the first thing you run on a new build.</p>
|
|
<h2 id="how-it-works">How it works</h2>
|
|
<p>The skill hunts for delight opportunities in the places most designers skip:</p>
|
|
<ol>
|
|
<li><strong>Empty states</strong>: instead of "No items yet", something with personality appropriate to the brand.</li>
|
|
<li><strong>Loading and waiting moments</strong>: the best products turn waits into content.</li>
|
|
<li><strong>Success feedback</strong>: a moment of celebration when something worth celebrating happens.</li>
|
|
<li><strong>Microcopy</strong>: button labels, tooltips, error messages, placeholder text. Tiny copy with taste.</li>
|
|
<li><strong>Easter eggs and secondary states</strong>: things users discover that reward paying attention.</li>
|
|
</ol>
|
|
<p>The skill reads the brand tone from <code>PRODUCT.md</code>. A serious analytics tool gets serious delight (dry, precise, a little clever). A playful consumer app gets more overt personality. It does not force humor where humor is wrong for the audience.</p>
|
|
<p>The rule is: every delight moment must still work perfectly if you delete the delight. Nothing depends on the smile.</p>
|
|
<h2 id="try-it">Try it</h2>
|
|
<div class="code-block-wrap"><pre class="code-block"><code>/impeccable delight the first-run experience</code></pre><button class="code-block-copy" type="button" data-copy="/impeccable delight the first-run experience" aria-label="Copy to clipboard"></button></div>
|
|
<p>Expected additions:</p>
|
|
<ul>
|
|
<li>Empty dashboard replaces "No data yet" with "Your dashboard is quiet. Let's fix that." plus a single-action CTA.</li>
|
|
<li>Initial sync gets a 3-state loading message that advances: "Finding your accounts... / Pulling the last 30 days... / Making it look good...".</li>
|
|
<li>First successful action triggers a one-time toast with a tiny celebratory moment. After that, just a quiet checkmark.</li>
|
|
<li>Help tooltip on the tricky field has a voice that sounds like a person wrote it.</li>
|
|
</ul>
|
|
<h2 id="pitfalls">Pitfalls</h2>
|
|
<ul>
|
|
<li><strong>Forcing humor.</strong> Not every brand is playful. If the brand voice in <code>PRODUCT.md</code> is "clinical and precise", delight adds clever restraint, not jokes.</li>
|
|
<li><strong>Over-decorating.</strong> One moment of delight is memorable. Twenty becomes noise. The skill is conservative on purpose.</li>
|
|
<li><strong>Running delight before polish.</strong> Polish fixes what is wrong. Delight adds what is missing. In that order.</li>
|
|
</ul>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
<section class="skill-source-card">
|
|
<header class="skill-source-card-header">
|
|
<span class="skill-source-card-label">reference/delight.md</span>
|
|
<span class="skill-source-card-subtitle">Loaded when the impeccable skill routes to this command.</span>
|
|
</header>
|
|
<div class="skill-source-card-body prose">
|
|
<blockquote>
|
|
<p><strong>Additional context needed</strong>: what's appropriate for the domain (playful vs professional vs quirky vs elegant).</p>
|
|
</blockquote>
|
|
<p>Identify opportunities to add moments of joy, personality, and unexpected polish that transform functional interfaces into delightful experiences.</p>
|
|
<hr>
|
|
<h2 id="register">Register</h2>
|
|
<p>Brand: delight can be distributed — copy voice, section transitions, discovery rewards, seasonal touches, personality across the whole surface.</p>
|
|
<p>Product: delight at specific moments, not pages. Completion, first-time actions, error recovery, milestone crossings. Reliability and consistency carry the rest of the experience; delight pushed everywhere reads as noise.</p>
|
|
<hr>
|
|
<h2 id="assess-delight-opportunities">Assess Delight Opportunities</h2>
|
|
<p>Identify where delight would enhance (not distract from) the experience:</p>
|
|
<ol>
|
|
<li><p><strong>Find natural delight moments</strong>:</p>
|
|
<ul>
|
|
<li><strong>Success states</strong>: Completed actions (save, send, publish)</li>
|
|
<li><strong>Empty states</strong>: First-time experiences, onboarding</li>
|
|
<li><strong>Loading states</strong>: Waiting periods that could be entertaining</li>
|
|
<li><strong>Achievements</strong>: Milestones, streaks, completions</li>
|
|
<li><strong>Interactions</strong>: Hover states, clicks, drags</li>
|
|
<li><strong>Errors</strong>: Softening frustrating moments</li>
|
|
<li><strong>Easter eggs</strong>: Hidden discoveries for curious users</li>
|
|
</ul>
|
|
</li>
|
|
<li><p><strong>Understand the context</strong>:</p>
|
|
<ul>
|
|
<li>What's the brand personality? (Playful? Professional? Quirky? Elegant?)</li>
|
|
<li>Who's the audience? (Tech-savvy? Creative? Corporate?)</li>
|
|
<li>What's the emotional context? (Accomplishment? Exploration? Frustration?)</li>
|
|
<li>What's appropriate? (Banking app ≠ gaming app)</li>
|
|
</ul>
|
|
</li>
|
|
<li><p><strong>Define delight strategy</strong>:</p>
|
|
<ul>
|
|
<li><strong>Subtle sophistication</strong>: Refined micro-interactions (luxury brands)</li>
|
|
<li><strong>Playful personality</strong>: Whimsical illustrations and copy (consumer apps)</li>
|
|
<li><strong>Helpful surprises</strong>: Anticipating needs before users ask (productivity tools)</li>
|
|
<li><strong>Sensory richness</strong>: Satisfying sounds, smooth animations (creative tools)</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<p>If any of these are unclear from the codebase, STOP and call the AskUserQuestion tool to clarify.</p>
|
|
<p><strong>CRITICAL</strong>: Delight should enhance usability, never obscure it. If users notice the delight more than accomplishing their goal, you've gone too far.</p>
|
|
<h2 id="delight-principles">Delight Principles</h2>
|
|
<p>Follow these guidelines:</p>
|
|
<h3 id="delight-amplifies-never-blocks">Delight Amplifies, Never Blocks</h3>
|
|
<ul>
|
|
<li>Delight moments should be quick (< 1 second)</li>
|
|
<li>Never delay core functionality for delight</li>
|
|
<li>Make delight skippable or subtle</li>
|
|
<li>Respect user's time and task focus</li>
|
|
</ul>
|
|
<h3 id="surprise-and-discovery">Surprise and Discovery</h3>
|
|
<ul>
|
|
<li>Hide delightful details for users to discover</li>
|
|
<li>Reward exploration and curiosity</li>
|
|
<li>Don't announce every delight moment</li>
|
|
<li>Let users share discoveries with others</li>
|
|
</ul>
|
|
<h3 id="appropriate-to-context">Appropriate to Context</h3>
|
|
<ul>
|
|
<li>Match delight to emotional moment (celebrate success, empathize with errors)</li>
|
|
<li>Respect the user's state (don't be playful during critical errors)</li>
|
|
<li>Match brand personality and audience expectations</li>
|
|
<li>Cultural sensitivity (what's delightful varies by culture)</li>
|
|
</ul>
|
|
<h3 id="compound-over-time">Compound Over Time</h3>
|
|
<ul>
|
|
<li>Delight should remain fresh with repeated use</li>
|
|
<li>Vary responses (not same animation every time)</li>
|
|
<li>Reveal deeper layers with continued use</li>
|
|
<li>Build anticipation through patterns</li>
|
|
</ul>
|
|
<h2 id="delight-techniques">Delight Techniques</h2>
|
|
<p>Add personality and joy through these methods:</p>
|
|
<h3 id="micro-interactions-animation">Micro-interactions & Animation</h3>
|
|
<p><strong>Button delight</strong>:</p>
|
|
<div class="code-block-wrap"><pre class="code-block code-block--css"><code>/* Satisfying button press */
|
|
.button {
|
|
transition: transform 0.1s, box-shadow 0.1s;
|
|
}
|
|
.button:active {
|
|
transform: translateY(2px);
|
|
box-shadow: 0 2px 4px rgba(0,0,0,0.2);
|
|
}
|
|
|
|
/* Ripple effect on click */
|
|
/* Smooth lift on hover */
|
|
.button:hover {
|
|
transform: translateY(-2px);
|
|
transition: transform 0.2s cubic-bezier(0.25, 1, 0.5, 1); /* ease-out-quart */
|
|
}</code></pre><button class="code-block-copy" type="button" data-copy="/* Satisfying button press */
|
|
.button {
|
|
transition: transform 0.1s, box-shadow 0.1s;
|
|
}
|
|
.button:active {
|
|
transform: translateY(2px);
|
|
box-shadow: 0 2px 4px rgba(0,0,0,0.2);
|
|
}
|
|
|
|
/* Ripple effect on click */
|
|
/* Smooth lift on hover */
|
|
.button:hover {
|
|
transform: translateY(-2px);
|
|
transition: transform 0.2s cubic-bezier(0.25, 1, 0.5, 1); /* ease-out-quart */
|
|
}" aria-label="Copy to clipboard"></button></div>
|
|
<p><strong>Loading delight</strong>:</p>
|
|
<ul>
|
|
<li>Playful loading animations (not just spinners)</li>
|
|
<li>Personality in loading messages (write product-specific ones, not generic AI filler)</li>
|
|
<li>Progress indication with encouraging messages</li>
|
|
<li>Skeleton screens with subtle animations</li>
|
|
</ul>
|
|
<p><strong>Success animations</strong>:</p>
|
|
<ul>
|
|
<li>Checkmark draw animation</li>
|
|
<li>Confetti burst for major achievements</li>
|
|
<li>Gentle scale + fade for confirmation</li>
|
|
<li>Satisfying sound effects (subtle)</li>
|
|
</ul>
|
|
<p><strong>Hover surprises</strong>:</p>
|
|
<ul>
|
|
<li>Icons that animate on hover</li>
|
|
<li>Color shifts or glow effects</li>
|
|
<li>Tooltip reveals with personality</li>
|
|
<li>Cursor changes (custom cursors for branded experiences)</li>
|
|
</ul>
|
|
<h3 id="personality-in-copy">Personality in Copy</h3>
|
|
<p><strong>Playful error messages</strong>:</p>
|
|
<div class="code-block-wrap"><pre class="code-block"><code>"Error 404"
|
|
"This page is playing hide and seek. (And winning)"
|
|
|
|
"Connection failed"
|
|
"Looks like the internet took a coffee break. Want to retry?"</code></pre><button class="code-block-copy" type="button" data-copy=""Error 404"
|
|
"This page is playing hide and seek. (And winning)"
|
|
|
|
"Connection failed"
|
|
"Looks like the internet took a coffee break. Want to retry?"" aria-label="Copy to clipboard"></button></div>
|
|
<p><strong>Encouraging empty states</strong>:</p>
|
|
<div class="code-block-wrap"><pre class="code-block"><code>"No projects"
|
|
"Your canvas awaits. Create something amazing."
|
|
|
|
"No messages"
|
|
"Inbox zero! You're crushing it today."</code></pre><button class="code-block-copy" type="button" data-copy=""No projects"
|
|
"Your canvas awaits. Create something amazing."
|
|
|
|
"No messages"
|
|
"Inbox zero! You're crushing it today."" aria-label="Copy to clipboard"></button></div>
|
|
<p><strong>Playful labels & tooltips</strong>:</p>
|
|
<div class="code-block-wrap"><pre class="code-block"><code>"Delete"
|
|
"Send to void" (for playful brand)
|
|
|
|
"Help"
|
|
"Rescue me" (tooltip)</code></pre><button class="code-block-copy" type="button" data-copy=""Delete"
|
|
"Send to void" (for playful brand)
|
|
|
|
"Help"
|
|
"Rescue me" (tooltip)" aria-label="Copy to clipboard"></button></div>
|
|
<p><strong>IMPORTANT</strong>: Match copy personality to brand. Banks shouldn't be wacky, but they can be warm.</p>
|
|
<h3 id="illustrations-visual-personality">Illustrations & Visual Personality</h3>
|
|
<p><strong>Custom illustrations</strong>:</p>
|
|
<ul>
|
|
<li>Empty state illustrations (not stock icons)</li>
|
|
<li>Error state illustrations (friendly monsters, quirky characters)</li>
|
|
<li>Loading state illustrations (animated characters)</li>
|
|
<li>Success state illustrations (celebrations)</li>
|
|
</ul>
|
|
<p><strong>Icon personality</strong>:</p>
|
|
<ul>
|
|
<li>Custom icon set matching brand personality</li>
|
|
<li>Animated icons (subtle motion on hover/click)</li>
|
|
<li>Illustrative icons (more detailed than generic)</li>
|
|
<li>Consistent style across all icons</li>
|
|
</ul>
|
|
<p><strong>Background effects</strong>:</p>
|
|
<ul>
|
|
<li>Subtle particle effects</li>
|
|
<li>Gradient mesh backgrounds</li>
|
|
<li>Geometric patterns</li>
|
|
<li>Parallax depth</li>
|
|
<li>Time-of-day themes (morning vs night)</li>
|
|
</ul>
|
|
<h3 id="satisfying-interactions">Satisfying Interactions</h3>
|
|
<p><strong>Drag and drop delight</strong>:</p>
|
|
<ul>
|
|
<li>Lift effect on drag (shadow, scale)</li>
|
|
<li>Snap animation when dropped</li>
|
|
<li>Satisfying placement sound</li>
|
|
<li>Undo toast ("Dropped in wrong place? [Undo]")</li>
|
|
</ul>
|
|
<p><strong>Toggle switches</strong>:</p>
|
|
<ul>
|
|
<li>Smooth slide with spring physics</li>
|
|
<li>Color transition</li>
|
|
<li>Haptic feedback on mobile</li>
|
|
<li>Optional sound effect</li>
|
|
</ul>
|
|
<p><strong>Progress & achievements</strong>:</p>
|
|
<ul>
|
|
<li>Streak counters with celebratory milestones</li>
|
|
<li>Progress bars that "celebrate" at 100%</li>
|
|
<li>Badge unlocks with animation</li>
|
|
<li>Playful stats ("You're on fire! 5 days in a row")</li>
|
|
</ul>
|
|
<p><strong>Form interactions</strong>:</p>
|
|
<ul>
|
|
<li>Input fields that animate on focus</li>
|
|
<li>Checkboxes with a satisfying scale pulse when checked</li>
|
|
<li>Success state that celebrates valid input</li>
|
|
<li>Auto-grow textareas</li>
|
|
</ul>
|
|
<h3 id="sound-design">Sound Design</h3>
|
|
<p><strong>Subtle audio cues</strong> (when appropriate):</p>
|
|
<ul>
|
|
<li>Notification sounds (distinctive but not annoying)</li>
|
|
<li>Success sounds (satisfying "ding")</li>
|
|
<li>Error sounds (empathetic, not harsh)</li>
|
|
<li>Typing sounds for chat/messaging</li>
|
|
<li>Ambient background audio (very subtle)</li>
|
|
</ul>
|
|
<p><strong>IMPORTANT</strong>:</p>
|
|
<ul>
|
|
<li>Respect system sound settings</li>
|
|
<li>Provide mute option</li>
|
|
<li>Keep volumes quiet (subtle cues, not alarms)</li>
|
|
<li>Don't play on every interaction (sound fatigue is real)</li>
|
|
</ul>
|
|
<h3 id="easter-eggs-hidden-delights">Easter Eggs & Hidden Delights</h3>
|
|
<p><strong>Discovery rewards</strong>:</p>
|
|
<ul>
|
|
<li>Konami code unlocks special theme</li>
|
|
<li>Hidden keyboard shortcuts (Cmd+K for special features)</li>
|
|
<li>Hover reveals on logos or illustrations</li>
|
|
<li>Alt text jokes on images (for screen reader users too!)</li>
|
|
<li>Console messages for developers ("Like what you see? We're hiring!")</li>
|
|
</ul>
|
|
<p><strong>Seasonal touches</strong>:</p>
|
|
<ul>
|
|
<li>Holiday themes (subtle, tasteful)</li>
|
|
<li>Seasonal color shifts</li>
|
|
<li>Weather-based variations</li>
|
|
<li>Time-based changes (dark at night, light during day)</li>
|
|
</ul>
|
|
<p><strong>Contextual personality</strong>:</p>
|
|
<ul>
|
|
<li>Different messages based on time of day</li>
|
|
<li>Responses to specific user actions</li>
|
|
<li>Randomized variations (not same every time)</li>
|
|
<li>Progressive reveals with continued use</li>
|
|
</ul>
|
|
<h3 id="loading-waiting-states">Loading & Waiting States</h3>
|
|
<p><strong>Make waiting engaging</strong>:</p>
|
|
<ul>
|
|
<li>Interesting loading messages that rotate</li>
|
|
<li>Progress bars with personality</li>
|
|
<li>Mini-games during long loads</li>
|
|
<li>Fun facts or tips while waiting</li>
|
|
<li>Countdown with encouraging messages</li>
|
|
</ul>
|
|
<div class="code-block-wrap"><pre class="code-block"><code>Loading messages — write ones specific to your product, not generic AI filler:
|
|
- "Crunching your latest numbers..."
|
|
- "Syncing with your team's changes..."
|
|
- "Preparing your dashboard..."
|
|
- "Checking for updates since yesterday..."</code></pre><button class="code-block-copy" type="button" data-copy="Loading messages — write ones specific to your product, not generic AI filler:
|
|
- "Crunching your latest numbers..."
|
|
- "Syncing with your team's changes..."
|
|
- "Preparing your dashboard..."
|
|
- "Checking for updates since yesterday..."" aria-label="Copy to clipboard"></button></div>
|
|
<p><strong>WARNING</strong>: Avoid cliched loading messages like "Herding pixels", "Teaching robots to dance", "Consulting the magic 8-ball", "Counting backwards from infinity". These are AI-slop copy — instantly recognizable as machine-generated. Write messages that are specific to what your product actually does.</p>
|
|
<h3 id="celebration-moments">Celebration Moments</h3>
|
|
<p><strong>Success celebrations</strong>:</p>
|
|
<ul>
|
|
<li>Confetti for major milestones</li>
|
|
<li>Animated checkmarks for completions</li>
|
|
<li>Progress bar celebrations at 100%</li>
|
|
<li>"Achievement unlocked" style notifications</li>
|
|
<li>Personalized messages ("You published your 10th article!")</li>
|
|
</ul>
|
|
<p><strong>Milestone recognition</strong>:</p>
|
|
<ul>
|
|
<li>First-time actions get special treatment</li>
|
|
<li>Streak tracking and celebration</li>
|
|
<li>Progress toward goals</li>
|
|
<li>Anniversary celebrations</li>
|
|
</ul>
|
|
<h2 id="implementation-patterns">Implementation Patterns</h2>
|
|
<p><strong>Animation libraries</strong>:</p>
|
|
<ul>
|
|
<li>Framer Motion (React)</li>
|
|
<li>GSAP (universal)</li>
|
|
<li>Lottie (After Effects animations)</li>
|
|
<li>Canvas confetti (party effects)</li>
|
|
</ul>
|
|
<p><strong>Sound libraries</strong>:</p>
|
|
<ul>
|
|
<li>Howler.js (audio management)</li>
|
|
<li>Use-sound (React hook)</li>
|
|
</ul>
|
|
<p><strong>Physics libraries</strong>:</p>
|
|
<ul>
|
|
<li>React Spring (spring physics)</li>
|
|
<li>Popmotion (animation primitives)</li>
|
|
</ul>
|
|
<p><strong>IMPORTANT</strong>: File size matters. Compress images, optimize animations, lazy load delight features.</p>
|
|
<p><strong>NEVER</strong>:</p>
|
|
<ul>
|
|
<li>Delay core functionality for delight</li>
|
|
<li>Force users through delightful moments (make skippable)</li>
|
|
<li>Use delight to hide poor UX</li>
|
|
<li>Overdo it (less is more)</li>
|
|
<li>Ignore accessibility (animate responsibly, provide alternatives)</li>
|
|
<li>Make every interaction delightful (special moments should be special)</li>
|
|
<li>Sacrifice performance for delight</li>
|
|
<li>Be inappropriate for context (read the room)</li>
|
|
</ul>
|
|
<h2 id="verify-delight-quality">Verify Delight Quality</h2>
|
|
<p>Test that delight actually delights:</p>
|
|
<ul>
|
|
<li><strong>User reactions</strong>: Do users smile? Share screenshots?</li>
|
|
<li><strong>Doesn't annoy</strong>: Still pleasant after 100th time?</li>
|
|
<li><strong>Doesn't block</strong>: Can users opt out or skip?</li>
|
|
<li><strong>Performant</strong>: No jank, no slowdown</li>
|
|
<li><strong>Appropriate</strong>: Matches brand and context</li>
|
|
<li><strong>Accessible</strong>: Works with reduced motion, screen readers</li>
|
|
</ul>
|
|
<p>Remember: Delight is the difference between a tool and an experience. Add personality, surprise users positively, and create moments worth sharing. But always respect usability - delight should enhance, never obstruct.</p>
|
|
|
|
</div>
|
|
</section>
|
|
|
|
|
|
</article>
|
|
|
|
</div>
|
|
</div>
|
|
</main>
|
|
<script>
|
|
// Copy buttons on rendered code blocks
|
|
document.addEventListener('click', (e) => {
|
|
const btn = e.target.closest('[data-copy]');
|
|
if (!btn) return;
|
|
const text = btn.getAttribute('data-copy');
|
|
if (!text) return;
|
|
navigator.clipboard.writeText(text).then(() => {
|
|
btn.classList.add('is-copied');
|
|
setTimeout(() => btn.classList.remove('is-copied'), 1500);
|
|
}).catch(() => {});
|
|
});
|
|
|
|
// Mobile sidebar toggle (shown on narrow viewports, hidden on desktop).
|
|
document.addEventListener('click', (e) => {
|
|
const toggle = e.target.closest('.skills-sidebar-toggle');
|
|
if (!toggle) return;
|
|
const expanded = toggle.getAttribute('aria-expanded') === 'true';
|
|
toggle.setAttribute('aria-expanded', String(!expanded));
|
|
});
|
|
|
|
// Before/after split-compare: drag on touch, hover OR drag on mouse.
|
|
// Pointer events attach to the padded .split-comparison wrapper so
|
|
// there is a ~20px invisible buffer around the visible box. The
|
|
// divider only snaps back when the pointer leaves that outer buffer.
|
|
(function initSplitCompare() {
|
|
const wrappers = document.querySelectorAll('.split-comparison');
|
|
if (wrappers.length === 0) return;
|
|
const hasHover = matchMedia('(hover: hover)').matches;
|
|
const DEFAULT_POSITION = 50;
|
|
|
|
for (const wrapper of wrappers) {
|
|
const container = wrapper.querySelector('.split-container');
|
|
const splitAfter = wrapper.querySelector('.split-after');
|
|
const splitDivider = wrapper.querySelector('.split-divider');
|
|
if (!container || !splitAfter || !splitDivider) continue;
|
|
|
|
const tanAngle = Math.tan(10 * Math.PI / 180);
|
|
let skewOffset = 8;
|
|
const recalcSkew = () => {
|
|
const r = container.getBoundingClientRect();
|
|
if (r.width > 0 && r.height > 0) {
|
|
skewOffset = 50 * r.height * tanAngle / r.width;
|
|
}
|
|
};
|
|
recalcSkew();
|
|
window.addEventListener('resize', recalcSkew, { passive: true });
|
|
|
|
let targetX = DEFAULT_POSITION;
|
|
let currentX = DEFAULT_POSITION;
|
|
let rafId = null;
|
|
|
|
const paint = (pct) => {
|
|
const x = Math.max(-skewOffset, Math.min(100 + skewOffset, pct));
|
|
splitAfter.style.clipPath =
|
|
`polygon(${x + skewOffset}% 0%, 100% 0%, 100% 100%, ${x - skewOffset}% 100%)`;
|
|
splitDivider.style.left = `${x}%`;
|
|
};
|
|
|
|
const step = () => {
|
|
currentX += (targetX - currentX) * 0.2;
|
|
if (Math.abs(targetX - currentX) < 0.1) {
|
|
currentX = targetX;
|
|
rafId = null;
|
|
} else {
|
|
rafId = requestAnimationFrame(step);
|
|
}
|
|
paint(currentX);
|
|
};
|
|
|
|
const setTarget = (pct) => {
|
|
targetX = pct;
|
|
if (rafId === null) rafId = requestAnimationFrame(step);
|
|
};
|
|
|
|
paint(DEFAULT_POSITION);
|
|
|
|
// Percentage is always relative to the VISIBLE .split-container,
|
|
// not the padded .split-comparison wrapper. The pointer event
|
|
// target is the wrapper but the clip-path math uses the inner box.
|
|
const pctFromClientX = (clientX) => {
|
|
const rect = container.getBoundingClientRect();
|
|
return ((clientX - rect.left) / rect.width) * 100;
|
|
};
|
|
|
|
let hovering = false;
|
|
let dragging = false;
|
|
|
|
wrapper.addEventListener('pointerenter', (e) => {
|
|
if (hasHover && e.pointerType === 'mouse') {
|
|
hovering = true;
|
|
}
|
|
});
|
|
|
|
wrapper.addEventListener('pointerdown', (e) => {
|
|
dragging = true;
|
|
wrapper.setPointerCapture(e.pointerId);
|
|
setTarget(pctFromClientX(e.clientX));
|
|
});
|
|
|
|
wrapper.addEventListener('pointermove', (e) => {
|
|
if (dragging || hovering) {
|
|
setTarget(pctFromClientX(e.clientX));
|
|
}
|
|
});
|
|
|
|
const endDrag = (e) => {
|
|
if (dragging) {
|
|
dragging = false;
|
|
try { wrapper.releasePointerCapture(e.pointerId); } catch {}
|
|
}
|
|
};
|
|
|
|
wrapper.addEventListener('pointerup', endDrag);
|
|
wrapper.addEventListener('pointercancel', endDrag);
|
|
|
|
wrapper.addEventListener('pointerleave', (e) => {
|
|
endDrag(e);
|
|
if (hovering) {
|
|
hovering = false;
|
|
setTarget(DEFAULT_POSITION);
|
|
}
|
|
});
|
|
}
|
|
})();
|
|
</script>
|
|
</body>
|
|
</html>
|