Add LottieFiles motion-design skill

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0119deVM65AKpJiLTLhEdDg9
Add remotion-video skill (#1 )
2026-10-18 21:44:48 +00:00 · 2026-10-15 10:42:46 +11:00
54 changed files with 1936 additions and 5307 deletions
@@ -0,0 +1,315 @@
 ---
 name: motion-design
 description: >
  Applies motion design principles to create emotionally-driven, technically sound animations and transitions.
  Provides timing, easing, choreography, and Disney animation principles adapted for UI.
  Use when creating animations, transitions, micro-interactions, loading states, page transitions,
  scroll-triggered effects, or any motion work. Works with CSS, Framer Motion, GSAP, Lottie, Spring,
  or any animation system.
 license: MIT
 metadata:
  author: LottieFiles
  version: "1.0.0"
 ---
 # Motion Design Skill
 ## When to Apply
 Use this skill when:
 - Creating UI animations (buttons, cards, modals, page transitions)
 - Designing micro-interactions and feedback animations
 - Building loading, success, or error states
 - Animating illustrations or decorative elements
 - Planning scroll-triggered or progress-based animations
 - Establishing brand motion identity
 - Choreographing multi-element sequences
 **Decision tree:**
 1. Does it serve a functional purpose (feedback, guidance)? → Timing rules for responsiveness
 2. Does it express brand personality? → Motion Personality archetypes
 3. Does it tell a story or guide attention? → Disney principles + choreography
 4. Is this a complex multi-element scene? → 1/3 Rule + stagger patterns
 ---
 ## Quick Reference: 8-Step Checklist
 Before creating any animation:
 1. **Emotional target?** — joy, calm, urgency, elegance
 2. **Motion Personality?** — Playful, Premium, Corporate, Energetic
 3. **Primary property?** — position, scale, rotation, opacity
 4. **Duration?** — see duration table below
 5. **Easing family?** — entrance=decelerate, exit=accelerate
 6. **Hero element?** — apply staging principles
 7. **Secondary + ambient layers?** — add richness
 8. **1/3 rules?** — motion distance, simultaneous elements
 ---
 ## Three Pillars (CRITICAL)
 Every animation must satisfy three pillars before any technical decisions:
 | Pillar | Question | Drives |
 |--------|----------|--------|
 | **Emotional Intent** | What should the viewer FEEL? | Easing, timing, amplitude |
 | **Visual Narrative** | What's the micro-story? | Setup → Action → Resolution |
 | **Motion Craft** | How do we make it believable? | Physics, secondary motion, paths |
 **Three motion layers** (flat animation = missing layers):
 - **Primary**: Main action the viewer follows
 - **Secondary**: Supporting richness (shadows, icons shifting)
 - **Ambient**: Background life (gradients, subtle pulses)
 > Deep dive: [director/core-philosophy.md](director/core-philosophy.md)
 ---
 ## Motion Personality
 Select ONE archetype per project. Apply consistently.
 | Archetype | Duration | Easing | Overshoot | Keywords |
 |-----------|----------|--------|-----------|----------|
 | **Playful** | 150-300ms | ease-out-back | 10-20% | fun, whimsical, bouncy, cute |
 | **Premium** | 350-600ms | cubic-bezier(0.4,0,0.2,1) | 0% | elegant, minimal, luxury, sophisticated |
 | **Corporate** | 200-400ms | cubic-bezier(0.2,0,0,1) | 0-3% | clean, professional, business, dashboard |
 | **Energetic** | 100-250ms | ease-out-expo | 15-30% | dynamic, energetic, bold, exciting |
 **Default**: Corporate for UI, Playful for illustrations.
 **Brand Motion Identity** — define three constants:
 1. **Signature easing**: One curve for 80% of animations
 2. **Duration palette**: 3 durations (quick / standard / slow)
 3. **Entrance pattern**: One consistent entry style
 > Deep dive: [director/motion-personality.md](director/motion-personality.md)
 ---
 ## Property Selection
 | Effect Goal | Primary Property | Secondary Properties |
 |-------------|------------------|---------------------|
 | Entrance/Exit | position | opacity, scale |
 | Emphasis/Attention | scale | rotation (subtle), opacity pulse |
 | State Change | opacity, color | scale (press feedback) |
 | Direction/Flow | position | rotation (follow path) |
 | Depth/3D Feel | scale + shadow | position (parallax) |
 | Loading/Progress | rotation (spinner) | scale, opacity pulse |
 | Success | scale (pop) | color, rotation (checkmark draw) |
 | Error/Alert | position (shake) | color, rotation (wobble) |
 **Simplicity threshold**: Use the minimum properties needed. One = direct. Two = polished. Three+ = potentially overwhelming.
 > Deep dive: [reference/property-selection.md](reference/property-selection.md)
 ---
 ## Duration Table
 | Element Type | Duration | Rationale |
 |-------------|----------|-----------|
 | Tooltip / micro-feedback | 80-120ms | Must feel instant |
 | Button press / toggle | 120-180ms | Responsive feedback |
 | Icon transition | 150-250ms | Clear state change |
 | Card enter / exit | 200-350ms | Spatial awareness |
 | Modal / dialog | 300-400ms | Focus shift |
 | Page transition | 400-600ms | Context switch |
 | Dramatic reveal | 600-1200ms | Theatrical build |
 **Distance scales duration**: 100px = base. 200px = 1.3x. 400px = 1.6x.
 **Enter > Exit**: Entrances 30-50% longer than exits. Users care about what appears.
 **Interactive feedback**:
 - Hover: <100ms
 - Press: <150ms
 - Release/settle: 200-300ms
 - Error shake: 300-400ms (2-3 oscillations)
 > Deep dive: [reference/timing-easing-tables.md](reference/timing-easing-tables.md)
 ---
 ## Easing Selection
 **Directional rules**:
 - **Entrance** → decelerate (fast start, gentle landing): ease-out family
 - **Exit** → accelerate (gentle start, fast departure): ease-in family
 - **On-screen** → smooth both ends: ease-in-out family
 - **Looping ambient** → seamless: sine-based ease-in-out
 **Industry standards**:
 | Standard | Cubic Bezier | Use For |
 |----------|-------------|---------|
 | Material Design 3 | (0.2, 0, 0, 1) | Default on-screen |
 | MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances, attention |
 | MD3 Accelerate | (0.3, 0, 1, 1) | Exits, dismissals |
 | Apple HIG | (0.25, 0.1, 0.25, 1) | Standard iOS |
 | Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |
 | Gentle float | (0.4, 0, 0.2, 1) | Ambient, background |
 | Bounce settle | (0.175, 0.885, 0.32, 1.275) | Overshoot, playful |
 **Material-based easing**:
 | Material | Duration Scale | Overshoot |
 |----------|---------------|-----------|
 | Rigid (metal, stone) | 1.2x | 0% |
 | Elastic (rubber, gel) | 0.8x | 15-25% |
 | Fluid (water, paint) | 1.5x | 5% |
 | Paper (cards, sheets) | 1.0x | 3-5% |
 | Gas (smoke, fog) | 2.0x | 0% |
 | Glass (brittle) | 0.9x | 0% |
 > Deep dive: [reference/timing-easing-tables.md](reference/timing-easing-tables.md)
 ---
 ## Common Patterns
 ### Button Press (Playful)
 1. **Anticipation**: Scale to 0.97 (50ms, ease-out)
 2. **Squash**: Scale to [1.04, 0.96] (100ms, ease-in)
 3. **Follow through**: Overshoots to 1.02, settles to 1.0 (spring, 200ms)
 4. **Secondary**: Shadow shrinks during press, icon shifts down 2px
 5. **Total**: ~150ms press + 200ms settle
 ### Card Entrance (Premium)
 1. **Start**: 20px below target, opacity 0
 2. **Path**: Slight curve (10px X offset at midpoint)
 3. **Easing**: ease-out-cubic deceleration
 4. **Follow through**: Shadow arrives 50ms after card
 5. **Secondary**: Content fades in 100ms after card lands
 6. **Staging**: Other cards dim to 80%
 ### Success State (Playful)
 1. **Primary**: Scale pop with ease-out-back
 2. **Secondary**: Checkmark draws in
 3. **Ambient**: Subtle particle burst
 4. **Color**: Green fill
 5. **Total**: 300-400ms
 ### Error Shake (Corporate)
 1. **Primary**: Position oscillates 2-3 times, ±10-15px horizontal
 2. **Easing**: ease-in-out for sharp stops
 3. **Color**: Red tint
 4. **Total**: 300-400ms
 5. **No overshoot**: Errors feel firm
 > More patterns: [patterns/entrance-exit.md](patterns/entrance-exit.md) | [patterns/state-feedback.md](patterns/state-feedback.md)
 ---
 ## Choreography Essentials
 **Coordinated entry**:
 - Lead with the hero — primary element enters first or most prominently
 - Spatial consistency — all elements enter from same direction
 - Counter-motion — hero moves right → ambient moves left at 20-30% speed
 **1/3 Rule (distance)**: No motion travels more than 1/3 of screen without a keyframe change.
 **1/3 Rule (elements)**: With 3+ elements, no more than 1/3 in active motion simultaneously.
 **Stagger budgets**:
 | Pattern | Delay | Total Budget | Use Case |
 |---------|-------|-------------|----------|
 | Micro cascade | 20-40ms | <200ms | List items, grid cells |
 | Standard | 50-100ms | <400ms | Cards, panels, nav |
 | Dramatic | 100-200ms | <600ms | Hero sections |
 | Wave | 30-60ms | <500ms | Data visualizations |
 **Critical**: Total stagger must stay under 500ms.
 > Deep dive: [director/choreography.md](director/choreography.md)
 ---
 ## Emotion-to-Motion Map
 | Emotion | Character | Path | Easing | Duration |
 |---------|-----------|------|--------|----------|
 | Joy | Bouncy, arcs | Curved, upward | ease-out-back | 200-400ms |
 | Calm | Smooth, flowing | Gentle curves | sine ease-in-out | 500-1000ms |
 | Urgency | Sharp, fast | Straight lines | ease-out | 100-200ms |
 | Sadness | Slow, downward | Drooping curves | cubic ease-in-out | 600-1200ms |
 | Surprise | Sudden, expanding | Radial outward | ease-out-expo | 150-300ms |
 | Elegance | Slow, controlled | Long arcs | (0.4,0,0.2,1) | 400-700ms |
 | Playfulness | Bouncy, irregular | Arcs, squiggly | ease-out-back | 200-350ms |
 **Path as language**: Angular = tense. Curved = friendly. Spiral = whimsical. Diagonal = purposeful. Vertical = growth/weight. Horizontal = progress.
 > Deep dive: [director/emotion-mapping.md](director/emotion-mapping.md)
 ---
 ## Weight Classification
 | Weight | Examples | Duration | Overshoot | Easing |
 |--------|----------|----------|-----------|--------|
 | Heavy | Modals, overlays | 300-500ms | 0% | Gentle, high damping |
 | Medium | Cards, panels | 200-350ms | 3-5% | Moderate |
 | Light | Tooltips, badges, icons | 80-200ms | 5-15% | Responsive |
 ---
 ## Quality Rules
 ### CRITICAL — never break
 1. **Never linear for spatial movement** — always use easing curves (linear only for spinners, progress bars)
 2. **Never opacity-only** for important state changes — combine with position or scale
 3. **Never exceed 1/3 screen** without intermediate keyframe
 4. **Always three motion layers** — primary + secondary + ambient
 ### HIGH — strongly follow
 1. Match duration to element type (see tables)
 2. Use directional easing (ease-out entrance, ease-in exit)
 3. Apply Disney principles (especially anticipation, follow-through)
 4. Maintain consistent personality across scene
 > Full checklist: [reference/quality-checklist.md](reference/quality-checklist.md)
 ---
 ## Troubleshooting Quick Reference
 | Problem | Likely Cause | Fix |
 |---------|-------------|-----|
 | Looks robotic | Linear easing or no arcs | Add easing curves + arc paths |
 | Feels too slow | Duration too long for element type | Check duration table, use ease-out |
 | Feels cheap/flat | Missing secondary + ambient | Add shadow motion + background life |
 | Too distracting | Too many elements moving | Apply 1/3 rule, reduce amplitude |
 | No personality | Generic easing everywhere | Apply personality archetype consistently |
 > Deep dive: [reference/troubleshooting.md](reference/troubleshooting.md)
 ---
 ## File Reference
 **Philosophy** (director/):
 - [core-philosophy.md](director/core-philosophy.md) — Three Pillars deep dive
 - [decision-framework.md](director/decision-framework.md) — Full decision pipeline
 - [disney-principles.md](director/disney-principles.md) — 12 principles, UI-adapted
 - [motion-personality.md](director/motion-personality.md) — 4 archetypes + brand identity
 - [emotion-mapping.md](director/emotion-mapping.md) — Emotion → motion + color psychology
 - [choreography.md](director/choreography.md) — Multi-element coordination
 - [narrative-structure.md](director/narrative-structure.md) — Micro-story framework
 - [context-adaptation.md](director/context-adaptation.md) — Platform, a11y, performance
 **Reference** (reference/):
 - [timing-easing-tables.md](reference/timing-easing-tables.md) — Duration + easing lookups
 - [property-selection.md](reference/property-selection.md) — Property communication guide
 - [troubleshooting.md](reference/troubleshooting.md) — Animation smells + fixes
 - [quality-checklist.md](reference/quality-checklist.md) — Evaluation criteria
 **Patterns** (patterns/):
 - [entrance-exit.md](patterns/entrance-exit.md) — Entrance/exit recipes
 - [state-feedback.md](patterns/state-feedback.md) — Success, error, loading, hover
 - [ambient-continuous.md](patterns/ambient-continuous.md) — Looping, breathing, parallax
 - [multi-element.md](patterns/multi-element.md) — Stagger + choreography recipes
@@ -0,0 +1,93 @@
 # Choreography
 ## Coordinated Entry Rules
 ### 1. Lead with the Hero
 - Hero gets largest displacement and most attention-grabbing easing
 - Supporting elements are subtler in every dimension
 ### 2. Spatial Origin Consistency
 All elements enter from same direction or shared origin. Mixed directions = chaos.
 ### 3. Counter-Motion
 | Hero Motion | Counter-Motion | Speed Ratio |
 |-------------|---------------|-------------|
 | Enters left | Background shifts right | 20-30% |
 | Scales up | Shadow scales down | 10-20% |
 | Rotates CW | Ambient drifts CCW | 15-25% |
 | Lifts (Y up) | Shadow spreads + softens | 20-30% |
 ## Sequence Structure
 | Phase | Duration Share | What Happens |
 |-------|--------------|-------------|
 | Setup | 20-30% | Elements enter, scene establishes |
 | Action | 30-40% | Primary motion, hero moment |
 | Resolution | 30-40% | Settle, secondary reactions, breathing |
 Leave 100-200ms stillness after resolution before new motion.
 ## The 1/3 Rules
 **Distance**: No motion travels >1/3 screen without intermediate keyframe. Break with direction changes, speed variations, or arc adjustments.
 **Elements**: With 3+ animated elements, max 1/3 active simultaneously. Stagger so element 1 settles as element 3 starts.
 ## Stagger Patterns
 | Pattern | Description | Best For |
 |---------|------------|----------|
 | Sequential | Reading order | Lists, grids |
 | Center-out | Radiating from center | Hero content, ripples |
 | Random | Varied timing | Organic, particle-like |
 | Wave | Sine-based | Data bars, continuous |
 | Reverse | Bottom-to-top | Exits, backward nav |
 - All staggered elements use same easing family
 - Vary only start time, not curve
 - Optional: last element gets slight overshoot (punctuation)
 ## Shared Motion Events
 When multiple elements react to one trigger:
 - All start within 50ms of each other
 - Can arrive at different times (staggered landing)
 - Same easing family; motion originates from trigger point
 ## Attention Direction
 | Technique | Implementation |
 |-----------|---------------|
 | Leading motion | Animate target before context |
 | Following motion | Settle on focal point |
 | Ambient motion | Subtle continuous in periphery |
 | Pointing motion | Directional toward CTA |
 ### Depth Through Speed
 | Layer | Displacement | Speed |
 |-------|-------------|-------|
 | Foreground | 1.0x | Fastest |
 | Midground | 0.5x | Medium |
 | Background | 0.2x | Slowest |
 ## Common Recipes
 ### Dashboard Load
 1. Skeletons fade in (100ms)
 2. Hero metric (250ms, ease-out, 100ms delay)
 3. Supporting cards stagger (50ms between, 200ms each)
 4. Chart data draws in (300ms, starts with cards)
 5. Ambient pulse on primary metric
 ### Modal Open
 1. Background dims (200ms)
 2. Modal scales 95%→100% + fades (300ms, 50ms delay)
 3. Content fades in (200ms, 100ms after modal)
 4. Close button last (150ms)
 ### List Update (item added)
 1. Existing items shift down (200ms, ease-in-out)
 2. New item fades+slides from top (250ms, ease-out, 50ms delay)
 3. Subtle scale overshoot on land (3-5%)
@@ -0,0 +1,83 @@
 # Context Adaptation
 ## Platform Scaling
 | Platform | Duration Modifier | Complexity | Physics |
 |----------|------------------|------------|---------|
 | Desktop | 1.0x (baseline) | Full | All types |
 | Tablet | 0.9x | Standard | Most types |
 | Mobile | 0.8x | Reduced (1-2 properties) | Snappy only |
 | Watch | 0.6x | Minimal (1 property) | None |
 | TV/Kiosk | 1.3x | Full | All types |
 **Mobile rules**: prefer opacity + transform; touch feedback <100ms; reduce stagger budgets by 30%; avoid parallax
 **Desktop opportunities**: hover states, cursor tracking, multi-column stagger, spatial choreography
 ## Accessibility
 ### prefers-reduced-motion
 | Original Motion | Reduced Alternative |
 |----------------|-------------------|
 | Slide entrance | Opacity fade only |
 | Bounce/spring | Instant or simple ease-out |
 | Parallax | Static positioning |
 | Auto-playing | Paused, user-initiated |
 | Complex choreography | Single fade |
 | Continuous ambient | Static or subtle opacity pulse |
 Reduced motion means: remove spatial movement, keep opacity, remove spring easing, reduce duration 50%+, never auto-play loops.
 ### Vestibular Triggers (avoid or provide alternatives)
 - Large-scale zoom, full-screen position transitions
 - Spinning elements >100px, parallax >2 layers, rapid direction changes
 ### Cognitive Accessibility
 - Same interaction = same animation every time
 - Pause controls for animations >5 seconds
 - Don't convey critical info through motion alone
 ## Performance Budgets
 | Tier | Properties | Max Elements |
 |------|-----------|-------------|
 | Optimal | transform, opacity | Unlimited (GPU) |
 | Good | + color, clip-path | 10-15 |
 | Acceptable | + width, height, margin | 5-8 |
 | Avoid | box-shadow, border-radius, filter | 1-3 |
 - Target 60fps (16.67ms/frame); animation logic <10ms/frame
 - will-change sparingly; keep animated elements <20 per viewport
 - Stagger reduces peak load vs simultaneous
 - Fallback: 30fps acceptable for ambient
 ## Content Type Adaptation
 | Content Type | Personality | Duration | Motion Density |
 |-------------|-------------|----------|---------------|
 | Financial | Corporate/Premium | 250-500ms | Low |
 | Social media | Playful | 150-300ms | Medium |
 | Enterprise SaaS | Corporate | 200-400ms | Low |
 | Gaming | Energetic | 100-250ms | High |
 | Healthcare | Corporate/Calm | 300-600ms | Very low |
 | E-commerce | Varies | 200-400ms | Medium |
 | Editorial | Premium | 350-600ms | Low |
 | Children's apps | Playful | 150-300ms | High |
 ## Responsive Motion
 | Container Width | Max Displacement | Duration |
 |----------------|-----------------|----------|
 | <400px | 20% of width | 0.8x |
 | 400-800px | 25% of width | 1.0x |
 | 800-1200px | 20% of width | 1.0x |
 | >1200px | 15% of width | 1.1x |
 - Small viewport: sequential, one element at a time
 - Medium: standard stagger, 2-3 columns
 - Large: full choreography, center-out stagger, parallax
 ## Dark Mode
 - Reduce motion intensity 10-20% (bright on dark = more impact)
 - Subtler ambient motion; careful with opacity values
 - Avoid pure white flashes
@@ -0,0 +1,53 @@
 # Core Philosophy
 ## Three Pillars
 ### Pillar 1: Emotional Intent
 Define target emotion before choosing any property.
 | Emotion | Character | Timing | Easing |
 |---------|----------|--------|--------|
 | Trust | Smooth, predictable | 300-400ms | Gentle curves |
 | Delight | Bouncy, surprising | 200-300ms | Overshoot |
 | Urgency | Sharp, direct | 100-200ms | Snappy ease-out |
 | Calm | Slow, flowing | 500-1000ms | Sine curves |
 | Surprise | Sudden, explosive | 150-300ms | Exponential |
 | Confidence | Direct, decisive | 200-400ms | Strong ease-out |
 ### Pillar 2: Visual Narrative
 | Phase | Duration Share | Purpose |
 |-------|--------------|---------|
 | Setup | 20-30% | Establish context, prepare viewer |
 | Action | 30-40% | Primary motion, hero moment |
 | Resolution | 30-40% | Settle, breathe, confirm |
 Even a 200ms tooltip fade has implicit setup→action→resolution.
 ### Pillar 3: Motion Craft
 - Easing curves match emotional intent
 - Duration proportional to element size and distance
 - Arcs for organic, straight for mechanical
 - Secondary motion (shadows, related elements)
 - Nothing starts and stops all at once
 ## Three Motion Layers
 | Layer | Role | Amplitude |
 |-------|------|-----------|
 | Primary | Main action viewer follows | 100% |
 | Secondary | Supporting richness | 30-50% |
 | Ambient | Background life | 10-20% |
 - Secondary offset 50-100ms from primary, different easing
 - Ambient is continuous/slow, never demands attention
 - Primary-only animation feels flat; always add secondary + ambient
 ## The 1/3 Screen Rule
 No motion travels >1/3 screen without intermediate keyframe. Break with direction changes, speed shifts, or arc adjustments.
 ## The Attention Budget
 - One hero motion per scene moment
 - Max 2-3 elements in active motion simultaneously
 - Ambient doesn't count against budget
 - Stagger rather than synchronize
@@ -0,0 +1,91 @@
 # Decision Framework
 ## The First Questions
 ### 1. Purpose?
 | Purpose | Approach | Priority |
 |---------|----------|----------|
 | Draw attention | Scale, color, pulse | Responsiveness |
 | Guide sequence | Stagger, directional flow | Clarity |
 | Provide feedback | Immediate response | Speed |
 | Create atmosphere | Subtle, continuous | Subtlety |
 | Explain relationship | Position, connection | Legibility |
 | Celebrate/reward | Overshoot, particles | Delight |
 ### 2. Audience?
 - Stressed → calm motion; Browsing → richer motion
 - Task-focused → fast, minimal; Exploring → can be dramatic
 - Seen 100x/day → fast, subtle; Seen once → can be dramatic
 ### 3. Context?
 - Busy layout → simpler motion; Empty → can be dramatic
 - Other animations active → coordinate or stagger
 - Small container → small motion
 ## 4-Level Decision Hierarchy
 ### Level 1: Motion Category
 | Category | When |
 |----------|------|
 | Revealing | Content appearing |
 | Concealing | Content disappearing |
 | Transitioning | Between states/views |
 | Emphasizing | Drawing attention |
 | Responding | Reacting to interaction |
 | Ambient | Background atmosphere |
 ### Level 2: Motion Personality
 Match to brand. See [motion-personality.md](motion-personality.md).
 ### Level 3: Motion Direction
 | Direction | Communicates |
 |-----------|-------------|
 | Upward | Growth, aspiration |
 | Downward | Settling, completion |
 | Leftward | Regression, departure |
 | Rightward | Progression, arrival |
 | Outward (scale up) | Importance, emergence |
 | Inward (scale down) | Dismissal, removal |
 | Center-seeking | Focus, convergence |
 | Center-fleeing | Distribution, release |
 ### Level 4: Implementation Properties
 Choose animated properties. See [property-selection.md](../reference/property-selection.md).
 ## Decision Quick-Path
 ```
 1. PURPOSE → What does this motion DO?
   ├── Feedback → short, ease-out, minimal
   ├── Entrance → ease-out, personality-matched
   ├── Exit → ease-in, 70% of entrance
   ├── Emphasis → scale or color pulse
   └── Ambient → slow, continuous, sine
 2. PERSONALITY → Match keywords
   ├── Fun/bouncy → Playful
   ├── Elegant/luxury → Premium
   ├── Clean/professional → Corporate
   └── Bold/dynamic → Energetic
 3. PROPERTIES → Minimum needed (two = sweet spot)
 4. TIMING → Check duration table, adjust for distance/weight
 5. EASING → Entering=ease-out, Leaving=ease-in, On-screen=ease-in-out, Looping=sine
 ```
 ## Evaluation Before Delivery
 | Check | Question |
 |-------|----------|
 | Purpose | Clear function? |
 | Personality | Matches brand/context? |
 | Repetition | Fine on 100th viewing? |
 | Attention | Respects viewer's focus? |
 | Hierarchy | Reinforces importance? |
 | Layers | Primary + secondary + ambient? |
 | Timing | Duration appropriate? |
@@ -0,0 +1,102 @@
 # Disney's 12 Principles — UI Adapted
 ## 1. Squash and Stretch
 - Squash: scale ~[1.2, 0.8]; Stretch: ~[0.85, 1.15]
 - Impact: 2-4 frames (30-65ms); Recovery: 4-8 frames (65-130ms)
 - Preserve volume: width +20% → height decreases proportionally
 - Skip for premium/luxury brands
 ## 2. Anticipation
 - Small motion opposite to main direction before action
 - Duration: 100-200ms, magnitude: 10-20% of main action
 - Button: scale down 3% before expanding; Card: shift 5-10px away first
 - Skip for micro-feedback (<150ms)
 ## 3. Staging
 - Dim non-hero elements to 40-60% opacity; optional 2-4px blur
 - Hero enters 100-200ms after supporting elements
 - One primary action per timing beat
 ## 4. Straight Ahead vs. Pose to Pose
 | Approach | Feel | Best For |
 |----------|------|----------|
 | Straight Ahead | Fluid, spontaneous | Particles, ambient, generative art |
 | Pose to Pose | Planned, controlled | UI transitions, state changes |
 ## 5. Follow Through and Overlapping Action
 - Child delay: 50-150ms behind parent
 - Trailing elements: offset stop times by 100-200ms
 - Use spring easing for trailing parts (lower stiffness = more trailing)
 ## 6. Slow In and Slow Out
 | Context | Easing | Why |
 |---------|--------|-----|
 | Entrance | ease-out | Arrives smoothly |
 | Exit | ease-in | Departs quickly |
 | On-screen | ease-in-out | Smooth journey |
 | Ambient loop | sine ease-in-out | Seamless |
 **NEVER** linear for spatial movement. Linear only for: rotation, progress bars, timers.
 ## 7. Arcs
 - Add 10-20px perpendicular offset at path midpoint
 - Subtle (5px) for corporate, pronounced (20px+) for playful
 - Mechanical UIs can use straight paths intentionally
 ## 8. Secondary Action
 - Amplitude: 30-50% of primary; timing: 50-100ms after primary
 - Different easing than primary
 - Examples: card enters → shadow grows; button presses → ripple expands
 ## 9. Timing
 | Weight/Mood | Duration |
 |-------------|----------|
 | Heavy (modals, pages) | 400-800ms |
 | Light (tooltips, toggles) | 100-250ms |
 | Sad/serious | 600ms+ |
 | Happy/light | 200-400ms |
 | Urgent | 100-200ms |
 Enter-exit asymmetry: entrances 30-50% longer than exits.
 ## 10. Exaggeration
 | Personality | Exaggeration |
 |-------------|-------------|
 | Playful | 15-25% |
 | Energetic | 20-30% |
 | Corporate | 0-5% |
 | Premium | 0% |
 - Scale overshoot: 10-30% beyond target; rotation: ±5-15°
 ## 11. Solid Drawing
 - Maintain consistent proportions across keyframes
 - Use scale + rotation together for depth
 - Shadow behavior matches implied light source
 ## 12. Appeal
 - Smooth curves over sharp angles; satisfying timing
 - Personality consistency across all elements
 - Appeal killers: jerky motion, inconsistent timing, abrupt stops, uniform animation
 ## Combining Principles
 | Recipe | Principles Used |
 |--------|----------------|
 | Button press | Anticipation + Squash/Stretch + Follow-Through + Secondary + Timing |
 | Card entrance | Anticipation + Arcs + Slow In/Out + Follow-Through + Staging |
 | Success celebration | Exaggeration + Secondary + Timing + Squash/Stretch + Appeal |
 | Error shake | Timing + Slow In/Out + Staging (no exaggeration) |
 | Loading spinner | Timing + Slow In/Out + Appeal |
@@ -0,0 +1,71 @@
 # Emotion-to-Motion Mapping
 ## Core Table
 | Emotion | Character | Path | Easing | Duration |
 |---------|----------|------|--------|----------|
 | Joy/Delight | Bouncy, arcs, overshoot | Curved, upward | ease-out-back | 200-400ms |
 | Calm/Serenity | Smooth, flowing | Gentle curves | sine ease-in-out | 500-1000ms |
 | Urgency/Alert | Sharp, fast, direct | Straight lines | ease-out | 100-200ms |
 | Sadness/Weight | Slow, downward | Drooping curves | cubic ease-in-out | 600-1200ms |
 | Surprise/Impact | Sudden, expanding | Radial outward | ease-out-expo | 150-300ms |
 | Elegance/Grace | Slow, controlled | Long smooth arcs | (0.4, 0, 0.2, 1) | 400-700ms |
 | Playfulness | Bouncy, irregular | Arcs, squiggly | ease-out-back | 200-350ms |
 | Confidence | Direct, decisive | Straight, horizontal | ease-out | 200-400ms |
 | Curiosity | Exploratory, varied | Mixed, circular | varied | 300-500ms |
 | Tenderness | Soft, gentle | Very subtle curves | soft ease-in-out | 600-1000ms |
 ## Path as Emotional Language
 | Path Type | Connotation |
 |-----------|------------|
 | Angular/sharp | Tense, urgent, mechanical |
 | Curved/smooth | Relaxed, friendly, organic |
 | Spiral | Playful, whimsical |
 | Straight diagonal | Dynamic, purposeful |
 | Vertical up | Growth, achievement |
 | Vertical down | Settling, gravity |
 | Horizontal | Journey, progress |
 | Radial outward | Explosion, release |
 | Radial inward | Focus, convergence |
 ## Emotional Intensity
 | Intensity | Characteristics | When |
 |-----------|----------------|------|
 | Low | Subtle opacity, tiny shifts | Ambient, routine |
 | Medium | Visible but not demanding | Most UI interactions |
 | High | Demands attention, large displacement | Errors, celebrations, onboarding |
 ## Color Psychology
 | Color | Emotion | Animation Pairing |
 |-------|---------|------------------|
 | Blue | Trust, calm | Smooth, medium transitions |
 | Green | Success, growth | Upward, expansion, gentle overshoot |
 | Red | Alert, urgency | Sharp, fast, horizontal shakes |
 | Orange | Energy, warmth | Bouncy, diagonal paths |
 | Purple | Premium, mystery | Slow reveals, elegant easing |
 | Yellow | Optimism, caution | Quick pulses |
 | Teal | Modern, clarity | Clean, snappy transitions |
 ### Color Transition Rules
 - Success: transition TO green (don't start with it)
 - Error: flash red then settle (don't sustain)
 - Warning: pulse yellow/amber for urgency
 - Neutral: use opacity rather than color change
 ## Context-Based Emotion Defaults
 | Context | Default Emotion |
 |---------|----------------|
 | Form success | Joy + Confidence |
 | Validation error | Mild urgency |
 | Page load | Calm + Confidence |
 | Navigation | Confidence |
 | Notification | Mild surprise |
 | Loading | Calm |
 | Onboarding | Curiosity + Delight |
 | Dashboard | Calm + Confidence |
 | Purchase complete | Joy + Confidence |
 | Delete/remove | Calm (respectful departure) |
@@ -0,0 +1,89 @@
 # Motion Personality
 ## Four Archetypes
 ### Playful
 | Parameter | Value |
 |-----------|-------|
 | Duration | 150-300ms |
 | Easing | ease-out-back / bouncy springs |
 | Overshoot | 10-20% |
 | Paths | Arcs and curves, never straight |
 | Squash-stretch | Yes, on impacts |
 Signature: bounce settle, squash-stretch on press, rotation wobble, bright color pops, varied stagger timing.
 Use for: children's apps, casual games, social media, celebrations, onboarding, creative tools.
 ### Premium / Luxury
 | Parameter | Value |
 |-----------|-------|
 | Duration | 350-600ms |
 | Easing | cubic-bezier(0.4, 0, 0.2, 1) |
 | Overshoot | 0% |
 | Paths | Smooth curves, subtle parallax |
 | Squash-stretch | Never |
 Signature: slow fades, subtle scale (98%→100%), generous pauses, minimal properties (opacity+one), ultra-smooth.
 Use for: fashion, finance, luxury brands, premium SaaS, portfolios, editorial.
 ### Corporate / Professional
 | Parameter | Value |
 |-----------|-------|
 | Duration | 200-400ms |
 | Easing | cubic-bezier(0.2, 0, 0, 1) |
 | Overshoot | 0-3% |
 | Paths | Mostly straight, small arcs for emphasis |
 | Squash-stretch | No |
 Signature: consistent timing, clear state transitions, functional motion, predictable patterns, uniform stagger.
 Use for: enterprise, dashboards, business tools, admin, healthcare, banking.
 ### Energetic / Dynamic
 | Parameter | Value |
 |-----------|-------|
 | Duration | 100-250ms |
 | Easing | ease-out-expo / elastic |
 | Overshoot | 15-30% |
 | Paths | Dramatic arcs, large displacement, diagonal |
 | Squash-stretch | Yes, exaggerated |
 Signature: large scale changes (50-150%), fast color transitions, particle bursts, accelerating stagger, bold edge entrances.
 Use for: gaming, sports, music, events, marketing, fitness apps.
 ## Keyword Matching
 | Keywords | Archetype |
 |----------|-----------|
 | fun, whimsical, bouncy, cute, friendly | Playful |
 | elegant, minimal, luxury, sophisticated | Premium |
 | clean, professional, business, dashboard | Corporate |
 | dynamic, energetic, bold, exciting | Energetic |
 | (unspecified) + UI | Corporate (default) |
 | (unspecified) + illustration | Playful (default) |
 ## Brand Motion Identity
 Define three constants for recognizable motion:
 ### 1. Signature Easing (80% of animations)
 Playful: ease-out-back | Premium: (0.4,0,0.2,1) | Corporate: (0.2,0,0,1) | Energetic: ease-out-expo
 ### 2. Duration Palette
 | Tier | Playful | Premium | Corporate | Energetic |
 |------|---------|---------|-----------|-----------|
 | Quick | 150ms | 350ms | 200ms | 100ms |
 | Standard | 250ms | 500ms | 300ms | 180ms |
 | Slow | 400ms | 800ms | 450ms | 300ms |
 ### 3. Entrance Pattern
 Playful: bounce up from below | Premium: slow fade + scale 98%→100% | Corporate: slide right + opacity | Energetic: snap from edge + overshoot
 ## Mixing Archetypes
 - 90% primary archetype; specific moments can borrow another
 - Ease into personality shifts, don't snap
 - Example: corporate dashboard borrows Playful for success state only
@@ -0,0 +1,62 @@
 # Narrative Structure
 ## Four-Act Structure
 ### Act 1: Anticipation (10-20%)
 - Wind-up: small motion opposite to main direction
 - Gathering: elements pull together before dispersing
 - Dimming: context fades for focus; Tension: hold compressed ~50ms
 - Skip for <150ms interactions and hover states
 ### Act 2: Action (30-50%)
 Peak energy. The primary communicative motion.
 - Fast+direct (sharp easing) → alerts
 - Smooth+flowing (gentle easing, curves) → transitions
 - Explosive+expanding (expo, radial) → celebrations
 - Controlled+precise (linear-ish) → data charts
 ### Act 3: Reaction (10-20%)
 - Shadows adjust: 50-100ms after primary
 - Siblings shift: 50-150ms after primary
 - Environment ripples: 100-200ms after primary
 - Counter-motion: simultaneous with action
 - Skip for simple toggles/checkboxes
 ### Act 4: Resolution (20-30%)
 - Overshoot settle (spring/back-easing); opacity reaches final (ease-out)
 - 100-200ms breathing room before next motion
 - Even 50ms of settling transforms the feel
 ## Scaling to Duration
 | Total | Anticipation | Action | Reaction | Resolution |
 |-------|-------------|--------|----------|------------|
 | 100-200ms | skip | 60-70% | skip | 30-40% |
 | 200-400ms | 10-15% | 40-50% | 10-15% | 25-30% |
 | 400-800ms | 15-20% | 30-40% | 15-20% | 20-25% |
 | 800ms+ | 20% | 30-35% | 15-20% | 25-30% |
 ## Multi-Beat Narratives
 Transitions: overlap (fluid) | sequential (clear) | simultaneous (parallel)
 Progressions:
 - **Build-Up**: low → rising → peak → settling
 - **Cycle**: depart → peak → return → repeat
 - **Impact**: sudden action → ripple → slow settle
 ## By Personality
 | Personality | Anticipation | Action | Resolution |
 |------------|-------------|--------|------------|
 | Playful | Exaggerated wind-up | Bouncy, overshoot | Wobble settle |
 | Premium | Subtle tension | Smooth, controlled | Elegant ease |
 | Corporate | Minimal/none | Direct, efficient | Clean stop |
 | Energetic | Quick gather | Explosive | Fast snap |
 ## Common Patterns
 - **Reveal**: tension (dim, scale 95%) → emerge (100%, full opacity) → surroundings adjust → settled
 - **Departure**: gather (scale 98%) → exit → close gap → layout settles
 - **Transformation**: destabilize (vibration) → morph → secondary appears → new state breathing
 - **Celebration**: compress (50-100ms) → burst (scale, particles) → settle → calm with positive state
@@ -0,0 +1,81 @@
 # Ambient & Continuous Patterns
 Ambient amplitude: 10-20% of primary motion. Never compete for attention.
 ## Breathing / Pulse
 - Scale oscillation 0.98-1.02, sine ease-in-out, 2000-4000ms/cycle
 - Alt: opacity oscillation 0.7-1.0
 | Context | Scale Range | Duration | Opacity Range |
 |---------|-----------|----------|--------------|
 | Active indicator | 0.95-1.05 | 2000ms | 0.6-1.0 |
 | Waiting/idle | 0.98-1.02 | 3000ms | 0.8-1.0 |
 | Background element | 0.99-1.01 | 4000ms | 0.9-1.0 |
 | CTA attention | 0.97-1.03 | 2500ms | 0.7-1.0 |
 Pulsing >±5% scale becomes attention-demanding.
 ## Floating / Hovering
 - Y position ±5-15px, sine ease-in-out, 3000-5000ms/cycle
 - Optional: slight rotation ±2-3°, offset 30% of position cycle
 **Layered floating** (multiple elements — different durations prevent sync):
 - Element 1: 4000ms, ±10px
 - Element 2: 5500ms, ±8px (offset 30%)
 - Element 3: 3500ms, ±12px (offset 60%)
 ## Gradient Shift
 - Background-position or gradient angle shift
 - Duration: 8000-20000ms/cycle; range: ±10-20% position or ±15° angle
 - Easing: linear or sine; should be imperceptible at a glance
 ## Parallax
 | Layer | Speed Ratio | Content |
 |-------|------------|---------|
 | Foreground | 1.0x | Interactive, text |
 | Midground | 0.5x | Decorative, cards |
 | Background | 0.2x | Patterns, scenery |
 | Deep background | 0.1x | Texture, atmospheric |
 **Scroll-driven**: total displacement <100px; avoid on mobile; never parallax text
 **Mouse-driven**: foreground 10-20px max, background 5-10px opposite direction, 100-200ms interpolation
 ## Continuous Rotation
 - Spinners: linear easing, 1000-2000ms/revolution
 | Variant | Speed | Use Case |
 |---------|-------|----------|
 | Slow spin | 10-30s/rev | Background decoration |
 | Gear-like | 3-5s/rev | Technical/mechanical |
 | Orbital | 5-15s/rev | Space/science theme |
 | Wobble | 2-4s/cycle, sine | Playful idle |
 ## Shimmer / Gleam
 - Gradient sweep left-to-right, 1500-2500ms/sweep
 - Pause 2000-5000ms between sweeps
 - Opacity gradient: 0%→30%→0%
 - Use for: skeleton loading, premium accents, "new" badges
 ## Particle Ambient
 ### Snow/Falling: 10-20 elements, 20-60px/s down, ±10-20px drift, 3-8px, 30-70% opacity
 ### Dust/Motes: 5-10 elements, 10-30px/s mixed, 2-5px, 20-50% opacity
 ### Sparkle/Stars: 8-15 elements, opacity pulse 0→100%→0, 500-1500ms/sparkle, random stagger
 **Performance**: <20 ambient elements, transform+opacity only, larger/fewer over small/numerous
 ## Combining Ambient Layers
 | Layer | Type | Example |
 |-------|------|---------|
 | Background | Gradient shift or parallax | Slow color temperature change |
 | Midground | Floating or particles | Gentle floating elements |
 | Foreground | Breathing or shimmer | Subtle pulse on content |
 Total ambient: max 20% of primary motion's visual energy.
@@ -0,0 +1,82 @@
 # Entrance & Exit Patterns
 ## Entrance Strategies
 ### 1. Direct Entrance (Slide In)
 - Position + opacity; offset 20-40px + opacity 0 → final position + opacity 1
 - Easing: ease-out; duration 200-350ms
 | Personality | Offset | Easing | Overshoot |
 |------------|--------|--------|-----------|
 | Playful | 30-50px | ease-out-back | 10-15% |
 | Premium | 15-25px | (0.4, 0, 0.2, 1) | 0% |
 | Corporate | 20-30px | (0.2, 0, 0, 1) | 0-3% |
 | Energetic | 40-80px | ease-out-expo | 15-25% |
 Direction: below=arrival, right=forward, left=back, above=dropdown/authority.
 ### 2. Emergent Entrance (Scale In)
 - Scale + opacity; start 85-95% + opacity 0 → 100% + opacity 1
 - Duration 250-400ms
 | Personality | Start Scale | Easing | Overshoot |
 |------------|------------|--------|-----------|
 | Playful | 70-80% | ease-out-back | 10-20% |
 | Premium | 95-98% | (0.4, 0, 0.2, 1) | 0% |
 | Corporate | 90-95% | (0.2, 0, 0, 1) | 0-3% |
 | Energetic | 50-70% | ease-out-expo | 15-30% |
 Best for: modals, dialogs, notifications, popovers, tooltips.
 ### 3. Reveal Entrance (Clip/Mask)
 - clip-path or mask + opacity; 300-500ms, ease-out
 - Directions: top-to-bottom (dramatic), L-to-R (reading order), center-out (focus), edge-in (contained)
 ### 4. Assembled Entrance (Multi-Part)
 - Parts arrive from different positions; stagger 50-100ms; total 300-600ms
 - Best for: icon assembly, logo builds, data viz construction
 ## Exit Strategies
 **Rule**: Exits = 65-75% of entrance duration.
 ### 1. Direct Exit (Slide Out)
 - Offset 20-40px + opacity 0; ease-in; 150-250ms
 ### 2. Dissolve Exit (Fade Out)
 - Opacity (+ optional scale to 98%); ease-in; 150-250ms
 - Best for: gentle departures, backgrounding, crossfades
 ### 3. Collapse Exit (Shrink Out)
 - Scale 85-95% + opacity 0; ease-in; 150-250ms
 - Best for: deletion, closing modals, dismissal
 ### 4. Transfer Exit (Move Away)
 - Position toward destination + scale shrink; ease-in-out; 250-400ms
 - Best for: add-to-cart, save-to-collection, move-to-folder
 ## Entrance-Exit Continuity
 - Eye follows naturally from exit to entrance
 - Exit point near entry point when possible
 - 100-150ms timing overlap between exit and entrance
 - Same easing family for paired entrance-exit
 ## Common Recipes
 ### Notification Slide-In
 1. Slide from right + opacity (250ms, ease-out)
 2. Overshoot 3-5% (corporate) or 10-15% (playful)
 3. Icon appears (100ms, 50ms delay)
 ### Toast Dismiss
 1. Slide toward edge + opacity (180ms, ease-in)
 2. Remaining toasts shift up (200ms, ease-in-out)
 ### Dropdown Open
 1. Scale Y 0→100% (200ms, ease-out)
 2. Items stagger fade in (30ms apart, 50ms after container)
 ### Page Transition (Forward)
 1. Current page slides left + fades (300ms, ease-in)
 2. New page from right + fades in (400ms, ease-out, 100ms delay)
 3. Shared elements morph (400ms, ease-in-out)
@@ -0,0 +1,69 @@
 # Multi-Element Patterns
 ## Stagger Recipes
 ### List Items
 - Slide up 20px + fade (200ms, ease-out); stagger 40-60ms; total <400ms for 8 items
 | Personality | Duration | Stagger | Easing |
 |------------|---------|---------|--------|
 | Playful | 250ms | 60ms | ease-out-back |
 | Premium | 350ms | 80ms | (0.4, 0, 0.2, 1) |
 | Corporate | 200ms | 50ms | (0.2, 0, 0, 1) |
 | Energetic | 150ms | 30ms | ease-out-expo |
 ### Grid Cards
 - Scale from 95% + fade (250ms, ease-out); stagger 50-80ms reading order; +20ms per new row
 - Shadow 50ms after card. Alt patterns: center-out, column-first, random
 ### Navigation Items
 - Slide from side + fade (180ms, ease-out); stagger 30-50ms; total <300ms
 ### Dashboard Widgets
 ```
 0ms   — Skeletons visible
 100ms — Hero metric (250ms, ease-out)
 200ms — Widgets begin (200ms each, 60ms stagger)
 350ms — Hero complete, chart draws (300ms)
 500ms — All landed
 650ms — Ambient pulse begins
 ```
 ## Coordinated Sequences
 ### Modal with Content
 0ms: backdrop dims (200ms) → 50ms: modal scales 95%→100% (300ms) → 200ms: title → 280ms: body → 350ms: buttons → 400ms: close button. Content in reading order.
 ### Tab Switch
 0ms: indicator slides (250ms, ease-in-out) + old fades (150ms) → 100ms: new content from tab direction (200ms) → 150ms: elements stagger (40ms)
 ### Accordion
 Expand: arrow rotates (150ms) + height expands (250ms) + content fades at 50ms (200ms); siblings shift (200ms). Collapse: reverse, ease-in.
 ### Page Transition
 Current slides left+fades (300ms, ease-in) → new from right (400ms, ease-out, 100ms delay) → hero scales in → content staggers (50ms). Optional shared element morph (400ms).
 ### Drag and Drop
 Drag: lift (scale 1.03, 150ms); others shift (200ms). Drop: settle (scale 1.0, 200ms); gaps close.
 ## Choreography Rules
 ### Timing Overlap
 0%=methodical | 25%=brisk (standard) | 50%=fluid | 75%=rapid (energetic)
 ### Group Rules
 - Same easing family; different durations/delays fine
 - Exception: secondary/ambient can differ
 ### Shared Origin
 Motion from trigger point; closer=first; farther=more delay
 ### Counter-Motion
 | Hero Does | Counter-Motion |
 |-----------|---------------|
 | Slides right | Background left (20-30%) |
 | Scales up | Shadow spreads |
 | Lifts up | Shadow drops+softens |
 | Rotates CW | Ambient CCW |
 | Expands | Siblings compress |
@@ -0,0 +1,96 @@
 # State & Feedback Patterns
 ## Button Press
 ### Playful
 - Press: scale 0.95 (60ms, ease-out); Release: overshoot 1.05 (80ms); Settle: 1.0 (120ms, spring)
 - Secondary: shadow shrinks/grows; color darkens/brightens. Total ~260ms
 ### Premium
 - Press: scale 0.98 (80ms); Release: 1.0 (150ms, no overshoot)
 - Opacity dims to 90% on press. Total ~230ms
 ### Corporate
 - Press: scale 0.97 (60ms); Release: 1.0 (100ms); overshoot 0-2%
 - Background darkens 10%. Total ~160ms
 ## Hover States
 | Element | Effect | Duration |
 |---------|--------|----------|
 | Button | Scale 1.02-1.05 | <100ms |
 | Card | Scale 1.01-1.02 + shadow lift | <100ms |
 | Link | Color change + underline | <100ms |
 | Icon | Scale 1.1 + rotation 2-5° | <100ms |
 | Image | Scale 1.03 (overflow hidden) | 150ms |
 Hover enter <100ms; hover exit 150-200ms (slower = polished).
 ## Toggle / Switch
 - Thumb slides (120-180ms, ease-in-out); track color transitions simultaneously
 - Slight squash in movement direction
 - Playful: bounce at destination; Premium: smooth, no overshoot
 ## Success State
 ### Checkmark Success
 1. Container: scale 0.9→1.0 (200ms, ease-out-back, 5-10% overshoot)
 2. Checkmark: stroke draw (150ms, ease-out, 100ms delay)
 3. Color: to green (200ms); ambient glow/particles (300ms)
 4. Total: 400-500ms
 ### Confirmation Badge
 1. Badge scales from 0 (200ms, ease-out-back)
 2. Text fades in (150ms, 50ms delay)
 3. Background pulse (300ms, sine)
 ### Payment Success
 1. Spinner → checkmark crossfade (200ms)
 2. Checkmark draws (200ms); container → success color (200ms)
 3. Text fades in (200ms, 100ms delay); optional confetti (300-500ms)
 ## Error State
 ### Error Shake
 - Horizontal oscillation ±10-15px, 2-3 cycles decreasing amplitude
 - ease-in-out, 300-400ms total; red tint; no overshoot; settles at origin
 ### Inline Validation
 1. Error text slides down + fades in (200ms)
 2. Border → red (150ms); icon scales in (150ms, 50ms delay)
 3. Optional single shake (200ms)
 ### Form Submission Error
 1. Button returns to normal (200ms)
 2. Error message slides in (250ms)
 3. Affected fields highlight red (150ms, staggered 30ms)
 4. Smooth scroll to first error (300ms, ease-in-out)
 ## Loading States
 ### Spinner
 - Continuous 360°, linear, 1000-1500ms/rev; optional breathing pulse (2-3s)
 ### Skeleton
 - Gradient sweep L→R, 1500-2000ms; base 10-20% opacity, peak 30-40%
 ### Progress Bar
 - Width/transform, ease-in-out; optional color milestones + shimmer
 ### Indeterminate
 - Oscillating position/width, 1500-2500ms, ease-in-out; continuous, never frantic
 ## Warning State
 1. Yellow/amber border (150ms)
 2. Warning icon scales in (150ms, subtle overshoot)
 3. Optional icon pulse (2-3s, sine); text fades in (200ms, 50ms delay)
 ## Disabled / Enabled
 - **Disabling**: opacity to 50-60% (200ms); optional scale to 98%
 - **Enabling**: opacity to 100% (200ms); optional scale pulse 98%→100%
 ## Focus States
 - Focus ring: scale 95%→100% + opacity (150ms)
 - Card focus: scale 1.01, shadow increase (150ms)
 - Tab nav focus: <100ms; must work with reduced-motion
@@ -0,0 +1,95 @@
 # Property Selection
 ## Position
 | Direction | Meaning |
 |-----------|---------|
 | Upward | Growth, improvement, aspiration |
 | Downward | Settling, completion, grounding |
 | Leftward | Regression, backward, departure |
 | Rightward | Progression, forward, arrival |
 | Toward center | Focus, convergence |
 | Away from center | Distribution, expansion |
 ## Scale
 | Direction | Meaning |
 |-----------|---------|
 | Scale up | Importance, activation, proximity |
 | Scale down | Deprioritization, distance |
 | Pulse | Attention, heartbeat, life |
 | Breathing | Presence, waiting |
 ## Rotation
 | Range | Meaning |
 |-------|---------|
 | Small (5-15°) | Subtle adjustment |
 | Medium (45-90°) | Transformation |
 | Full (360°) | Completion, processing |
 | Continuous | Ongoing activity |
 ## Opacity
 | Direction | Meaning |
 |-----------|---------|
 | Fade in | Arrival, enablement |
 | Fade out | Departure, disablement |
 | Partial | Secondary, disabled state |
 **Rule**: NEVER opacity alone for important state changes. Combine with position or scale.
 ## Color
 | Transition | Meaning |
 |-----------|---------|
 | To green | Success, go |
 | To red | Error, stop |
 | To blue | Trust, active |
 | To gray | Disabled, inactive |
 | Brightening | Activation, focus |
 | Dimming | Deactivation, background |
 ## Combined Properties
 | Combination | Best For |
 |-------------|----------|
 | Position + Opacity | Content appearing/disappearing |
 | Scale + Opacity | Cards, modals, notifications |
 | Position + Scale | Selected items, focused content |
 | Rotation + Scale | Celebrations, playful activation |
 | Position + Rotation | Organic transitions |
 | Color + Scale | State emphasis |
 Primary property carries meaning; secondary adds polish. Two properties is the sweet spot.
 ## Property Selection by Goal
 | Goal | Primary | Secondary | Avoid |
 |------|---------|-----------|-------|
 | Entrance | position | opacity | rotation |
 | Exit | position | opacity | scale up |
 | Button press | scale | color | position |
 | Hover | scale or color | opacity | position |
 | Success | scale | color + opacity | position |
 | Error | position (shake) | color | scale |
 | Loading | rotation | opacity | position |
 | Toggle | position | color | rotation |
 | Notification | position + scale | opacity | rotation |
 | Delete | scale + opacity | position | grow |
 | Selection | scale | color, opacity | rotation |
 | Progress | position or scale | color | opacity |
 ## Performance
 | Property | Performance |
 |----------|-------------|
 | transform (translate, scale, rotate) | Excellent — GPU-accelerated |
 | opacity | Excellent — GPU-accelerated |
 | color / background-color | Good — triggers paint |
 | clip-path | Good — GPU on modern browsers |
 | width / height | Poor — triggers layout |
 | margin / padding | Poor — triggers layout |
 | box-shadow | Poor — expensive paint |
 **Rule**: Prefer transform + opacity for all motion.
@@ -0,0 +1,67 @@
 # Quality Checklist
 ## Visual Quality
 - [ ] Elements >40px for motion, >100px for detail
 - [ ] Readable at full speed without slow-motion
 - [ ] Clear primary, secondary, ambient layers
 - [ ] Counter-motion for balance where needed
 - [ ] Natural arcs (unless intentionally mechanical)
 - [ ] 1/3 rule (distance): no unbroken motion >1/3 container
 - [ ] 1/3 rule (density): max 1/3 elements active simultaneously
 ## Technical Quality
 - [ ] No linear easing on spatial movement
 - [ ] Duration matches element type table
 - [ ] Ease-out entrances, ease-in exits
 - [ ] Duration proportional to distance
 - [ ] Entrance duration >= exit duration
 - [ ] Not opacity-only for important state changes
 - [ ] Stagger total <500ms
 - [ ] Follow-through: child elements offset 50-150ms
 ## Emotional Quality
 - [ ] Target emotion identified before properties
 - [ ] Personality archetype matches brand
 - [ ] Setup → action → resolution structure
 - [ ] Intensity matches interaction importance
 - [ ] Consistent: same interaction = same motion
 - [ ] Appropriate on 100th viewing
 ## Performance Quality
 - [ ] Primary motion uses transform + opacity
 - [ ] <20 animated elements per viewport
 - [ ] No layout-triggering properties animated
 - [ ] Elements staggered, not simultaneous
 - [ ] Maintains 60fps (30fps acceptable for ambient)
 ## Accessibility Quality
 - [ ] prefers-reduced-motion alternative provided
 - [ ] No vestibular triggers without alternative
 - [ ] Same interaction = same animation
 - [ ] Critical info not motion-only
 - [ ] Animations >5s are pausable
 ## Severity Tiers
 ### CRITICAL
 - Linear easing on spatial movement
 - Opacity-only for important states
 - Exceeds 1/3 screen rule
 - Missing primary layer
 - Stagger >500ms
 - Layout property animation causing jank
 ### HIGH
 - Missing secondary layer
 - Duration mismatch with element type
 - Wrong directional easing
 - Inconsistent personality
 - No follow-through
 - Missing reduced-motion alternative
 ### MEDIUM
 - Missing ambient layer
 - No anticipation phase
 - Overshoot mismatch
 - Could use better arcs
 - Missing counter-motion
@@ -0,0 +1,106 @@
 # Timing & Easing Tables
 ## Duration by Element Type
 | Element | Duration |
 |---------|----------|
 | Tooltip / micro-feedback | 80-120ms |
 | Button / toggle | 120-180ms |
 | Icon transition | 150-250ms |
 | Card enter/exit | 200-350ms |
 | Modal / dialog | 300-400ms |
 | Page transition | 400-600ms |
 | Dramatic reveal | 600-1200ms |
 | Ambient | 2000-20000ms |
 ## Distance-Duration Scaling
 50px=0.8x | 100px=1.0x | 200px=1.3x | 300px=1.5x | 400px=1.6x | Full screen=1.8-2.0x
 ## Enter vs. Exit
 Entrance = base (100%). Exit = 65-75% of entrance.
 ## Interactive Feedback
 | Interaction | Max Latency |
 |------------|-------------|
 | Hover | <100ms |
 | Press/tap | <150ms |
 | Release/settle | 200-300ms |
 | Error shake | 300-400ms |
 | Long press | 500-800ms |
 | Drag start | <50ms |
 ## Duration by Personality
 | Personality | Quick | Standard | Slow |
 |------------|-------|----------|------|
 | Playful | 150ms | 250ms | 400ms |
 | Premium | 350ms | 500ms | 800ms |
 | Corporate | 200ms | 300ms | 450ms |
 | Energetic | 100ms | 180ms | 300ms |
 ## Easing: Directional Rules
 Entrance=ease-out | Exit=ease-in | On-screen=ease-in-out | Looping=sine | Rotation/progress=linear
 ## Easing: Industry Standards
 | Name | Cubic Bezier | Use |
 |------|-------------|-----|
 | MD3 Standard | (0.2, 0, 0, 1) | Default on-screen |
 | MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances |
 | MD3 Accelerate | (0.3, 0, 1, 1) | Exits |
 | MD3 Decelerate | (0, 0, 0, 1) | Entering |
 | Apple HIG | (0.25, 0.1, 0.25, 1) | iOS default |
 | Apple Spring | stiffness:300 damping:20 | Interactive |
 | Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |
 | Gentle float | (0.4, 0, 0.2, 1) | Ambient |
 | Bounce settle | (0.175, 0.885, 0.32, 1.275) | Playful |
 | Elastic snap | (0.68, -0.55, 0.265, 1.55) | Dramatic |
 ## Material-Based Easing
 | Material | Duration Scale | Overshoot |
 |----------|---------------|-----------|
 | Rigid (metal) | 1.2x | 0% |
 | Elastic (rubber) | 0.8x | 15-25% |
 | Fluid (water) | 1.5x | 5% |
 | Paper (cards) | 1.0x | 3-5% |
 | Gas (smoke) | 2.0x | 0% |
 | Glass | 0.9x | 0% |
 ## Spring Parameters
 | Feel | Stiffness | Damping |
 |------|-----------|---------|
 | Very stiff | 400+ | 25-30 |
 | Standard | 250-350 | 18-24 |
 | Bouncy | 150-250 | 10-15 |
 | Very bouncy | 100-200 | 5-10 |
 | Gentle | 100-150 | 20-25 |
 Damping: <1.0=oscillates, 1.0=fastest no-oscillation, >1.0=slow settle.
 ## Stagger Patterns
 | Pattern | Delay | Budget |
 |---------|------|--------|
 | Micro cascade | 20-40ms | <200ms |
 | Standard | 50-100ms | <400ms |
 | Dramatic | 100-200ms | <600ms |
 | Wave | 30-60ms | <500ms |
 Direction: top-to-bottom (lists) | L-to-R (horizontal) | center-out (hero) | random (organic) | reverse (exits)
 Total stagger MUST stay <500ms.
 ## Overshoot Budget
 | Context | Overshoot |
 |---------|-----------|
 | Success | 5-10% |
 | Error | 0% |
 | Feedback | 2-5% |
 | Celebration | 15-25% |
 | Premium | 0% |
@@ -0,0 +1,73 @@
 # Troubleshooting
 ## Looks Robotic
 - Linear easing → use ease-out (entrance) or ease-in-out
 - Straight paths → add 10-20px arc at midpoint
 - Uniform timing → stagger 50-100ms between elements
 - Everything synced → offset start/stop 50-150ms
 - No secondary → add shadow, icon reaction, ambient
 ## Feels Too Slow
 - Duration exceeds type budget → check duration table
 - ease-in-out when ease-out works → ease-out feels faster
 - Too much anticipation → reduce to 10% or remove
 - Stagger exceeded → total <500ms
 - Overshoot settle too long → increase damping
 ## Feels Too Fast / Jarring
 - Duration below minimum → modals 300ms+, pages 400ms+
 - No easing → add ease-out minimum
 - Missing resolution → add 50-100ms settle
 - No anticipation on large motion → add 100-200ms wind-up
 ## Feels Cheap / Flat
 - Only primary motion → add secondary + ambient
 - Opacity-only → combine with position or scale
 - Same easing everywhere → vary primary vs secondary
 - No follow-through → child elements trail 50-150ms
 - No overshoot → add 3-10%
 ## Too Distracting
 - Too many moving → 1/3 rule
 - Amplitude too large → reduce to minimum
 - Competing heroes → one per moment, dim rest
 - Ambient too prominent → 10-20% amplitude, slower
 - No breathing room → 100-200ms pause between beats
 ## No Personality
 - Default easing → apply archetype's signature
 - Same duration for all → use personality palette
 - No consistent entrance → define one for project
 - Mixed archetypes → pick one for 90%+
 ## Inconsistent Feel
 - Different easing same-type → standardize per motion type
 - Duration varies same type → use palette consistently
 - Entry direction changes → one origin everywhere
 - Overshoot inconsistent → apply rules consistently
 ## Performance (Dropped Frames)
 - Animating width/height/margin → use transform
 - Too many elements → <20 per viewport
 - Complex shadows/filters → simplify or pre-render
 - No GPU acceleration → transform + opacity
 - All simultaneous → stagger to spread load
 ## Quick Diagnostic
 1. No linear on spatial movement
 2. Duration matches element type
 3. Primary + secondary layers
 4. Consistent personality
 5. Directional easing correct
 6. 1/3 screen rule
 7. 1/3 element rule
 8. Follow-through present
 9. Every motion has purpose
 10. Fine on 100th viewing
 ## Personality Mistakes
 - **Playful**: overshoot >25% = broken; not everything bounces; short+bounce = glitchy
 - **Premium**: too subtle = invisible; too slow = waiting; zero = broken
 - **Corporate**: too conservative = boring; playful easing breaks trust; identical = monotonous
 - **Energetic**: max everywhere = nothing stands out; too many particles; no settle = chaos
@@ -0,0 +1 @@
 ../../.agents/skills/motion-design
@@ -0,0 +1,102 @@
 ---
 name: remotion-video
 description: Create videos from React code with Remotion. Use when the user asks to make, animate, preview, or render a video, motion graphic, intro, caption, or social clip using code.
 ---
 # Remotion Video
 Remotion makes videos out of React components. Each frame is a web page. Render them in order and you get an MP4.
 ## Core ideas
 - **Composition**: one video. Has `width`, `height`, `fps`, `durationInFrames`.
 - **Frame**: `useCurrentFrame()` returns the current frame number. All animation is a function of the frame.
 - **`interpolate`**: maps a frame range to a value range (fade, slide).
 - **`spring`**: natural bouncy motion.
 - **`Sequence`**: shows children only during a frame range.
 - **`AbsoluteFill`**: full-screen layer; stack them for backgrounds.
 - **`Audio` / `OffthreadVideo` / `Img`**: media. Put files in `public/` and load with `staticFile("name.mp3")`.
 ## Workflow
 1. **Plan first.** Ask or decide: length (seconds), size (1920x1080, or 1080x1920 for vertical), fps (30), and the scenes. Keep scenes to a short list.
 2. **Set up** (skip if the project exists):
   ```
   npx create-video@latest
   cd <project> && npm install
   ```
 3. **Write** compositions in `src/`, register them in `src/Root.tsx`.
 4. **Preview**: `npm run dev` (opens Remotion Studio).
 5. **Render**: `npx remotion render <CompositionId> out/video.mp4`
   Still frame: `npx remotion still <CompositionId> out/frame.png --frame=30`
 6. **Verify**: render one still first, check it looks right, then render the full video.
 ## Starter example
 `src/Root.tsx`
 ```tsx
 import { Composition } from "remotion";
 import { Hello } from "./Hello";
 export const RemotionRoot = () => (
  <Composition
    id="Hello"
    component={Hello}
    durationInFrames={150}
    fps={30}
    width={1920}
    height={1080}
    defaultProps={{ title: "Hello, world" }}
  />
 );
 ```
 `src/Hello.tsx`
 ```tsx
 import { AbsoluteFill, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion";
 export const Hello = ({ title }: { title: string }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: "clamp" });
  const scale = spring({ frame, fps, config: { damping: 12 } });
  return (
    <AbsoluteFill style={{ backgroundColor: "#0b1020", justifyContent: "center", alignItems: "center" }}>
      <h1 style={{ color: "white", fontSize: 120, opacity, transform: `scale(${scale})` }}>{title}</h1>
    </AbsoluteFill>
  );
 };
 ```
 ## Rules of thumb
 - Never animate with CSS transitions, `setTimeout`, or CSS animations. They don't render per frame. Drive everything from `useCurrentFrame()`.
 - Always pass `extrapolateRight: "clamp"` to `interpolate` unless you want values to keep growing.
 - Seconds to frames: `seconds * fps`.
 - Use `<Sequence from={..} durationInFrames={..}>` to order scenes; `<Series>` to chain them.
 - Load fonts with `@remotion/google-fonts` so they are ready before rendering.
 - Keep props in `defaultProps` so the user can edit text in the Studio.
 - Rendering needs Chromium and ffmpeg (Remotion installs/handles these); first render can be slow.
 ## Fonts
 Google Fonts: `npm i @remotion/google-fonts`, then
 ```tsx
 import { loadFont } from "@remotion/google-fonts/Inter";
 const { fontFamily } = loadFont();   // use as style={{ fontFamily }}
 ```
 It downloads the font while rendering, so the machine needs internet access to fonts.googleapis.com. If the render fails with "Failed to load font", the network is blocking it: use a local font file in `public/` with `@remotion/fonts` (`loadFont({ family, url: staticFile("x.woff2") })`) or a system font. (Not verified in the sandbox where this skill was tested, which had no access to Google.)
 ## Common problems
 - **Can't download the browser (no internet / locked-down machine)**: point Remotion at an installed Chromium:
  `npx remotion render <Id> out/video.mp4 --browser-executable=/path/to/chromium --chrome-mode=chrome-for-testing`
 - **Blank/white frames**: an asset path is wrong; use `staticFile()`.
 - **Flicker**: an image or font not loaded; use `<Img>` and `@remotion/google-fonts`.
 - **Slow render**: lower resolution/fps while testing, or use `--concurrency`.
 ## Templates
 Copy-paste starting points. Read the one that fits:
 - `templates/captions.md` - words highlighted in time with speech
 - `templates/charts.md` - animated bar chart
 - `templates/intro-outro.md` - title card + chaining scenes with `Series`
 - `templates/audio-voiceover.md` - background music, voiceover, auto video length
 - `templates/vertical.md` - 1080x1920 clips for Reels/TikTok/Shorts
 ## Docs
 https://www.remotion.dev/docs
@@ -0,0 +1,62 @@
 # Template: Audio, music and voiceover
 Put sound files in `public/` (mp3 or wav). Load them with `staticFile()`.
 `src/Narrated.tsx`
 ```tsx
 import { AbsoluteFill, Audio, Sequence, interpolate, staticFile, useVideoConfig } from "remotion";
 import { getAudioDurationInSeconds } from "@remotion/media-utils";
 import type { CalculateMetadataFunction } from "remotion";
 type Props = { title: string; voice: string; music: string };
 // Make the video exactly as long as the voiceover (+1 second of padding).
 export const calcNarratedMetadata: CalculateMetadataFunction<Props> = async ({ props }) => {
  const seconds = await getAudioDurationInSeconds(staticFile(props.voice));
  return { durationInFrames: Math.ceil((seconds + 1) * 30) };
 };
 export const Narrated = ({ title, voice, music }: Props) => {
  const { fps, durationInFrames } = useVideoConfig();
  return (
    <AbsoluteFill style={{ background: "#0b1020", justifyContent: "center", alignItems: "center" }}>
      <h1 style={{ color: "white", fontSize: 110 }}>{title}</h1>
      {/* Background music: quiet, fades out over the last second. */}
      <Audio
        src={staticFile(music)}
        volume={(f) => interpolate(f, [durationInFrames - fps, durationInFrames], [0.15, 0], { extrapolateLeft: "clamp", extrapolateRight: "clamp" })}
      />
      {/* Voiceover starts half a second in, full volume. */}
      <Sequence from={Math.round(fps * 0.5)}>
        <Audio src={staticFile(voice)} volume={1} />
      </Sequence>
    </AbsoluteFill>
  );
 };
 ```
 Register it (note `calculateMetadata`):
 ```tsx
 <Composition
  id="Narrated"
  component={Narrated}
  calculateMetadata={calcNarratedMetadata}
  durationInFrames={300}   // placeholder, replaced by calculateMetadata
  fps={30} width={1920} height={1080}
  defaultProps={{ title: "My story", voice: "voice.mp3", music: "music.mp3" }}
 />
 ```
 Install: `npm i @remotion/media-utils`
 Getting a voiceover
 - Record yourself, or generate speech with a text-to-speech service, and save as `public/voice.mp3`. Never commit API keys; keep them in environment variables.
 - Pair with `templates/captions.md`: feed it word timings from a transcription of the same file.
 Rules
 - Music volume 0.1-0.2 so the voice stays clear.
 - `<Sequence from={...}>` delays when a sound starts.
 - Audio is only in the final render (mp4). Stills (`remotion still`) have no sound.
 - Check the sound made it in: `ffprobe out/video.mp4` should list an `Audio:` stream.
@@ -0,0 +1,38 @@
 # Template: Captions
 Words appear in time with speech. Give each word a start time in seconds.
 `src/Captions.tsx`
 ```tsx
 import { AbsoluteFill, useCurrentFrame, useVideoConfig } from "remotion";
 type Word = { text: string; start: number; end: number }; // seconds
 export const Captions = ({ words, background = "#111" }: { words: Word[]; background?: string }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const t = frame / fps;
  // Show a window of up to 5 words around the current one.
  const current = words.findIndex((w) => t >= w.start && t < w.end);
  const i = current === -1 ? 0 : current;
  const visible = words.slice(Math.floor(i / 5) * 5, Math.floor(i / 5) * 5 + 5);
  return (
    <AbsoluteFill style={{ backgroundColor: background, justifyContent: "flex-end", alignItems: "center", paddingBottom: 200 }}>
      <div style={{ fontSize: 72, fontWeight: 800, color: "white", textShadow: "0 4px 12px black", textAlign: "center", maxWidth: "80%" }}>
        {visible.map((w, k) => (
          <span key={k} style={{ color: t >= w.start && t < w.end ? "#ffd400" : "white", marginRight: 16 }}>
            {w.text}
          </span>
        ))}
      </div>
    </AbsoluteFill>
  );
 };
 ```
 Tips
 - Get word times from a transcription tool (e.g. `@remotion/captions` or Whisper) and save them as JSON in `public/`.
 - `background` is the backdrop when there is no video. Pass `"transparent"` when layering over a video.
 - Layer it over the video: `<AbsoluteFill><OffthreadVideo src={staticFile("clip.mp4")} /><Captions words={words} background="transparent" /></AbsoluteFill>`.
@@ -0,0 +1,37 @@
 # Template: Animated bar chart
 Bars grow one after another.
 `src/BarChart.tsx`
 ```tsx
 import { AbsoluteFill, spring, useCurrentFrame, useVideoConfig } from "remotion";
 type Bar = { label: string; value: number };
 export const BarChart = ({ data, color = "#4f8cff" }: { data: Bar[]; color?: string }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const max = Math.max(...data.map((d) => d.value));
  return (
    <AbsoluteFill style={{ backgroundColor: "#0b1020", padding: 120, justifyContent: "flex-end" }}>
      <div style={{ display: "flex", alignItems: "flex-end", gap: 40, height: 700 }}>
        {data.map((d, i) => {
          const grow = spring({ frame: frame - i * 6, fps, config: { damping: 15 } });
          return (
            <div key={d.label} style={{ flex: 1, textAlign: "center", color: "white", fontSize: 36 }}>
              <div style={{ height: (d.value / max) * 600 * grow, background: color, borderRadius: 8 }} />
              <div style={{ marginTop: 16 }}>{d.label}</div>
            </div>
          );
        })}
      </div>
    </AbsoluteFill>
  );
 };
 ```
 Tips
 - Delay each bar with `frame - i * 6` (6 frames apart).
 - For lines, animate `strokeDashoffset` on an SVG path using `interpolate`.
 - Keep numbers readable: show the value as text, rounded.
@@ -0,0 +1,34 @@
 # Template: Title intro / outro card
 A short card (2-3 seconds) with a title and subtitle. Use at the start or end.
 `src/TitleCard.tsx`
 ```tsx
 import { AbsoluteFill, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion";
 export const TitleCard = ({ title, subtitle }: { title: string; subtitle?: string }) => {
  const frame = useCurrentFrame();
  const { fps, durationInFrames } = useVideoConfig();
  const rise = spring({ frame, fps, config: { damping: 14 } });
  const fadeOut = interpolate(frame, [durationInFrames - 15, durationInFrames], [1, 0], {
    extrapolateLeft: "clamp",
    extrapolateRight: "clamp",
  });
  return (
    <AbsoluteFill style={{ background: "linear-gradient(135deg,#1b2a6b,#0b1020)", justifyContent: "center", alignItems: "center", opacity: fadeOut }}>
      <h1 style={{ color: "white", fontSize: 130, margin: 0, transform: `translateY(${(1 - rise) * 60}px)`, opacity: rise }}>{title}</h1>
      {subtitle && <p style={{ color: "#9fb3ff", fontSize: 48, opacity: rise }}>{subtitle}</p>}
    </AbsoluteFill>
  );
 };
 ```
 Chain with the main video using `<Series>`:
 ```tsx
 <Series>
  <Series.Sequence durationInFrames={90}><TitleCard title="My Video" /></Series.Sequence>
  <Series.Sequence durationInFrames={600}><MainScene /></Series.Sequence>
  <Series.Sequence durationInFrames={90}><TitleCard title="Thanks for watching" /></Series.Sequence>
 </Series>
 ```
@@ -0,0 +1,23 @@
 # Template: Vertical clips (Reels / TikTok / Shorts)
 Same code, different size. Register a vertical composition:
 ```tsx
 <Composition
  id="Vertical"
  component={MyScene}
  width={1080}
  height={1920}
  fps={30}
  durationInFrames={30 * 30} // 30 seconds
 />
 ```
 Render: `npx remotion render Vertical out/vertical.mp4`
 Rules
 - Keep text inside the **safe zone**: about 150px from the top, 350px from the bottom (apps cover those parts with buttons and captions), and 60px from the sides.
 - Use big text (60px+). Phone screens are small.
 - Keep clips under 60 seconds (Shorts limit); 15-30 seconds does best.
 - Use `useVideoConfig()` for width/height instead of hard-coding, so the same scene works wide and tall.
 - Put captions in the lower-middle, above the bottom safe zone (see captions.md).
@@ -1,12 +0,0 @@
 # Copy to .env style settings on your host. Never commit real values.
 ADMIN_EMAIL=rana.krunal7558@gmail.com
 ADMIN_PASSWORD=pick-a-long-password-here
 # Where new tickets are emailed (this is already the default)
 TICKET_TO=rana.krunal7558@gmail.com
 # Gmail sending: use an "App Password", not your normal password
 SMTP_HOST=smtp.gmail.com
 SMTP_PORT=465
 SMTP_USER=rana.krunal7558@gmail.com
 SMTP_PASS=your-16-letter-app-password
 # Set to 1 when hosted behind a proxy (most hosts)
 TRUST_PROXY=1
@@ -1,4 +0,0 @@
 node_modules
 dist
 server/data
 .env
@@ -1,25 +0,0 @@
 # Deploy checklist (Hostinger)
 ## A. Before you start
 - [ ] Plan is Business Web Hosting or a Cloud plan (Node.js Web App supported)
 - [ ] Gmail app password created (myaccount.google.com > Security > 2-Step Verification > App passwords)
 ## B. In hPanel: Websites > Add website > Node.js Web App > Import Git repository
 - [ ] Repo: keithrana/cycle-atlas
 - [ ] Branch: claude/sleepy-goodall-rykli1  (NOT main)
 - [ ] Root/app directory: it-support  (if no such box, ask Claude to split into its own repo)
 - [ ] Node version: 22.x or 24.x
 - [ ] Build command: npm run build
 - [ ] Start command: npm start   (entry file, if asked: server/index.js)
 ## C. Environment variables (type them only into Hostinger, never into chat or Git)
 ADMIN_EMAIL, ADMIN_PASSWORD (10+ chars), SMTP_HOST=smtp.gmail.com, SMTP_PORT=465,
 SMTP_USER, SMTP_PASS (Gmail app password), TRUST_PROXY=1, DATA_DIR=/home/<your-username>/helpdesk-data
 ## D. Deploy, then test in order
 1. [ ] Page loads over https:// and the video plays
 2. [ ] Search "wifi" shows answers; send a test ticket
 3. [ ] Email arrives at rana.krunal7558@gmail.com (check Spam)
 4. [ ] /#/staff login works and the ticket is listed
 5. [ ] Add a test FAQ, redeploy, confirm it is still there (proves data is kept)
 6. [ ] Log out; /#/staff asks for login again
@@ -1,18 +0,0 @@
 # IT Support Site: PRD (plan)
 Restaurant analogy: the FAQ database is the **kitchen's recipe book**. The website is the **dining room**.
 ## Core features
 1. Cinematic hero: looping video, glass buttons (exactly as specified)
 2. Search bar in the hero: type a problem, get matching answers
 3. Category chips: browse the 11 topics (Access, Network, Hardware...)
 4. FAQ answer cards: question, answer, optional "official guide" link
 5. Footer social icons
 ## Phased roadmap
 - **Phase 1 – Food stand (TODAY):** hero + search + categories + 87 FAQs from the database, baked in as a JSON file. No server.
 - **Phase 2 – Small restaurant (DONE, browser-only storage):** "Was this helpful?" votes, "Contact IT" ticket form, shareable links per question.
 - **Phase 3 – Full restaurant (DONE):** small back-of-house server + real database, staff login, admin page to edit FAQs, ticket tracking.
 ## Test ladder
 1. Page loads, no console errors  2. Buttons/search work  3. Real data/links work  4. Security (no raw HTML injection, safe links)
@@ -1,11 +0,0 @@
 # HelpDesk IT Support
 Run locally (needs Node 22+):
    npm install
    npm run build
    ADMIN_EMAIL=you@example.com ADMIN_PASSWORD='a-long-password' npm start
 Open http://localhost:3001 (staff login: http://localhost:3001/#/staff)
 For development with live reload: run `npm run server` and `npm run dev` in two terminals.
 Settings are listed in `.env.example`. Data lives in `server/data/helpdesk.db`: back it up, and keep it on a persistent disk when hosting.
@@ -1,12 +0,0 @@
 <!doctype html>
 <html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>HelpDesk | IT Support</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
 </html>
@@ -1,30 +0,0 @@
 {
  "name": "it-support",
  "private": true,
  "version": "0.1.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "tsc -b && vite build",
    "preview": "vite preview",
    "server": "node server/index.js",
    "start": "NODE_ENV=production node server/index.js"
  },
  "dependencies": {
    "express": "^4.22.3",
    "lucide-react": "^0.460.0",
    "nodemailer": "^10.0.13",
    "react": "^18.3.1",
    "react-dom": "^18.3.1"
  },
  "devDependencies": {
    "@types/react": "^18.3.12",
    "@types/react-dom": "^18.3.1",
    "@vitejs/plugin-react": "^4.3.3",
    "autoprefixer": "^10.4.20",
    "postcss": "^8.4.49",
    "tailwindcss": "^3.4.15",
    "typescript": "~5.6.2",
    "vite": "^5.4.11"
  }
 }
@@ -1 +0,0 @@
 export default { plugins: { tailwindcss: {}, autoprefixer: {} } }
@@ -1,48 +0,0 @@
 import { scryptSync, randomBytes, timingSafeEqual, createHash } from 'node:crypto'
 import { db } from './db.js'
 export const SESSION_DAYS = 7
 export const hashPassword = (pw) => {
  const salt = randomBytes(16)
  return `${salt.toString('hex')}:${scryptSync(pw, salt, 64).toString('hex')}`
 }
 export const verifyPassword = (pw, stored) => {
  const [salt, hash] = stored.split(':')
  const a = Buffer.from(hash, 'hex')
  const b = scryptSync(pw, Buffer.from(salt, 'hex'), 64)
  return a.length === b.length && timingSafeEqual(a, b)
 }
 const sha = (t) => createHash('sha256').update(t).digest('hex')
 export function createSession(staffId) {
  const token = randomBytes(32).toString('hex')
  db.prepare('INSERT INTO sessions VALUES (?,?,?)').run(sha(token), staffId, Date.now() + SESSION_DAYS * 864e5)
  return token
 }
 export const destroySession = (token) => db.prepare('DELETE FROM sessions WHERE token_hash=?').run(sha(token))
 function cookieToken(req) {
  const m = /(?:^|;\s*)session=([a-f0-9]{64})/.exec(req.headers.cookie || '')
  return m ? m[1] : null
 }
 export { cookieToken }
 export function requireStaff(req, res, next) {
  const token = cookieToken(req)
  const row = token && db.prepare('SELECT s.id, s.email, s.name, x.expires FROM sessions x JOIN staff s ON s.id=x.staff_id WHERE x.token_hash=?').get(sha(token))
  if (!row || row.expires < Date.now()) return res.status(401).json({ error: 'Please log in.' })
  req.staff = row
  next()
 }
 // Tiny in-memory rate limiter: `max` hits per `windowMs` per IP+bucket.
 const hits = new Map()
 export const rateLimit = (bucket, max, windowMs) => (req, res, next) => {
  const key = `${bucket}:${req.ip}`
  const now = Date.now()
  const recent = (hits.get(key) || []).filter((t) => now - t < windowMs)
  if (recent.length >= max) return res.status(429).json({ error: 'Too many tries. Please wait a bit.' })
  recent.push(now)
  hits.set(key, recent)
  next()
 }
@@ -1,24 +0,0 @@
 import { DatabaseSync } from 'node:sqlite'
 import { readFileSync, mkdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 const here = dirname(fileURLToPath(import.meta.url))
 const dataDir = process.env.DATA_DIR || join(here, 'data')
 mkdirSync(dataDir, { recursive: true })
 export const db = new DatabaseSync(join(dataDir, 'helpdesk.db'))
 db.exec(`
 CREATE TABLE IF NOT EXISTS faqs (id INTEGER PRIMARY KEY AUTOINCREMENT, category TEXT NOT NULL, question TEXT NOT NULL, answer TEXT NOT NULL, link TEXT NOT NULL DEFAULT '', link_label TEXT NOT NULL DEFAULT '');
 CREATE TABLE IF NOT EXISTS tickets (id TEXT PRIMARY KEY, name TEXT NOT NULL, email TEXT NOT NULL, topic TEXT NOT NULL, message TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'open', emailed INTEGER NOT NULL DEFAULT 0, created TEXT NOT NULL);
 CREATE TABLE IF NOT EXISTS votes (id INTEGER PRIMARY KEY AUTOINCREMENT, faq_id INTEGER NOT NULL, vote TEXT NOT NULL, created TEXT NOT NULL);
 CREATE TABLE IF NOT EXISTS staff (id INTEGER PRIMARY KEY AUTOINCREMENT, email TEXT NOT NULL UNIQUE, name TEXT NOT NULL, password_hash TEXT NOT NULL, created TEXT NOT NULL);
 CREATE TABLE IF NOT EXISTS sessions (token_hash TEXT PRIMARY KEY, staff_id INTEGER NOT NULL, expires INTEGER NOT NULL);
 `)
 // First run: copy the 87 FAQs from the bundled file into the real database.
 if (db.prepare('SELECT COUNT(*) AS n FROM faqs').get().n === 0) {
  const seed = JSON.parse(readFileSync(join(here, '..', 'src', 'data', 'faqs.json'), 'utf8'))
  const ins = db.prepare('INSERT INTO faqs (id, category, question, answer, link, link_label) VALUES (?,?,?,?,?,?)')
  for (const f of seed) ins.run(f.id, f.category, f.question, f.answer, f.link, f.linkLabel)
 }
@@ -1,151 +0,0 @@
 import express from 'express'
 import { existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { randomBytes } from 'node:crypto'
 import { db } from './db.js'
 import { hashPassword, verifyPassword, createSession, destroySession, cookieToken, requireStaff, rateLimit, SESSION_DAYS } from './auth.js'
 import { sendTicketEmail, emailConfigured } from './mail.js'
 const app = express()
 const prod = process.env.NODE_ENV === 'production'
 const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
 const clean = (s, max) => String(s ?? '').replace(/[\r\n]+/g, ' ').trim().slice(0, max)
 const cleanBlock = (s, max) => String(s ?? '').trim().slice(0, max)
 const isHttpUrl = (u) => { try { return ['http:', 'https:'].includes(new URL(u).protocol) } catch { return false } }
 app.set('trust proxy', process.env.TRUST_PROXY ? 1 : false)
 app.disable('x-powered-by')
 app.use((req, res, next) => {
  res.set({
    'X-Content-Type-Options': 'nosniff',
    'X-Frame-Options': 'DENY',
    'Referrer-Policy': 'same-origin',
    'Content-Security-Policy': "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; font-src https://fonts.gstatic.com; media-src https://d8j0ntlcm91z4.cloudfront.net; img-src 'self' data:; connect-src 'self'; frame-ancestors 'none'",
  })
  next()
 })
 app.use(express.json({ limit: '20kb' }))
 // Block cross-site writes: browsers always send Origin on POST/PUT/PATCH/DELETE from other sites.
 app.use((req, res, next) => {
  if (['GET', 'HEAD'].includes(req.method)) return next()
  const origin = req.headers.origin
  if (origin && new URL(origin).host !== req.headers.host) return res.status(403).json({ error: 'Bad origin.' })
  next()
 })
 // ---------- Public ----------
 const faqOut = (r) => ({ id: r.id, category: r.category, question: r.question, answer: r.answer, link: r.link, linkLabel: r.link_label })
 app.get('/api/faqs', (_req, res) => res.json(db.prepare('SELECT * FROM faqs ORDER BY id').all().map(faqOut)))
 app.post('/api/tickets', rateLimit('ticket', 5, 3600e3), async (req, res) => {
  const t = {
    id: `IT-${Date.now().toString(36).toUpperCase()}${randomBytes(2).toString('hex').toUpperCase()}`,
    name: clean(req.body.name, 100), email: clean(req.body.email, 200),
    topic: clean(req.body.topic, 100), message: cleanBlock(req.body.message, 2000),
  }
  if (!t.name) return res.status(400).json({ error: 'Please enter your name.' })
  if (!EMAIL_RE.test(t.email)) return res.status(400).json({ error: 'Please enter a valid email.' })
  if (t.message.length < 10) return res.status(400).json({ error: 'Please describe the problem (at least 10 characters).' })
  db.prepare('INSERT INTO tickets (id,name,email,topic,message,created) VALUES (?,?,?,?,?,?)').run(t.id, t.name, t.email, t.topic, t.message, new Date().toISOString())
  const emailed = await sendTicketEmail(t)
  if (emailed) db.prepare('UPDATE tickets SET emailed=1 WHERE id=?').run(t.id)
  res.status(201).json({ id: t.id })
 })
 app.post('/api/votes', rateLimit('vote', 30, 3600e3), (req, res) => {
  const faqId = Number(req.body.faqId)
  const vote = req.body.vote
  if (!['up', 'down'].includes(vote) || !db.prepare('SELECT 1 FROM faqs WHERE id=?').get(faqId)) return res.status(400).json({ error: 'Bad vote.' })
  db.prepare('INSERT INTO votes (faq_id,vote,created) VALUES (?,?,?)').run(faqId, vote, new Date().toISOString())
  res.status(201).json({ ok: true })
 })
 // ---------- Staff login ----------
 app.post('/api/login', rateLimit('login', 10, 15 * 60e3), (req, res) => {
  const row = db.prepare('SELECT * FROM staff WHERE email=?').get(clean(req.body.email, 200).toLowerCase())
  // Same message either way so attackers can't learn which emails exist.
  if (!row || !verifyPassword(String(req.body.password ?? ''), row.password_hash)) return res.status(401).json({ error: 'Wrong email or password.' })
  const token = createSession(row.id)
  res.cookie('session', token, { httpOnly: true, sameSite: 'strict', secure: prod, maxAge: SESSION_DAYS * 864e5, path: '/' })
  res.json({ name: row.name, email: row.email })
 })
 app.post('/api/logout', (req, res) => {
  const t = cookieToken(req)
  if (t) destroySession(t)
  res.clearCookie('session', { path: '/' })
  res.json({ ok: true })
 })
 app.get('/api/me', requireStaff, (req, res) => res.json({ name: req.staff.name, email: req.staff.email }))
 // ---------- Staff only ----------
 app.get('/api/staff/status', requireStaff, (_req, res) => res.json({ emailConfigured }))
 app.get('/api/staff/tickets', requireStaff, (_req, res) => res.json(db.prepare('SELECT * FROM tickets ORDER BY created DESC').all()))
 app.patch('/api/staff/tickets/:id', requireStaff, (req, res) => {
  if (!['open', 'in_progress', 'closed'].includes(req.body.status)) return res.status(400).json({ error: 'Bad status.' })
  db.prepare('UPDATE tickets SET status=? WHERE id=?').run(req.body.status, req.params.id)
  res.json({ ok: true })
 })
 app.get('/api/staff/faqs', requireStaff, (_req, res) => {
  const votes = db.prepare("SELECT faq_id, SUM(vote='up') AS up, SUM(vote='down') AS down FROM votes GROUP BY faq_id").all()
  const byId = new Map(votes.map((v) => [v.faq_id, v]))
  res.json(db.prepare('SELECT * FROM faqs ORDER BY id').all().map((r) => ({ ...faqOut(r), up: byId.get(r.id)?.up ?? 0, down: byId.get(r.id)?.down ?? 0 })))
 })
 function faqFields(body) {
  const f = { category: clean(body.category, 100), question: clean(body.question, 300), answer: cleanBlock(body.answer, 3000), link: clean(body.link, 500), link_label: clean(body.linkLabel, 200) }
  if (!f.category || !f.question || !f.answer) return { error: 'Category, question and answer are required.' }
  if (f.link && !isHttpUrl(f.link)) return { error: 'Link must start with http:// or https://' }
  return { f }
 }
 app.post('/api/staff/faqs', requireStaff, (req, res) => {
  const { f, error } = faqFields(req.body)
  if (error) return res.status(400).json({ error })
  const r = db.prepare('INSERT INTO faqs (category,question,answer,link,link_label) VALUES (?,?,?,?,?)').run(f.category, f.question, f.answer, f.link, f.link_label)
  res.status(201).json({ id: Number(r.lastInsertRowid) })
 })
 app.put('/api/staff/faqs/:id', requireStaff, (req, res) => {
  const { f, error } = faqFields(req.body)
  if (error) return res.status(400).json({ error })
  db.prepare('UPDATE faqs SET category=?,question=?,answer=?,link=?,link_label=? WHERE id=?').run(f.category, f.question, f.answer, f.link, f.link_label, req.params.id)
  res.json({ ok: true })
 })
 app.delete('/api/staff/faqs/:id', requireStaff, (req, res) => {
  db.prepare('DELETE FROM faqs WHERE id=?').run(req.params.id)
  res.json({ ok: true })
 })
 app.get('/api/staff/team', requireStaff, (_req, res) => res.json(db.prepare('SELECT id,email,name,created FROM staff ORDER BY id').all()))
 app.post('/api/staff/team', requireStaff, (req, res) => {
  const email = clean(req.body.email, 200).toLowerCase(), name = clean(req.body.name, 100), pw = String(req.body.password ?? '')
  if (!EMAIL_RE.test(email) || !name) return res.status(400).json({ error: 'Name and a valid email are required.' })
  if (pw.length < 10) return res.status(400).json({ error: 'Password must be at least 10 characters.' })
  if (db.prepare('SELECT 1 FROM staff WHERE email=?').get(email)) return res.status(409).json({ error: 'That email is already on the team.' })
  db.prepare('INSERT INTO staff (email,name,password_hash,created) VALUES (?,?,?,?)').run(email, name, hashPassword(pw), new Date().toISOString())
  res.status(201).json({ ok: true })
 })
 app.delete('/api/staff/team/:id', requireStaff, (req, res) => {
  if (Number(req.params.id) === req.staff.id) return res.status(400).json({ error: "You can't remove yourself." })
  db.prepare('DELETE FROM sessions WHERE staff_id=?').run(req.params.id)
  db.prepare('DELETE FROM staff WHERE id=?').run(req.params.id)
  res.json({ ok: true })
 })
 app.use('/api', (_req, res) => res.status(404).json({ error: 'Not found.' }))
 // ---------- First staff member ----------
 if (db.prepare('SELECT COUNT(*) AS n FROM staff').get().n === 0) {
  const { ADMIN_EMAIL, ADMIN_PASSWORD } = process.env
  if (ADMIN_EMAIL && ADMIN_PASSWORD && ADMIN_PASSWORD.length >= 10) {
    db.prepare('INSERT INTO staff (email,name,password_hash,created) VALUES (?,?,?,?)').run(ADMIN_EMAIL.toLowerCase(), 'Admin', hashPassword(ADMIN_PASSWORD), new Date().toISOString())
    console.log(`Created first staff login: ${ADMIN_EMAIL}`)
  } else console.warn('No staff yet. Set ADMIN_EMAIL and ADMIN_PASSWORD (10+ characters) and restart.')
 }
 if (!emailConfigured) console.warn('Email not configured (SMTP_HOST/SMTP_USER/SMTP_PASS). Tickets are saved but not emailed.')
 // ---------- Serve the website (production) ----------
 const dist = join(dirname(fileURLToPath(import.meta.url)), '..', 'dist')
 if (existsSync(dist)) app.use(express.static(dist))
 const port = Number(process.env.PORT || 3001)
 app.listen(port, () => console.log(`HelpDesk server on http://localhost:${port}`))
@@ -1,25 +0,0 @@
 import nodemailer from 'nodemailer'
 const { SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, TICKET_TO = 'rana.krunal7558@gmail.com' } = process.env
 const transporter = SMTP_HOST && SMTP_USER && SMTP_PASS
  ? nodemailer.createTransport({ host: SMTP_HOST, port: Number(SMTP_PORT || 465), secure: Number(SMTP_PORT || 465) === 465, auth: { user: SMTP_USER, pass: SMTP_PASS } })
  : null
 export const emailConfigured = !!transporter
 export async function sendTicketEmail(t) {
  if (!transporter) return false
  try {
    await transporter.sendMail({
      from: SMTP_USER,
      to: TICKET_TO,
      replyTo: t.email,
      subject: `[${t.id}] ${t.topic}: new IT request from ${t.name}`,
      text: `Ticket: ${t.id}\nFrom: ${t.name} <${t.email}>\nTopic: ${t.topic}\n\n${t.message}\n`,
    })
    return true
  } catch (e) {
    console.error('Email failed:', e.message)
    return false
  }
 }
@@ -1,165 +0,0 @@
 import { useEffect, useMemo, useRef, useState } from 'react'
 import { ArrowRight, Globe, Instagram, Twitter } from 'lucide-react'
 import VideoBackground from './VideoBackground'
 import FaqList from './Faq'
 import ContactForm from './ContactForm'
 import type { Faq } from './types'
 import Staff from './Staff'
 import faqData from './data/faqs.json'
 const bundledFaqs = faqData as Faq[]
 export default function App() {
  const [faqs, setFaqs] = useState<Faq[]>(bundledFaqs)
  const [isStaff, setIsStaff] = useState(location.hash.startsWith('#/staff'))
  const categories = useMemo(() => Array.from(new Set(faqs.map((f) => f.category))), [faqs])
  useEffect(() => {
    fetch('/api/faqs').then((r) => (r.ok ? r.json() : Promise.reject())).then(setFaqs).catch(() => {})
    const onHash = () => setIsStaff(location.hash.startsWith('#/staff'))
    window.addEventListener('hashchange', onHash)
    return () => window.removeEventListener('hashchange', onHash)
  }, [])
  const [query, setQuery] = useState('')
  const [category, setCategory] = useState<string | null>(null)
  const answersRef = useRef<HTMLElement>(null)
  const results = useMemo(() => {
    const words = query.toLowerCase().split(/\s+/).filter(Boolean)
    return faqs.filter((f) => {
      if (category && f.category !== category) return false
      const text = `${f.question} ${f.answer} ${f.category}`.toLowerCase()
      return words.every((w) => text.includes(w))
    })
  }, [query, category, faqs])
  if (isStaff) return <Staff />
  const scrollToAnswers = () => answersRef.current?.scrollIntoView({ behavior: 'smooth' })
  return (
    <div className="bg-black">
      <div className="min-h-screen bg-black overflow-hidden relative flex flex-col">
        <VideoBackground />
        <nav className="relative z-20 pl-6 pr-6 py-6">
          <div className="liquid-glass rounded-full px-6 py-3 flex items-center justify-between max-w-5xl mx-auto">
            <div className="flex items-center gap-8">
              <div className="flex items-center gap-2 text-white font-semibold text-lg">
                <Globe size={24} />
                <span>HelpDesk</span>
              </div>
              <div className="hidden md:flex items-center gap-8">
                {[
                  ['Topics', '#answers'],
                  ['Search', '#top'],
                  ['Contact', '#contact'],
                ].map(([label, href]) => (
                  <a key={label} href={href} className="text-white/80 hover:text-white transition-colors text-sm font-medium">
                    {label}
                  </a>
                ))}
              </div>
            </div>
            <div className="flex items-center gap-4">
              <a href="#contact" className="text-white text-sm font-medium">Contact IT</a>
              <a href="#/staff" className="liquid-glass rounded-full px-6 py-2 text-white text-sm font-medium">Staff login</a>
            </div>
          </div>
        </nav>
        <div
          id="top"
          className="relative z-10 flex-1 flex flex-col items-center justify-center px-6 py-12 text-center -translate-y-[20%]"
        >
          <h1
            className="text-5xl md:text-6xl lg:text-7xl text-white mb-8 tracking-tight whitespace-nowrap"
            style={{ fontFamily: "'Instrument Serif', serif" }}
          >
            IT help, <em>made simple</em>
          </h1>
          <div className="max-w-xl w-full space-y-4">
            <form
              className="liquid-glass rounded-full pl-6 pr-2 py-2 flex items-center gap-3"
              onSubmit={(e) => {
                e.preventDefault()
                scrollToAnswers()
              }}
            >
              <input
                type="text"
                value={query}
                maxLength={200}
                onChange={(e) => setQuery(e.target.value)}
                placeholder="Describe your problem"
                aria-label="Search IT help"
                className="bg-transparent outline-none flex-1 text-white placeholder:text-white/40 text-base"
              />
              <button type="submit" aria-label="Search" className="bg-white rounded-full p-3 text-black">
                <ArrowRight size={20} />
              </button>
            </form>
            <p className="text-white text-sm leading-relaxed px-4">
              Locked out? Wi-Fi down? Printer acting up? Search {faqs.length} plain-English answers to the most common IT problems.
            </p>
            <div className="flex justify-center">
              <button
                onClick={scrollToAnswers}
                className="liquid-glass rounded-full px-8 py-3 text-white text-sm font-medium hover:bg-white/5 transition-colors"
              >
                Browse all topics
              </button>
            </div>
          </div>
        </div>
        <div className="relative z-10 flex justify-center gap-4 pb-12">
          {[
            { Icon: Instagram, label: 'Instagram' },
            { Icon: Twitter, label: 'Twitter' },
            { Icon: Globe, label: 'Website' },
          ].map(({ Icon, label }) => (
            <button
              key={label}
              aria-label={label}
              className="liquid-glass rounded-full p-4 text-white/80 hover:text-white hover:bg-white/5 transition-all"
            >
              <Icon size={20} />
            </button>
          ))}
        </div>
      </div>
      <section id="answers" ref={answersRef} className="max-w-3xl mx-auto px-6 py-20">
        <h2 className="text-4xl text-white mb-2" style={{ fontFamily: "'Instrument Serif', serif" }}>
          Answers
        </h2>
        <p className="text-white/60 text-sm mb-6" aria-live="polite">
          Showing {results.length} of {faqs.length}
        </p>
        <div className="flex flex-wrap gap-2 mb-8">
          {[null, ...categories].map((c) => (
            <button
              key={c ?? 'all'}
              onClick={() => setCategory(c)}
              aria-pressed={category === c}
              className={`liquid-glass rounded-full px-4 py-2 text-sm transition-colors ${
                category === c ? 'bg-white/20 text-white' : 'text-white/70 hover:text-white hover:bg-white/5'
              }`}
            >
              {c ?? 'All'}
            </button>
          ))}
        </div>
        <FaqList items={results} />
      </section>
      <ContactForm topics={categories} />
      <footer id="about" className="max-w-3xl mx-auto px-6 pb-16 text-center text-white/50 text-sm">
        General guidance only. For account-specific problems, contact your organisation's IT service desk.
      </footer>
    </div>
  )
 }
@@ -1,80 +0,0 @@
 import { useState } from 'react'
 import { Send } from 'lucide-react'
 const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
 const inputCls = 'w-full bg-transparent outline-none text-white placeholder:text-white/40 text-base'
 export default function ContactForm({ topics }: { topics: string[] }) {
  const [form, setForm] = useState({ name: '', email: '', topic: topics[0] ?? '', message: '' })
  const [errors, setErrors] = useState<Record<string, string>>({})
  const [ticketId, setTicketId] = useState<string | null>(null)
  const [sending, setSending] = useState(false)
  const [serverError, setServerError] = useState('')
  const set = (k: keyof typeof form) => (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) =>
    setForm({ ...form, [k]: e.target.value })
  const submit = async (e: React.FormEvent) => {
    e.preventDefault()
    const errs: Record<string, string> = {}
    if (!form.name.trim()) errs.name = 'Please enter your name.'
    if (!EMAIL_RE.test(form.email.trim())) errs.email = 'Please enter a valid email.'
    if (form.message.trim().length < 10) errs.message = 'Please describe the problem (at least 10 characters).'
    setErrors(errs)
    setServerError('')
    if (Object.keys(errs).length) return
    setSending(true)
    try {
      const res = await fetch('/api/tickets', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(form) })
      const data = await res.json().catch(() => ({}))
      if (!res.ok) throw new Error(data.error || 'Something went wrong. Please try again.')
      setTicketId(data.id)
      setForm({ name: '', email: '', topic: topics[0] ?? '', message: '' })
    } catch (err) {
      setServerError(err instanceof Error ? err.message : 'Could not reach the server.')
    } finally {
      setSending(false)
    }
  }
  const field = 'liquid-glass rounded-3xl px-6 py-4'
  const err = (k: string) => errors[k] && <p role="alert" className="text-red-300 text-sm mt-1 px-2">{errors[k]}</p>
  return (
    <section id="contact" className="max-w-3xl mx-auto px-6 pb-20">
      <h2 className="text-4xl text-white mb-2" style={{ fontFamily: "'Instrument Serif', serif" }}>Contact IT</h2>
      <p className="text-white/60 text-sm mb-6">Can't find your answer? Tell us what's wrong.</p>
      {ticketId ? (
        <div className="liquid-glass rounded-3xl p-8 text-white" role="status">
          <p className="text-xl mb-2">Request sent. Your ticket number is <strong>{ticketId}</strong>.</p>
          <p className="text-white/70 text-sm mb-4">Our IT team has been notified. Keep this number if you follow up.</p>
          <button onClick={() => setTicketId(null)} className="liquid-glass rounded-full px-6 py-2 text-sm hover:bg-white/5">Send another</button>
        </div>
      ) : (
        <form onSubmit={submit} noValidate className="space-y-3">
          <div>
            <div className={field}><input className={inputCls} placeholder="Your name" aria-label="Your name" maxLength={100} value={form.name} onChange={set('name')} /></div>
            {err('name')}
          </div>
          <div>
            <div className={field}><input className={inputCls} type="email" placeholder="Your email" aria-label="Your email" maxLength={200} value={form.email} onChange={set('email')} /></div>
            {err('email')}
          </div>
          <div className={field}>
            <select className={`${inputCls} [&>option]:text-black`} aria-label="Topic" value={form.topic} onChange={set('topic')}>
              {topics.map((t) => <option key={t}>{t}</option>)}
            </select>
          </div>
          <div>
            <div className={field}><textarea className={`${inputCls} resize-none`} rows={5} placeholder="What's the problem?" aria-label="Problem description" maxLength={2000} value={form.message} onChange={set('message')} /></div>
            {err('message')}
          </div>
          {serverError && <p role="alert" className="text-red-300 text-sm px-2">{serverError}</p>}
          <button type="submit" disabled={sending} className="bg-white text-black rounded-full px-8 py-3 text-sm font-medium inline-flex items-center gap-2 disabled:opacity-60">
            <Send size={16} /> {sending ? 'Sending...' : 'Send request'}
          </button>
        </form>
      )}
    </section>
  )
 }
@@ -1,120 +0,0 @@
 import { useEffect, useState } from 'react'
 import { Check, ExternalLink, Link2, SearchX, ThumbsDown, ThumbsUp } from 'lucide-react'
 import type { Faq } from './types'
 import { load, save } from './storage'
 type Votes = Record<number, 'up' | 'down'>
 function safeUrl(url: string): string | null {
  try {
    const u = new URL(url)
    return u.protocol === 'https:' || u.protocol === 'http:' ? u.href : null
  } catch {
    return null
  }
 }
 function FaqCard({ f, forceOpen, vote, onVote }: { f: Faq; forceOpen: boolean; vote?: 'up' | 'down'; onVote: (v: 'up' | 'down') => void }) {
  const [copied, setCopied] = useState(false)
  const href = f.link ? safeUrl(f.link) : null
  const copyLink = async () => {
    const url = `${location.origin}${location.pathname}#faq-${f.id}`
    try {
      await navigator.clipboard.writeText(url)
      setCopied(true)
      window.setTimeout(() => setCopied(false), 2000)
    } catch {
      location.hash = `faq-${f.id}`
    }
  }
  const voteBtn = (v: 'up' | 'down', label: string, Icon: typeof ThumbsUp) => (
    <button
      onClick={() => onVote(v)}
      aria-pressed={vote === v}
      className={`liquid-glass rounded-full px-4 py-2 inline-flex items-center gap-2 text-sm transition-colors ${
        vote === v ? 'bg-white/20 text-white' : 'text-white/70 hover:text-white hover:bg-white/5'
      }`}
    >
      <Icon size={14} /> {label}
    </button>
  )
  return (
    <li id={`faq-${f.id}`} className="scroll-mt-6">
      <details className="liquid-glass rounded-3xl group" open={forceOpen || undefined}>
        <summary className="cursor-pointer list-none px-6 py-5 flex items-start justify-between gap-4 text-white">
          <span>
            <span className="block text-xs uppercase tracking-wider text-white/50 mb-1">{f.category}</span>
            <span className="text-lg">{f.question}</span>
          </span>
          <span className="text-white/60 transition-transform group-open:rotate-45 text-2xl leading-none">+</span>
        </summary>
        <div className="px-6 pb-6 text-white/80 text-sm leading-relaxed">
          <p>{f.answer}</p>
          {href && (
            <a href={href} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 mt-4 text-white hover:underline">
              {f.linkLabel || 'Official guide'} <ExternalLink size={14} />
            </a>
          )}
          <div className="mt-5 flex flex-wrap items-center gap-2">
            <span className="text-white/50 mr-1">Was this helpful?</span>
            {voteBtn('up', 'Yes', ThumbsUp)}
            {voteBtn('down', 'No', ThumbsDown)}
            <button
              onClick={copyLink}
              className="liquid-glass rounded-full px-4 py-2 inline-flex items-center gap-2 text-sm text-white/70 hover:text-white hover:bg-white/5 transition-colors ml-auto"
            >
              {copied ? <Check size={14} /> : <Link2 size={14} />} {copied ? 'Link copied' : 'Copy link'}
            </button>
          </div>
          {vote === 'down' && (
            <p className="mt-3 text-white/60">
              Sorry about that. <a href="#contact" className="text-white underline">Contact IT</a> and we'll help directly.
            </p>
          )}
        </div>
      </details>
    </li>
  )
 }
 export default function FaqList({ items }: { items: Faq[] }) {
  const [votes, setVotes] = useState<Votes>(() => load<Votes>('faq-votes', {}))
  const [hashId, setHashId] = useState<number | null>(null)
  useEffect(() => {
    const read = () => {
      const m = /^#faq-(\d+)$/.exec(location.hash)
      setHashId(m ? Number(m[1]) : null)
      if (m) window.setTimeout(() => document.getElementById(`faq-${m[1]}`)?.scrollIntoView({ behavior: 'smooth' }), 50)
    }
    read()
    window.addEventListener('hashchange', read)
    return () => window.removeEventListener('hashchange', read)
  }, [])
  const onVote = (id: number, v: 'up' | 'down') => {
    const next = { ...votes, [id]: v }
    setVotes(next)
    save('faq-votes', next)
    fetch('/api/votes', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ faqId: id, vote: v }) }).catch(() => {})
  }
  if (items.length === 0) {
    return (
      <div className="liquid-glass rounded-3xl p-10 text-center text-white/70">
        <SearchX className="mx-auto mb-3" size={28} />
        <p>No answers found. Try different words, or <a href="#contact" className="text-white underline">contact IT</a>.</p>
      </div>
    )
  }
  return (
    <ul className="space-y-3">
      {items.map((f) => (
        <FaqCard key={f.id} f={f} forceOpen={hashId === f.id} vote={votes[f.id]} onVote={(v) => onVote(f.id, v)} />
      ))}
    </ul>
  )
 }
@@ -1,175 +0,0 @@
 import { useCallback, useEffect, useState } from 'react'
 import { LogOut } from 'lucide-react'
 interface Ticket { id: string; name: string; email: string; topic: string; message: string; status: string; emailed: number; created: string }
 interface StaffFaq { id: number; category: string; question: string; answer: string; link: string; linkLabel: string; up: number; down: number }
 interface Member { id: number; email: string; name: string }
 type Tab = 'tickets' | 'faqs' | 'team'
 async function api<T = unknown>(path: string, method = 'GET', body?: unknown): Promise<T> {
  const res = await fetch(`/api${path}`, { method, headers: body ? { 'Content-Type': 'application/json' } : undefined, body: body ? JSON.stringify(body) : undefined })
  const data = await res.json().catch(() => ({}))
  if (!res.ok) throw Object.assign(new Error(data.error || 'Request failed'), { status: res.status })
  return data as T
 }
 const box = 'liquid-glass rounded-3xl p-6 text-white'
 const input = 'w-full bg-white/5 rounded-2xl px-4 py-3 text-white placeholder:text-white/40 outline-none'
 const btn = 'liquid-glass rounded-full px-5 py-2 text-sm text-white hover:bg-white/5 transition-colors'
 function Login({ onDone }: { onDone: () => void }) {
  const [email, setEmail] = useState('')
  const [password, setPassword] = useState('')
  const [error, setError] = useState('')
  const submit = async (e: React.FormEvent) => {
    e.preventDefault()
    try { await api('/login', 'POST', { email, password }); onDone() } catch (err) { setError((err as Error).message) }
  }
  return (
    <form onSubmit={submit} className={`${box} max-w-sm mx-auto space-y-3`}>
      <h1 className="text-3xl mb-2" style={{ fontFamily: "'Instrument Serif', serif" }}>Staff login</h1>
      <input className={input} type="email" placeholder="Email" aria-label="Email" value={email} onChange={(e) => setEmail(e.target.value)} autoComplete="username" />
      <input className={input} type="password" placeholder="Password" aria-label="Password" value={password} onChange={(e) => setPassword(e.target.value)} autoComplete="current-password" />
      {error && <p role="alert" className="text-red-300 text-sm">{error}</p>}
      <button type="submit" className="bg-white text-black rounded-full px-6 py-2 text-sm font-medium">Log in</button>
    </form>
  )
 }
 function Tickets() {
  const [rows, setRows] = useState<Ticket[]>([])
  const load = useCallback(() => api<Ticket[]>('/staff/tickets').then(setRows), [])
  useEffect(() => { load() }, [load])
  const setStatus = async (id: string, status: string) => { await api(`/staff/tickets/${id}`, 'PATCH', { status }); load() }
  if (!rows.length) return <p className="text-white/60">No tickets yet.</p>
  return (
    <ul className="space-y-3">
      {rows.map((t) => (
        <li key={t.id} className={box}>
          <div className="flex flex-wrap justify-between gap-2 text-sm text-white/60">
            <span>{t.id} · {t.topic} · {new Date(t.created).toLocaleString()}</span>
            <span>{t.emailed ? 'emailed' : 'not emailed'}</span>
          </div>
          <p className="mt-2 whitespace-pre-wrap">{t.message}</p>
          <p className="mt-2 text-sm text-white/70">{t.name} · <a className="underline" href={`mailto:${encodeURIComponent(t.email)}`}>{t.email}</a></p>
          <select aria-label="Status" value={t.status} onChange={(e) => setStatus(t.id, e.target.value)} className="mt-3 bg-white/10 rounded-full px-4 py-2 text-sm [&>option]:text-black">
            <option value="open">Open</option><option value="in_progress">In progress</option><option value="closed">Closed</option>
          </select>
        </li>
      ))}
    </ul>
  )
 }
 const emptyFaq = { category: '', question: '', answer: '', link: '', linkLabel: '' }
 function Faqs() {
  const [rows, setRows] = useState<StaffFaq[]>([])
  const [editing, setEditing] = useState<(typeof emptyFaq & { id?: number }) | null>(null)
  const [error, setError] = useState('')
  const load = useCallback(() => api<StaffFaq[]>('/staff/faqs').then(setRows), [])
  useEffect(() => { load() }, [load])
  const save = async (e: React.FormEvent) => {
    e.preventDefault()
    if (!editing) return
    try {
      if (editing.id) await api(`/staff/faqs/${editing.id}`, 'PUT', editing)
      else await api('/staff/faqs', 'POST', editing)
      setEditing(null); setError(''); load()
    } catch (err) { setError((err as Error).message) }
  }
  const remove = async (f: StaffFaq) => { if (confirm(`Delete "${f.question}"?`)) { await api(`/staff/faqs/${f.id}`, 'DELETE'); load() } }
  const set = (k: keyof typeof emptyFaq) => (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => editing && setEditing({ ...editing, [k]: e.target.value })
  return (
    <div className="space-y-4">
      {editing ? (
        <form onSubmit={save} className={`${box} space-y-3`}>
          <input className={input} placeholder="Category" aria-label="Category" value={editing.category} onChange={set('category')} />
          <input className={input} placeholder="Question" aria-label="Question" value={editing.question} onChange={set('question')} />
          <textarea className={input} rows={5} placeholder="Answer" aria-label="Answer" value={editing.answer} onChange={set('answer')} />
          <input className={input} placeholder="Link (optional, https://...)" aria-label="Link" value={editing.link} onChange={set('link')} />
          <input className={input} placeholder="Link label (optional)" aria-label="Link label" value={editing.linkLabel} onChange={set('linkLabel')} />
          {error && <p role="alert" className="text-red-300 text-sm">{error}</p>}
          <div className="flex gap-2"><button type="submit" className="bg-white text-black rounded-full px-6 py-2 text-sm font-medium">Save</button><button type="button" className={btn} onClick={() => { setEditing(null); setError('') }}>Cancel</button></div>
        </form>
      ) : <button className={btn} onClick={() => setEditing({ ...emptyFaq })}>+ Add FAQ</button>}
      <ul className="space-y-2">
        {rows.map((f) => (
          <li key={f.id} className={`${box} flex flex-wrap items-center justify-between gap-3 !py-4`}>
            <span><span className="block text-xs text-white/50">{f.category}</span>{f.question}</span>
            <span className="flex items-center gap-3 text-sm text-white/70">
              👍 {f.up} 👎 {f.down}
              <button className={btn} onClick={() => setEditing(f)}>Edit</button>
              <button className={btn} onClick={() => remove(f)}>Delete</button>
            </span>
          </li>
        ))}
      </ul>
    </div>
  )
 }
 function Team({ me }: { me: string }) {
  const [rows, setRows] = useState<Member[]>([])
  const [f, setF] = useState({ name: '', email: '', password: '' })
  const [error, setError] = useState('')
  const load = useCallback(() => api<Member[]>('/staff/team').then(setRows), [])
  useEffect(() => { load() }, [load])
  const add = async (e: React.FormEvent) => {
    e.preventDefault()
    try { await api('/staff/team', 'POST', f); setF({ name: '', email: '', password: '' }); setError(''); load() } catch (err) { setError((err as Error).message) }
  }
  const remove = async (m: Member) => { if (confirm(`Remove ${m.name}?`)) { try { await api(`/staff/team/${m.id}`, 'DELETE'); load() } catch (err) { setError((err as Error).message) } } }
  return (
    <div className="space-y-4">
      <ul className="space-y-2">
        {rows.map((m) => (
          <li key={m.id} className={`${box} flex items-center justify-between !py-4`}>
            <span>{m.name} <span className="text-white/60 text-sm">· {m.email}</span></span>
            {m.email !== me && <button className={btn} onClick={() => remove(m)}>Remove</button>}
          </li>
        ))}
      </ul>
      <form onSubmit={add} className={`${box} space-y-3`}>
        <h2 className="text-xl">Add a team member</h2>
        <input className={input} placeholder="Name" aria-label="Name" value={f.name} onChange={(e) => setF({ ...f, name: e.target.value })} />
        <input className={input} type="email" placeholder="Email" aria-label="Email" value={f.email} onChange={(e) => setF({ ...f, email: e.target.value })} />
        <input className={input} type="password" placeholder="Temporary password (10+ characters)" aria-label="Password" value={f.password} onChange={(e) => setF({ ...f, password: e.target.value })} autoComplete="new-password" />
        {error && <p role="alert" className="text-red-300 text-sm">{error}</p>}
        <button type="submit" className="bg-white text-black rounded-full px-6 py-2 text-sm font-medium">Add</button>
      </form>
    </div>
  )
 }
 export default function Staff() {
  const [me, setMe] = useState<{ name: string; email: string } | null | undefined>(undefined)
  const [emailOk, setEmailOk] = useState(true)
  const [tab, setTab] = useState<Tab>('tickets')
  const check = useCallback(() => {
    api<{ name: string; email: string }>('/me').then((m) => { setMe(m); api<{ emailConfigured: boolean }>('/staff/status').then((s) => setEmailOk(s.emailConfigured)) }).catch(() => setMe(null))
  }, [])
  useEffect(() => { check() }, [check])
  const logout = async () => { await api('/logout', 'POST'); setMe(null) }
  return (
    <div className="min-h-screen bg-black text-white px-6 py-10">
      <div className="max-w-3xl mx-auto">
        <div className="flex items-center justify-between mb-8">
          <a href="#" className="text-white/70 hover:text-white text-sm">← Back to site</a>
          {me && <button onClick={logout} className={`${btn} inline-flex items-center gap-2`}><LogOut size={14} /> Log out ({me.name})</button>}
        </div>
        {me === undefined ? <p className="text-white/60">Loading...</p> : me === null ? <Login onDone={check} /> : (
          <>
            {!emailOk && <p className="mb-4 text-amber-300 text-sm">Email is not set up on the server yet, so new tickets are saved here but not emailed.</p>}
            <div className="flex gap-2 mb-6">
              {(['tickets', 'faqs', 'team'] as Tab[]).map((t) => (
                <button key={t} onClick={() => setTab(t)} aria-pressed={tab === t} className={`${btn} capitalize ${tab === t ? 'bg-white/20' : ''}`}>{t === 'faqs' ? 'FAQs' : t}</button>
              ))}
            </div>
            {tab === 'tickets' && <Tickets />}{tab === 'faqs' && <Faqs />}{tab === 'team' && <Team me={me.email} />}
          </>
        )}
      </div>
    </div>
  )
 }
@@ -1,66 +0,0 @@
 import { useCallback, useEffect, useRef } from 'react'
 const VIDEO_URL =
  'https://d8j0ntlcm91z4.cloudfront.net/user_38xzZboKViGWJOttwIXH07lWA1P/hf_20260328_115001_bcdaa3b4-03de-47e7-ad63-ae3e392c32d4.mp4'
 const FADE_MS = 500
 const FADE_OUT_REMAINING = 0.55
 export default function VideoBackground() {
  const videoRef = useRef<HTMLVideoElement>(null)
  const rafRef = useRef<number | null>(null)
  const fadingOutRef = useRef(false)
  const fadeTo = useCallback((target: number) => {
    const video = videoRef.current
    if (!video) return
    if (rafRef.current !== null) cancelAnimationFrame(rafRef.current)
    const startOpacity = parseFloat(video.style.opacity || '0')
    const startTime = performance.now()
    const step = (now: number) => {
      const t = Math.min((now - startTime) / FADE_MS, 1)
      video.style.opacity = String(startOpacity + (target - startOpacity) * t)
      rafRef.current = t < 1 ? requestAnimationFrame(step) : null
    }
    rafRef.current = requestAnimationFrame(step)
  }, [])
  useEffect(() => () => {
    if (rafRef.current !== null) cancelAnimationFrame(rafRef.current)
  }, [])
  const handleTimeUpdate = () => {
    const video = videoRef.current
    if (!video || !video.duration || fadingOutRef.current) return
    if (video.duration - video.currentTime <= FADE_OUT_REMAINING) {
      fadingOutRef.current = true
      fadeTo(0)
    }
  }
  const handleEnded = () => {
    const video = videoRef.current
    if (!video) return
    video.style.opacity = '0'
    window.setTimeout(() => {
      video.currentTime = 0
      void video.play().catch(() => {})
      fadingOutRef.current = false
      fadeTo(1)
    }, 100)
  }
  return (
    <video
      ref={videoRef}
      src={VIDEO_URL}
      autoPlay
      muted
      playsInline
      style={{ opacity: 0 }}
      className="absolute inset-0 w-full h-full object-cover translate-y-[17%]"
      onLoadedData={() => fadeTo(1)}
      onTimeUpdate={handleTimeUpdate}
      onEnded={handleEnded}
    />
  )
 }
@@ -1,698 +0,0 @@
 [
 {
  "id": 1,
  "category": "Access & logins",
  "question": "I forgot my password",
  "answer": "Most organisations have a self-service reset link on the sign-in page, usually 'Forgot password' or 'Can't access your account'. You'll be asked to verify your identity, normally with a code sent to a backup email or phone number you registered earlier. If there's no self-service option, or verification fails, your IT service desk can reset it after confirming your identity another way. Keep any backup codes you were given when MFA was set up somewhere safe, they're often the fastest way back in.",
  "link": "https://support.microsoft.com/en-us/account-billing/how-to-reset-your-microsoft-account-password-eff4f067-5042-c1a3-fe72-b04d60556c37",
  "linkLabel": "Microsoft: reset your password"
 },
 {
  "id": 2,
  "category": "Access & logins",
  "question": "I'm locked out after too many failed attempts",
  "answer": "This is a security feature, not a fault, it stops someone guessing your password repeatedly. Most systems clear the lockout automatically after a set time, often 15 to 30 minutes, so waiting is sometimes the fastest fix. If it's urgent, or the lockout doesn't clear itself, your IT service desk can unlock the account manually once they've verified it's really you.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 3,
  "category": "Access & logins",
  "question": "My multi-factor login (authenticator app) isn't working",
  "answer": "If you've lost your phone or the authenticator app stopped generating valid codes, try a saved backup code first, most systems issue a set of one-time codes when MFA is first set up. If you don't have one, contact IT to re-register your MFA device, this normally requires an identity check (staff or student ID, or a manager confirming it's you) since it's effectively resetting your account security.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 4,
  "category": "Access & logins",
  "question": "My account is disabled or expired after returning from leave",
  "answer": "Accounts are sometimes automatically disabled after a period of inactivity, or a leave period that wasn't flagged as 'returning' in the system. This is an account status issue in the directory (Active Directory or similar), not a password problem, ask IT to check whether the account itself is disabled or expired rather than resetting the password again.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 5,
  "category": "Access & logins",
  "question": "Single sign-on (SSO) keeps redirecting in a loop",
  "answer": "An SSO loop, bouncing between your organisation's login page and the app without ever landing you in, is usually a cookie or session problem rather than your password. Try a private or incognito browser window first, if that works cleanly, clear cookies for your organisation's login domain. If it still loops, the connection between your identity provider and that specific app may need IT to check its configuration.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 6,
  "category": "Access & logins",
  "question": "A guest or contractor account isn't working",
  "answer": "Guest and contractor accounts usually go through a separate approval process, often needing an internal sponsor, and typically expire automatically after a set period for security. If a guest account stops working, check with the person who sponsored the access first, then IT if they confirm it should still be active.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 7,
  "category": "Access & logins",
  "question": "My security questions aren't being accepted during recovery",
  "answer": "Recovery answers need to match exactly what was originally entered, including capitalisation in some systems, so a common cause is simply misremembering the exact wording. If you've genuinely forgotten the answers, look for a 'try another way' option instead of repeatedly guessing, most recovery tools offer an alternative path such as an email or SMS code.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 8,
  "category": "Access & logins",
  "question": "A new password keeps being rejected as too weak or previously used",
  "answer": "Organisations enforce password rules (minimum length, a mix of character types, and often a block on reusing recent passwords) to reduce the risk of a compromised account. A longer passphrase, three or four random unrelated words plus a number and symbol, is both stronger and easier to remember than a short complex one, and tends to pass these checks more easily. Avoid names, birthdays or the organisation's own name.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 9,
  "category": "Network & wifi",
  "question": "My wifi keeps dropping",
  "answer": "Try moving closer to the access point, restarting your device's wifi, and checking if other devices nearby have the same problem, that tells you whether it's your device or the network. On a corporate or school network with certificate-based login (802.1x), an expired certificate is a common cause, IT can reissue it. A network adapter driver that's out of date after a Windows update is another very common cause worth ruling out.",
  "link": "https://support.microsoft.com/en-us/windows/fix-wi-fi-connection-issues-in-windows-9424a1f7-6a3b-65a6-4d78-7f07eee84d2c",
  "linkLabel": "Microsoft: fix Wi-Fi connection issues"
 },
 {
  "id": 10,
  "category": "Network & wifi",
  "question": "The VPN won't connect",
  "answer": "Check your normal internet connection works first. Then fully close and reopen the VPN app rather than just reconnecting, a half-open session is a common cause. Public wifi (cafes, hotels) sometimes blocks VPN traffic entirely until you've accepted its own login page in a browser first.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 11,
  "category": "Network & wifi",
  "question": "I can't reach a shared drive or folder",
  "answer": "Confirm you're connected to the VPN or office network, shared drives usually don't work from the open internet. If it still fails, the folder permissions may have changed, ask IT to check your access rather than repeatedly trying to reconnect.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 12,
  "category": "Network & wifi",
  "question": "I'm getting an IP conflict or 'limited connectivity' message",
  "answer": "This usually means your device didn't get a valid address from the network's DHCP server, often after being moved between networks or waking from sleep. Disconnecting and reconnecting to wifi, or running `ipconfig /release` then `ipconfig /renew` on Windows, fixes most cases. If it keeps happening on the same device, report it, it can indicate a DHCP address pool running low.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 13,
  "category": "Network & wifi",
  "question": "A captive portal (hotel or cafe wifi login page) won't load",
  "answer": "If the login page doesn't appear automatically, try opening a plain, non-secure website, some networks only trigger the portal on unencrypted traffic. A corporate VPN client often blocks the portal from appearing at all, disconnect the VPN first, log in to the wifi, then reconnect the VPN.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 14,
  "category": "Network & wifi",
  "question": "Wifi shows connected but the internet is very slow",
  "answer": "Being 'connected' only confirms a local network link, not that everything beyond it is fast. Run a speed test, then check whether it's isolated to one device (a device or driver issue) or affects everyone nearby, which usually points to the access point, the internet link itself, or a bandwidth-heavy device worth reporting to IT.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 15,
  "category": "Network & wifi",
  "question": "A mapped network drive keeps failing after a password change",
  "answer": "A mapped drive often stores the old credentials separately, so it can keep failing silently even though you can log in to everything else fine. Disconnect the mapped drive and reconnect it fresh, entering the new password when prompted, rather than relying on the saved ones.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 16,
  "category": "Network & wifi",
  "question": "A Bluetooth device won't pair",
  "answer": "Turn Bluetooth off and on again on both devices, and make sure the device is actually in pairing mode. If it was previously paired with a different computer, 'forget' or remove the old pairing on both ends first, most Bluetooth accessories only hold a limited number of paired connections at once.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 17,
  "category": "Hardware",
  "question": "The printer won't print",
  "answer": "Check it's powered on, has paper and toner, and that you picked the right printer name in the print dialog. Network printers can show as 'offline' if they've lost wifi, turning them off and on again often fixes this.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 18,
  "category": "Hardware",
  "question": "An external monitor isn't detected",
  "answer": "Check the cable is firmly in at both ends and try a different port or cable if you have one. Then open your display settings and click 'Detect'. A driver or graphics update can also help on older laptops.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 19,
  "category": "Hardware",
  "question": "A USB device isn't recognised",
  "answer": "Try a different USB port, and a different cable if it's detachable. If it still doesn't show up, check Device Manager (Windows) or System Report (Mac) for a warning icon next to the device.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 20,
  "category": "Hardware",
  "question": "A laptop won't turn on at all",
  "answer": "First rule out a flat battery, plug in the charger, check for a charging light, then leave it 15 to 30 minutes before trying again, some laptops won't start with a completely dead battery even while charging. If there's a charging light but still nothing on screen, try an external monitor, that tells you whether it's a screen problem or the laptop genuinely isn't starting.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 21,
  "category": "Hardware",
  "question": "The battery is draining fast or won't charge",
  "answer": "Test the charger and cable on a different device or outlet first, to rule out a faulty charger rather than the laptop itself. Battery health does genuinely fade over 2 to 4 years of daily use, if the laptop is older and the drop was gradual, a battery replacement through IT asset management is often the real fix rather than a software setting.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 22,
  "category": "Hardware",
  "question": "The keyboard or trackpad isn't responding",
  "answer": "Restart the device first, a stuck driver is a common and simple cause. If only specific keys are affected, check for anything physically stuck underneath, common after spills or crumbs, and try an external USB keyboard or mouse to confirm whether it's the built-in hardware or a wider fault.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 23,
  "category": "Hardware",
  "question": "A docking station isn't detecting monitors or peripherals",
  "answer": "Confirm the dock itself has power, many need their own power cable, not just the laptop cable, and try unplugging the laptop from the dock and reconnecting it firmly. Docks that connect via USB-C or Thunderbolt can be picky about cable quality, swap the cable before assuming the dock has failed.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 24,
  "category": "Hardware",
  "question": "The webcam isn't detected by any app",
  "answer": "Some laptops have a physical privacy shutter or a function-key toggle that disables the camera entirely, check for both before assuming it's broken. Checking Device Manager (Windows) or System Information (Mac) shows whether the operating system sees the camera at all, if it's not listed there, it's a driver or hardware fault rather than an app setting.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 25,
  "category": "Software & apps",
  "question": "My computer is running very slow",
  "answer": "Restart it first, this clears a surprising number of slowdowns. After that, check how much storage is free and close programs you're not using that start automatically. If it's still slow, let IT know, it could be a background update or a bigger issue.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 26,
  "category": "Software & apps",
  "question": "An app keeps crashing or won't open",
  "answer": "Close and reopen it, then restart your computer if that doesn't help. Check whether an update is available. If it's an approved work app that IT installed for you, they may need to reinstall it rather than you doing it yourself.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 27,
  "category": "Software & apps",
  "question": "My email isn't syncing or I'm missing messages",
  "answer": "Check your internet connection and your junk or spam folder. Also check your mailbox isn't full, a full mailbox silently stops receiving mail in some systems. Outlook and Gmail both have a 'repair account' option worth trying.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 28,
  "category": "Software & apps",
  "question": "My camera isn't working in Microsoft Teams",
  "answer": "Close other apps that might already be using the camera (like Zoom or FaceTime), unplug and reconnect it if it's external, and restart the device. Make a test call from Teams' device settings to check camera, mic and speaker together in one go.",
  "link": "https://support.microsoft.com/en-US/teams/meetings/my-camera-isn-t-working-in-microsoft-teams",
  "linkLabel": "Microsoft: Teams camera troubleshooting"
 },
 {
  "id": 29,
  "category": "Software & apps",
  "question": "Zoom audio or video isn't working",
  "answer": "Check the correct microphone, speaker and camera are selected inside Zoom's own settings, not just that your device isn't muted at the operating system level. If it's a browser-based meeting, the browser also needs camera and microphone permission granted specifically for that site.",
  "link": "https://support.zoom.us/",
  "linkLabel": "Zoom support"
 },
 {
  "id": 30,
  "category": "Software & apps",
  "question": "Windows Update is stuck or won't install",
  "answer": "Restart the device once and let it sit for at least 30 minutes, some updates genuinely take a long time on the 'working on updates' screen, and interrupting them can cause more problems than waiting. If it's still stuck well beyond that, or fails repeatedly, note the exact error code for IT, the built-in update troubleshooter resolves a lot of common stuck updates on its own.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 31,
  "category": "Software & apps",
  "question": "Office or Microsoft 365 shows 'unlicensed product' or won't activate",
  "answer": "This usually means the app can't confirm your licence with Microsoft's servers, often because you're signed in with the wrong account, or you've been offline too long since the last successful check-in. Sign out and back in with your work or school account specifically, not a personal Microsoft account, and make sure you're online or on VPN when it tries to reactivate.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 32,
  "category": "Software & apps",
  "question": "'Access denied' or 'permission denied' opening a file",
  "answer": "This is almost always a permissions setting on the file or folder itself, not a fault with your computer. Confirm you're opening it from the right location, a synced local copy can behave differently to the shared original, and if you believe you should have access, ask the file's owner or IT to check the permission list rather than trying to force it open.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 33,
  "category": "Security",
  "question": "I received a suspicious email, is it phishing?",
  "answer": "Don't click links or open attachments. Check the sender's actual email address, not just the display name, and look for urgency or requests for passwords or gift cards, common phishing signs. Report it to your IT security team rather than deleting it, they may need to warn others across the organisation.",
  "link": "https://www.cyber.gov.au/report-and-recover",
  "linkLabel": "ACSC: report a cybercrime (ReportCyber)"
 },
 {
  "id": 34,
  "category": "Security",
  "question": "My computer crashed or showed a blue screen",
  "answer": "Note down any error code or message shown before it restarts, a photo on your phone is fine. Restart the computer. If it happens more than once, that error code is exactly what IT will need to diagnose it.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 35,
  "category": "Security",
  "question": "I think I've been hit by ransomware",
  "answer": "If files suddenly become inaccessible with strange new extensions, or a ransom note appears, disconnect the device from the network immediately (unplug the cable or turn off wifi) without shutting it down, this can stop it spreading before you power off. Don't pay anything and don't try to remove it yourself, contact IT security immediately, this is treated as a priority incident.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 36,
  "category": "Security",
  "question": "I suspect my account has been compromised",
  "answer": "Change your password immediately from a device you trust, and check for any MFA devices, mail forwarding rules, or app connections you don't recognise, attackers often quietly add a forwarding rule or a second MFA device to keep access even after the password changes. Report it to IT security even after you've changed the password, they may need to check for wider impact.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 37,
  "category": "Security",
  "question": "What actually makes a strong password or passphrase",
  "answer": "Length matters more than complexity, three or four random unrelated words make a passphrase that's both stronger and easier to remember than a short complex one. Never reuse a password across personal and work accounts, and use a password manager rather than trying to remember unique passwords for everything, most organisations provide or approve one.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 38,
  "category": "Security",
  "question": "How to report a data breach or accidental data exposure",
  "answer": "If personal or sensitive information was sent to the wrong person, uploaded somewhere public by mistake, or a device holding such data is lost or stolen, report it to IT and your privacy contact as soon as possible. Timing genuinely matters for breach response, and in government and other regulated sectors there can be mandatory notification obligations attached.",
  "link": "https://www.cyber.gov.au/report-and-recover",
  "linkLabel": "ACSC: report and recover"
 },
 {
  "id": 39,
  "category": "Security",
  "question": "Windows is asking for a BitLocker recovery key",
  "answer": "This usually appears after a hardware or firmware change, like a BIOS update, a new battery, or a changed boot order, that the encryption chip treats as suspicious, it's the protection working as intended, not a sign of a hack. The 48-digit recovery key is normally stored in your organisation's directory (Azure AD/Intune) or was saved separately when the device was set up, IT can retrieve it if you don't have it yourself. Microsoft itself cannot recover a lost key, so if neither you nor IT can locate it, the drive has to be reset.",
  "link": "https://support.microsoft.com/en-us/help/4026181",
  "linkLabel": "Microsoft: find your BitLocker recovery key"
 },
 {
  "id": 40,
  "category": "Security",
  "question": "A Mac is asking for a FileVault recovery key",
  "answer": "Similar to Windows BitLocker, this appears after certain hardware or firmware changes and is the encryption protecting your data working as designed. The recovery key is usually escrowed with your organisation's MDM (Jamf or similar), IT can retrieve it if it wasn't saved when the device was set up.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 41,
  "category": "Security",
  "question": "Antivirus or endpoint protection just quarantined a file or blocked something",
  "answer": "Don't try to restore or override it yourself, even if you're confident the file is safe, false positives do happen but confirming that is IT security's job, not yours. Report exactly what you were doing and what the alert said, that detail is what determines whether it's a false positive or something needing wider action.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 42,
  "category": "Security",
  "question": "A USB drive or device is blocked by policy",
  "answer": "Many organisations block USB storage devices entirely as a data-loss-prevention measure, this is deliberate policy rather than a fault, and it usually can't be worked around with a different port or drive. If you have a genuine business need to transfer files this way, request an exception through IT rather than trying another device.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 43,
  "category": "Sector notes",
  "question": "Why are some settings locked on my device?",
  "answer": "Government, school and many corporate devices are deliberately locked down for security, this is policy, not a fault. Australian government agencies generally follow the ACSC's Essential Eight security controls, which is why things like installing your own software or changing certain settings are restricted to IT staff.",
  "link": "https://www.cyber.gov.au/resources-business-and-government/essential-cybersecurity/essential-eight",
  "linkLabel": "ACSC: Essential Eight explained"
 },
 {
  "id": 44,
  "category": "Sector notes",
  "question": "School: why is a legitimate website or resource blocked?",
  "answer": "Australian schools typically apply internet content filtering as required by state and territory education department policy, and manage student devices through a mobile device management (MDM) system. If a legitimate educational site is blocked, that's a filtering rule, not a fault, report it to the school's IT support so they can review or whitelist it rather than trying to work around the filter.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 45,
  "category": "Sector notes",
  "question": "Government: why can't I install software myself?",
  "answer": "Restricting who can install software (application control) is one of the Essential Eight strategies Australian government agencies are expected to implement, it stops unapproved or malicious software running on government devices. If you need software for a work purpose, the usual path is a request to IT for review and installation through an approved, managed process.",
  "link": "https://www.cyber.gov.au/resources-business-and-government/essential-cybersecurity/essential-eight",
  "linkLabel": "ACSC: Essential Eight explained"
 },
 {
  "id": 46,
  "category": "Sector notes",
  "question": "Corporate: why can't I do everything on my personal (BYOD) device?",
  "answer": "A personal device enrolled for work access (BYOD) is usually only given a limited, contained work profile rather than full management of the whole device, protecting both your personal data and the organisation's. If a work app or file won't open, or copy-paste out of a work app is blocked, that's often a deliberate BYOD policy restriction rather than a technical fault.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 47,
  "category": "How IT support works",
  "question": "What do Level 1, 2, 3 (and 4) support actually mean?",
  "answer": "Level 1 is the frontline help desk, handling common self-service issues like this page's Access, Wifi and Hardware topics, usually resolved in one call or ticket. Level 2 is more technical staff who handle things needing deeper diagnosis, like the Network Hardware topics here. Level 3 is specialist or senior engineers, often involved in design and complex incidents, and Level 4 is the vendor's own support (Cisco TAC, Fortinet support), brought in when the issue is inside the product itself, not the configuration.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 48,
  "category": "How IT support works",
  "question": "When should something be escalated to the next level?",
  "answer": "As a general rule, escalate when the fix needs a permission, tool, or specialist knowledge the current level doesn't have, not simply because an issue is taking a long time. A good escalation includes what's already been tried, exact error messages, and which users or systems are affected, that context is what actually speeds up the next level's diagnosis.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 49,
  "category": "How IT support works",
  "question": "What's the difference between an incident, a request, and a problem?",
  "answer": "An incident is something broken right now (the printer isn't printing, the VPN is down), the goal is to restore service quickly. A request is asking for something new (new software, more storage, account access), it follows an approval process rather than a fix. A problem is the underlying root cause behind repeated incidents, if the same printer fails every Monday, that pattern gets investigated as a problem so it stops recurring, rather than just fixed each time it happens.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 50,
  "category": "How IT support works",
  "question": "Where does a change request fit in?",
  "answer": "A change request is a planned, deliberate modification to a system, like a firmware upgrade or a new firewall rule, done through an approval process because unplanned changes are one of the most common causes of new incidents. This is why network hardware changes especially are usually scheduled for a maintenance window rather than made on the spot.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 51,
  "category": "Mobile & remote work",
  "question": "A phone or tablet won't enrol in the company's mobile device management (MDM)",
  "answer": "Confirm you're using the exact enrolment method IT specified (a QR code, an enrolment URL, or a specific app store link), a generic 'add work account' option in phone settings sometimes skips steps the proper enrolment method includes. Also check the device's operating system version meets what IT requires, MDM enrolment is commonly blocked on outdated OS versions for security reasons.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 52,
  "category": "Mobile & remote work",
  "question": "Work email or apps stopped working on a personal phone after an update",
  "answer": "A phone OS update can reset app permissions or trigger a compliance re-check by the organisation's MDM, temporarily blocking access until the device is confirmed to still meet security requirements like having a passcode set. Check for a compliance or 'action needed' notification from the company portal app before assuming it's broken.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 53,
  "category": "Mobile & remote work",
  "question": "A mobile VPN drops every time the screen locks",
  "answer": "Many phones aggressively kill background network connections to save battery, including VPN apps, unless the app is specifically excluded from battery optimisation. Check the phone's battery settings for an 'unrestricted' or 'no optimisation' option for that VPN app specifically.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 54,
  "category": "Mobile & remote work",
  "question": "A remote desktop (RDP) session freezes or won't connect",
  "answer": "Confirm you're connected to the VPN first if the remote machine is inside a private network, RDP almost never works over the open internet directly, for good security reasons. If the VPN is connected but it still fails, check whether the remote machine is actually powered on and not asleep, a surprisingly common cause.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 55,
  "category": "Mobile & remote work",
  "question": "A VDI session (Citrix, Horizon) is slow or won't launch",
  "answer": "Test your own internet connection's latency and stability first, VDI performance is very sensitive to a poor home connection in a way a locally installed app isn't. If your connection is fine, try a different VDI client version or a browser-based login as a workaround while reporting the failure to IT with the exact error shown.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 56,
  "category": "Mobile & remote work",
  "question": "Working from home, the VPN connects but internal apps still time out",
  "answer": "Some VPN setups use 'split tunnelling', where only traffic for specific internal systems goes through the VPN and everything else uses your home internet directly, if a newer internal app isn't yet included in that list, it will time out even with the VPN connected. That's a configuration detail for IT to add, not something you can usually fix from your end.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 57,
  "category": "Cloud storage & sync",
  "question": "OneDrive is stuck on 'processing changes' or won't sync",
  "answer": "Pause and resume syncing from the OneDrive icon in the system tray, this resets a stuck sync engine more often than you'd expect. A very long file path, a file open in another program, or special characters in a file name are the next most common causes of a stuck sync. Moving the affected file out of the synced folder and back in again can also clear a single stuck item without resetting the whole sync.",
  "link": "https://support.microsoft.com/en-us/onedrive/fix-onedrive-sync-problems",
  "linkLabel": "Microsoft: fix OneDrive sync problems"
 },
 {
  "id": 58,
  "category": "Cloud storage & sync",
  "question": "Google Drive shows a red exclamation mark on a file",
  "answer": "This means that specific file failed to sync, usually because it's open in another application, too large for your remaining storage quota, or has a file type or name Drive can't handle. Hover over the icon for the exact reason, then close the file elsewhere or check your storage quota before retrying.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 59,
  "category": "Cloud storage & sync",
  "question": "Cloud storage quota is full",
  "answer": "Check what's actually taking up space first, large video files and old email attachments are common causes, rather than immediately requesting more storage. If you genuinely need more for legitimate work purposes, that's a request rather than an incident (see 'How IT support works'), so it goes through IT's normal approval process.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 60,
  "category": "Cloud storage & sync",
  "question": "A shared file link says 'access denied' for someone outside the organisation",
  "answer": "Many organisations restrict external sharing by default for security, so a link that works fine internally can fail for an outside recipient. Check the specific sharing settings on that file or folder, external sharing is often something that needs to be deliberately enabled per-file or per-site, rather than being on by default.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 61,
  "category": "Cloud storage & sync",
  "question": "Files show as 'online-only' and won't open without internet",
  "answer": "Cloud sync clients often keep infrequently used files as a placeholder to save local disk space, downloading the real content only when opened, which fails without an internet connection. Right-click the specific file or folder you need offline and choose 'always keep on this device' before you lose connectivity, before a flight or a site visit, for example.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 62,
  "category": "macOS specific",
  "question": "A Mac update is stuck or won't install",
  "answer": "Confirm there's enough free disk space, macOS updates need significant free space to stage the install and fail silently without it. Restart once and try again from System Settings rather than clicking install repeatedly, which can leave the updater in a confused state.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 63,
  "category": "macOS specific",
  "question": "Time Machine backup keeps failing",
  "answer": "Check the backup drive isn't full and is actually connected and mounted, an intermittent external drive connection is the most common cause. If backing up to a network location, confirm you can still reach that server or NAS at all, a backup failure is often really a network or permissions issue in disguise.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 64,
  "category": "macOS specific",
  "question": "A Mac keeps asking for the keychain password unexpectedly",
  "answer": "This usually happens after a password change that the login keychain doesn't yet know about, since it's a separate password store from your account login. Go to Keychain Access and update or reset the login keychain's password to match your new account password, rather than repeatedly dismissing the prompt. Resetting the keychain does clear its saved passwords, so only do this if you can't recover the old one.",
  "link": "https://support.apple.com/guide/keychain-access/kyca2429/mac",
  "linkLabel": "Apple: update your keychain password"
 },
 {
  "id": 65,
  "category": "macOS specific",
  "question": "A Mac won't join a corporate wifi network with certificate login",
  "answer": "Confirm the required certificate is actually installed in the Mac's keychain, it's normally pushed automatically by MDM (Jamf or similar) but can fail to install if the Mac hasn't checked in with MDM recently. Manually forcing an MDM check-in (System Settings > general profile management) before retrying the wifi connection resolves this in many cases.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 66,
  "category": "Network hardware (IT staff)",
  "question": "A Cisco switch port shows no link light",
  "answer": "Start at the physical layer: reseat the cable, try a different port, and check for a bad SFP. Then confirm the port isn't administratively shut down with `show interfaces status`, if it is, `no shutdown` brings it back up.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 67,
  "category": "Network hardware (IT staff)",
  "question": "A Cisco port went err-disabled",
  "answer": "This means the switch shut the port down itself, usually after a security violation, a BPDU guard trip, or a duplex mismatch. Check the reason with `show interfaces status err-disabled`, fix the underlying cause, then cycle the port with `shutdown` then `no shutdown`.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 68,
  "category": "Network hardware (IT staff)",
  "question": "Devices can't reach each other across a Cisco VLAN or trunk",
  "answer": "Confirm the VLAN exists on both switches with `show vlan brief`, then check the trunk with `show interfaces trunk`. A mismatched native VLAN or a VLAN missing from the allowed list is the most common cause.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 69,
  "category": "Network hardware (IT staff)",
  "question": "A Cisco router or Layer 3 switch can't reach a remote subnet",
  "answer": "Check `show ip interface brief` to confirm the interface is up, then `show ip route` to confirm a route exists. `ping` and `traceroute` will show exactly where the path breaks.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 70,
  "category": "Network hardware (IT staff)",
  "question": "A Cisco device is running hot (high CPU)",
  "answer": "Check `show processes cpu sorted` to see what's using it. A spanning-tree loop or broadcast storm is a common cause on switches, `show spanning-tree` will show repeated topology changes if that's happening.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 71,
  "category": "Network hardware (IT staff)",
  "question": "A FortiGate isn't passing traffic that looks like it should be allowed",
  "answer": "Confirm a firewall policy actually matches the source, destination and service, then use `diagnose sniffer packet any 'host x.x.x.x' 4` to see if traffic is arriving, and `diagnose debug flow` to see how the FortiGate is treating it.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 72,
  "category": "Network hardware (IT staff)",
  "question": "A FortiGate site-to-site IPsec VPN won't come up",
  "answer": "Phase 1 and Phase 2 settings (encryption, PSK or certificate, proposals) must match exactly on both ends. `diagnose vpn ike log-filter` with `diagnose debug application ike -1` shows exactly where negotiation is failing.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 73,
  "category": "Network hardware (IT staff)",
  "question": "A FortiGate is slow or unresponsive",
  "answer": "Check `get system performance status` for CPU, memory and session count, and `diagnose sys top` to see which process is responsible. A nearly-full session table is a common cause on busy units.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 74,
  "category": "Network hardware (IT staff)",
  "question": "Can't reach the FortiGate admin GUI from a particular network",
  "answer": "FortiGate can restrict admin access to trusted hosts and specific interfaces. Check the admin account's trusted host settings and confirm the interface you're connecting through has HTTPS/SSH admin access enabled.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 75,
  "category": "Network hardware (IT staff)",
  "question": "How to safely back up a Cisco device's configuration",
  "answer": "Before any change, save the running config to the startup config with `copy running-config startup-config`, then copy it off the device via TFTP or SCP so there's an external copy too. Always confirm the backup completed before making changes.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 76,
  "category": "Network hardware (IT staff)",
  "question": "How to safely upgrade Cisco IOS firmware",
  "answer": "Confirm the new image is supported on the exact hardware model and that there's enough flash and RAM. Copy the image to flash, verify its checksum, set the new boot variable, save the config, then reload in a maintenance window in case it needs rolling back.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 77,
  "category": "Network hardware (IT staff)",
  "question": "Lost the password to a Cisco device",
  "answer": "Password recovery needs physical console access and a reboot into ROMMON mode to bypass the startup config temporarily. This is a standard, well-documented process, but the exact key combination differs by model, check the vendor documentation for your specific device first.",
  "link": "https://www.cisco.com/c/en/us/support/index.html",
  "linkLabel": "Cisco Support"
 },
 {
  "id": 78,
  "category": "Network hardware (IT staff)",
  "question": "A wireless access point won't join the Cisco WLC",
  "answer": "Check the AP can discover the controller (DHCP option 43, DNS, or same-subnet broadcast), and that the AP's firmware is compatible with the controller's software version, a mismatch is a common cause of a failed join.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 79,
  "category": "Network hardware (IT staff)",
  "question": "Traffic is blocked on a Cisco ASA despite a matching ACL",
  "answer": "Check NAT rules aren't exempting or redirecting the traffic unexpectedly, and confirm the ACL is applied in the right direction on the right interface. `packet-tracer` simulates a specific flow and shows exactly which rule drops it.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 80,
  "category": "Network hardware (IT staff)",
  "question": "One FortiGate in an HA cluster won't sync",
  "answer": "Check both units are running the identical firmware version first, a mismatch is the most common HA sync blocker. `diagnose sys ha status` shows the current sync state and any errors.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 81,
  "category": "Network hardware (IT staff)",
  "question": "A FortiSwitch isn't showing up under FortiGate management",
  "answer": "FortiGate manages FortiSwitches over FortiLink, confirm the FortiLink interface is correctly configured and that the switch port used for FortiLink hasn't been repurposed for something else.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 82,
  "category": "Network hardware (IT staff)",
  "question": "A FortiAP won't join its FortiGate",
  "answer": "Confirm the AP can discover the FortiGate (same subnet, or DHCP option 138/CAPWAP discovery across routed networks) and that the AP and FortiGate firmware are a supported combination.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 83,
  "category": "Network hardware (IT staff)",
  "question": "SD-WAN traffic is taking the wrong path on a FortiGate",
  "answer": "Check the SD-WAN rule order, first match wins, and whether the SLA health checks for that link are actually passing, a failed health check silently removes a path from consideration. `diagnose sys sdwan` shows live link status.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 84,
  "category": "Network hardware (IT staff)",
  "question": "A FortiGate says its licence or support contract has expired",
  "answer": "An expired contract stops signature and firmware updates but doesn't usually stop the firewall passing traffic. Check the exact status with `get system status`, then renew through your reseller or Fortinet, running without updates for long is a real security risk.",
  "link": "",
  "linkLabel": ""
 },
 {
  "id": 85,
  "category": "Network hardware (IT staff)",
  "question": "Where to find full Cisco documentation and command syntax",
  "answer": "Always confirm exact command syntax against Cisco's own docs, it changes between switch/router models and IOS versions.",
  "link": "https://www.cisco.com/c/en/us/support/index.html",
  "linkLabel": "Cisco Support"
 },
 {
  "id": 86,
  "category": "Network hardware (IT staff)",
  "question": "Where to find full Fortinet documentation and command syntax",
  "answer": "FortiOS CLI commands and defaults vary by firmware version, the official Fortinet Document Library is the source of truth.",
  "link": "https://docs.fortinet.com/",
  "linkLabel": "Fortinet Document Library"
 },
 {
  "id": 87,
  "category": "Network hardware (IT staff)",
  "question": "An IPsec tunnel looks correctly configured but still won't come up",
  "answer": "When the config looks right on paper, checking the live IKE negotiation logs tells you more than re-checking the configuration a third time. Fortinet's own support community has a detailed walkthrough of the exact `diagnose` commands and log filters their engineers use for exactly this scenario.",
  "link": "https://community.fortinet.com/t5/FortiGate/Troubleshooting-Tip-IPsec-VPN-tunnels/ta-p/195955",
  "linkLabel": "Fortinet Community: IPsec VPN troubleshooting"
 }
 ]
@@ -1,37 +0,0 @@
@import url('https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&display=swap');
@tailwind base;
@tailwind components;
@tailwind utilities;
 .liquid-glass {
  background: rgba(255, 255, 255, 0.01);
  background-blend-mode: luminosity;
  backdrop-filter: blur(4px);
  -webkit-backdrop-filter: blur(4px);
  border: none;
  box-shadow: inset 0 1px 1px rgba(255, 255, 255, 0.1);
  position: relative;
  overflow: hidden;
 }
 .liquid-glass::before {
  content: '';
  position: absolute;
  inset: 0;
  border-radius: inherit;
  padding: 1.4px;
  background: linear-gradient(
    180deg,
    rgba(255, 255, 255, 0.45) 0%,
    rgba(255, 255, 255, 0.15) 20%,
    rgba(255, 255, 255, 0) 40%,
    rgba(255, 255, 255, 0) 60%,
    rgba(255, 255, 255, 0.15) 80%,
    rgba(255, 255, 255, 0.45) 100%
  );
  -webkit-mask: linear-gradient(#fff 0 0) content-box, linear-gradient(#fff 0 0);
  -webkit-mask-composite: xor;
  mask-composite: exclude;
  pointer-events: none;
 }
@@ -1,10 +0,0 @@
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import App from './App'
 import './index.css'
 ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
 )
@@ -1,17 +0,0 @@
 // Safe wrappers: localStorage can be blocked (private mode), so never let it crash the page.
 export function load<T>(key: string, fallback: T): T {
  try {
    const raw = localStorage.getItem(key)
    return raw ? (JSON.parse(raw) as T) : fallback
  } catch {
    return fallback
  }
 }
 export function save(key: string, value: unknown): void {
  try {
    localStorage.setItem(key, JSON.stringify(value))
  } catch {
    /* ignore */
  }
 }
@@ -1,8 +0,0 @@
 export interface Faq {
  id: number
  category: string
  question: string
  answer: string
  link: string
  linkLabel: string
 }
@@ -1 +0,0 @@
 /// <reference types="vite/client" />
@@ -1,6 +0,0 @@
 /** @type {import('tailwindcss').Config} */
 export default {
  content: ['./index.html', './src/**/*.{ts,tsx}'],
  theme: { extend: {} },
  plugins: [],
 }
@@ -1,15 +0,0 @@
 {
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["ES2020", "DOM", "DOM.Iterable"],
    "module": "ESNext",
    "moduleResolution": "bundler",
    "jsx": "react-jsx",
    "strict": true,
    "resolveJsonModule": true,
    "skipLibCheck": true,
    "noEmit": true,
    "isolatedModules": true
  },
  "include": ["src", "vite.config.ts"]
 }
@@ -1 +0,0 @@
 {"root":["./src/App.tsx","./src/ContactForm.tsx","./src/Faq.tsx","./src/Staff.tsx","./src/VideoBackground.tsx","./src/main.tsx","./src/storage.ts","./src/types.ts","./src/vite-env.d.ts","./vite.config.ts"],"version":"5.6.3"}
@@ -1,8 +0,0 @@
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 export default defineConfig({
  plugins: [react()],
  base: './',
  server: { proxy: { '/api': 'http://localhost:3001' } },
 })
@@ -1,11 +0,0 @@
 {
  "name": "cycle-atlas-root",
  "private": true,
  "version": "1.0.0",
  "description": "Root wrapper so hosts can build and start the IT Support site in it-support/",
  "engines": { "node": ">=22.13" },
  "scripts": {
    "build": "npm --prefix it-support install --include=dev && npm --prefix it-support run build",
    "start": "NODE_ENV=production node it-support/server/index.js"
  }
 }
@@ -0,0 +1,11 @@
 {
  "version": 1,
  "skills": {
    "motion-design": {
      "source": "LottieFiles/motion-design-skill",
      "sourceType": "github",
      "skillPath": "skills/motion-design/SKILL.md",
      "computedHash": "9fcf9130cc46ee8fd1d8e09a9263347a9d76efbcbfa46591cc4cefaf19bbb453"
    }
  }
 }
		`@@ -1 +0,0 @@`
			`export default { plugins: { tailwindcss: {}, autoprefixer: {} } }`
		`@@ -1 +0,0 @@`
			`{"root":["./src/App.tsx","./src/ContactForm.tsx","./src/Faq.tsx","./src/Staff.tsx","./src/VideoBackground.tsx","./src/main.tsx","./src/storage.ts","./src/types.ts","./src/vite-env.d.ts","./vite.config.ts"],"version":"5.6.3"}`