> For AI agents: the complete documentation index is available at https://react-native-swipe-deck.pages.dev/ko/llms.txt, the full documentation bundle is available at https://react-native-swipe-deck.pages.dev/ko/llms-full.txt.

# React Native Swipe Deck

React Native용 Tinder 스타일 swipe deck

> Reanimated, Worklets, Gesture Handler 기반의 고성능 card stack

[빠른 시작](/ko/guide/getting-started/quick-start.html) | [GitHub](https://github.com/react-native-motion-kit/react-native-swipe-deck)

## Features

- 🤌 **Gesture 중심 Deck UX**: Tinder 스타일 card stack에 맞춰 drag, flick, threshold, direction control을 조정합니다.
- 🏎️ **고성능 애니메이션**: React Native Reanimated shared value와 worklet 기반으로 부드러운 card motion을 만듭니다.
- 🪟 **Bounded Render Window**: 전체 데이터가 아니라 active card와 작은 forward stack만 mount합니다.
- 🧬 **Item-Stable Promotion**: 안정적인 item key로 promoted card가 React Native view identity를 유지합니다.
- 🧠 **Typed Compound API**: Root, Card, hook, action, event를 하나의 typed deck family로 묶습니다.
- 🎛️ **외부 제어 API**: button이나 다른 UI에서 swipeLeft, swipeRight, swipeUp, undo를 programmatic하게 실행합니다.
- 🎨 **Motion Recipes**: gesture motion, programmatic action, undo restore를 각각 독립적으로 조정합니다.
- 🧩 **Multi-Instance Management**: 안정적인 factory-scoped id로 여러 deck root를 독립적으로 관리합니다.
- ↩️ **Undo Support**: opt-in undo history와 action-safe restore motion으로 back-swipe UX를 만듭니다.
- 🪄 **쉬운 API**: Root와 Card로 시작하고, control이나 event가 필요할 때만 hook을 추가합니다.