📱 GestureOnboardingOverlay Demo

Test 3-step tutorial overlay pro nové mobilní uživatele s auto-dismiss funkcionalitou.

Status
Overlay viditelný:
Ne (skrytý)
Počet zrušení:
0
Ovládání
✨ Features

3-Step Tutorial

Swipe gestures, Settings, View switching

Auto-Dismiss After 10 Seconds

Automatické zavření po 10 sekundách

Manual Dismiss

Tlačítko "Rozumím" pro ruční zavření

Step Navigation

Navigace mezi kroky s progress indikátorem

Framer Motion Animations

Respektuje prefers-reduced-motion nastavení

Keyboard Support

Escape klávesa zavírá overlay

Screen Reader Support

Full ARIA labels a accessibility attributes

📖 Props API

onDismiss: () => void

Callback při zavření tutoriálu (uživatel kliká na "Rozumím", Escape, nebo auto-dismiss po 10s)

💡 Příklad použití
import { GestureOnboardingOverlay } from '@/components/editor/mobile/GestureOnboardingOverlay';
import { useEditorStore } from '@/lib/stores/editor-store';

export function EditorPage() {
  const hasSeenOnboarding = useEditorStore(
    (state) => state.hasSeenMobileOnboarding
  );

  return (
    <>
      {/* Overlay se zobrazuje pouze pokud uživatel NEVIDĚL */}
      {!hasSeenOnboarding && (
        <GestureOnboardingOverlay
          onDismiss={() => console.log('Tutorial completed')}
        />
      )}

      {/* Zbytek stránky */}
      <EditorContent />
    </>
  );
}
🔄 User Flow

Když se nový uživatel poprvé dostane na editor:

  1. Overlay se automaticky zobrazí po 300ms (smooth appearance)
  2. Uživatel vidí krok 1: "Posuňte dny" s animací swipe gesta
  3. Může navigovat mezi kroky (tlačítka Zpět/Dále)
  4. Klikaní na progress dots skočí na konkrétní krok
  5. Na posledním kroku se tlačítko změní na "Rozumím"
  6. Pokud se nic nestane, auto-dismiss po 10 sekundách
  7. Stav se uloží (hasSeenMobileOnboarding) - overlay se už neukáže
✅ Checklist testů