# React Native Swipe Deck

> High-performance Tinder-style swipe deck documentation for React Native apps.

## 가이드

- [개요](/ko/guide/getting-started/overview.md): @react-native-motion-kit/swipe-deck는 React Native용 고성능 Tinder 스타일 swipe deck 라이브러리입니다. 부드러운 card stack, like/pass 버튼, progress 기반 overlay, type-safe compound API가 필요한 앱에 맞춰져 있습니다.
- [설치](/ko/guide/getting-started/installation.md): 패키지와 React Native gesture/animation peer dependency를 설치합니다. Yarn을 사용한다면:
- [빠른 시작](/ko/guide/getting-started/quick-start.md): Item type에 맞는 typed deck family를 하나 만드세요. 같은 factory의 Root, Card, hook, action, event가 같은 registry namespace를 공유합니다.
- [AI 사용 가이드](/ko/guide/getting-started/ai.md): AI assistant에게 코드를 생성하게 할 때 아래 규칙을 함께 전달하세요. 가장 흔한 integration 실수를 줄일 수 있습니다.
- [기본 사용법](/ko/guide/usage/basic-usage.md): Factory API, Card render info, allowedDirections, static SwipeDeck API를 언제 쓰는지 정리합니다.
- [Deck Hooks](/ko/guide/usage/deck-hooks.md): Factory hook은 Provider prop이나 controller object 없이 deck state, action, interaction 값을 제공합니다.
- [Event 처리](/ko/guide/usage/handling-events.md): Event hook은 commit된 model event를 표현합니다. Live interaction value와 분리해서 생각하세요.
- [Programmatic Actions](/ko/guide/usage/programmatic-actions.md): Programmatic action은 useDeckActions()에서 가져옵니다. 버튼, 외부 control, 앱 로직에서 active card를 dismiss할 때 사용하세요.
- [Undo](/ko/guide/usage/undo.md): Undo는 opt-in입니다. 해당 deck에서 undo/back-swipe UX를 제공할 때 Root에 undoEnabled를 추가하세요. 활성화되면 성공한 swipe마다 key/index/direction metadata entry 하나를 LIFO undo stack에 저장합니다. Lookup은 현재 data에 대한 key-to-index map을 사용하고, data나 key가 바뀌면 invalid entry를 prune합니다. 생략하면 성공한 swipe도 undo metadata를 저장하지 않고, canUndo는 false를 유지하며, actions.undo()는 false를 반환합니다.
- [Motion](/ko/guide/usage/motion.md): SwipeDeckMotion.tinder()는 Tinder 스타일 card stack을 위한 기본 motion preset입니다.
- [Multi-Instance Management](/ko/guide/usage/multi-instance-management.md): 같은 factory에서 여러 Root를 렌더링할 때만 id를 사용하세요. id는 item key가 아니라 factory 안에서 deck instance를 구분하는 namespace입니다. 서로 다른 factory는 둘 다 default id를 써도 충돌하지 않지만, 같은 factory와 같은 id의 Root 두 개가 동시에 mount되는 것은 잘못된 사용입니다.
- [Visible Card Budget](/ko/guide/usage/visible-card-budget.md): visibleCardCount는 active card부터 forward 방향으로 mount할 card의 최대 개수를 제어합니다.
- [API 레퍼런스](/ko/guide/usage/api-reference.md): 주요 export, Root와 Card props, hook, event, built-in motion helper를 빠르게 확인합니다.