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

# React Native Swipe Deck

Tinder-style swipe decks for React Native

> High-performance card stacks powered by Reanimated, Worklets, and Gesture Handler

[Quick Start](/guide/getting-started/quick-start.html) | [GitHub](https://github.com/react-native-motion-kit/react-native-swipe-deck)

## Features

- 🤌 **Gesture-First Deck UX**: Drag, flick, threshold, and direction controls tuned for Tinder-style card stacks.
- 🏎️ **High-Performance Animations**: Smooth card motion powered by React Native Reanimated shared values and worklets.
- 🪟 **Bounded Render Window**: Mount only the active card and a small forward stack instead of the whole data set.
- 🧬 **Item-Stable Promotion**: Stable item keys let promoted cards keep their React Native view identity.
- 🧠 **Typed Compound API**: Create one typed deck family with Root, Card, hooks, actions, and events.
- 🎛️ **External Control API**: Trigger swipeLeft, swipeRight, swipeUp, and undo from buttons or other UI components.
- 🎨 **Motion Recipes**: Tune gesture motion, programmatic actions, and undo restores independently.
- 🧩 **Multi-Instance Management**: Manage multiple deck roots independently with stable factory-scoped IDs.
- ↩️ **Undo Support**: Opt into back-swipe UX with action-safe undo motion and LIFO history.
- 🪄 **Easy-to-Use API**: Start with Root and Card, then add hooks only when controls or events need them.