Package selection guidance compiled from public package information, community data, and project usage.
A Flutter package that enables Tinder-style card swiping with support for left, right, up, and down gestures. Developers can define custom logic for each swipe direction, making it ideal for applications like dating apps, product showcases, or content discovery interfaces. The package is cross-platform, working seamlessly on Android, iOS, Web, macOS, Windows, and Linux. It provides a smooth and customizable swipe experience with built-in animation and gesture handling.
Use cases
Dating app interfaces
Product or item discovery
Content recommendation systems
Interactive storytelling
User preference collection
Key features
Tinder-like swipe gestures
Customizable swipe logic per direction
Cross-platform compatibility
Built-in animations
Gesture recognition
Extensible widget design
Suitable for
Developers building swipe-based UIs
Apps requiring user interaction through card swipes
Projects needing intuitive navigation patterns
Prototyping interactive card experiences
Considerations
Requires careful handling of swipe state management
May need additional styling for complex layouts
Performance impact with large datasets
Limited to card-based interactions only
Not optimized for vertical scrolling lists
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
flutter_card_swiper
This is a Flutter package for a Tinder-like card swiper. ✨
It allows you to swipe left, right, up, and down and define your own business logic for each direction.
Very smooth animations supporting Android, iOS, Web & Desktop.
Why?
We built this package because we wanted to:
Have a fully customizable slider
Swipe in any direction
Undo swipes as many times as you want
Choose your own settings such as duration, angle, padding and more
Trigger swipes in any direction with the controller
Add callbacks while swiping, on end, or when the swiper is disabled
Detect the direction (left, right, top, bottom) the card was swiped
Show Cases
Swipe in any direction
Trigger swipes
Unswipe the cards
Fully customizable
Installation
Add this to your package's pubspec.yaml file:
card_swiper:...
OR run
flutterpubaddflutter_card_swiper
in your project's root directory.
Usage
You can place your CardSwiper inside of a Scaffold like we did here. Optional parameters can be defined to enable different features. See the following example:
Index of the first card when the swiper is initialized
false
isDisabled
false
Set to true if swiping should be disabled, has no impact when triggered from the outside
false
isLoop
true
Set to true if the stack should loop
false
maxAngle
30
Maximum angle that the card can reach during swiping
false
allowedSwipeDirection
AllowedSwipeDirection.all
Sets the direction in which the card can be swiped. It can be set to any combination of left, right up or down.
false
numberOfCardsDisplayed
2
Number of cards displayed at the same time
false
onEnd
-
Callback when there are no more cards left to swipe
false
onSwipe
-
Callback when the user swipes a card. If the function returns false, the swipe action is canceled. If it returns true, the swipe action is performed as expected
false
onTapDisabled
-
Callback when a card is tapped and isDisabled is true
false
onUndo
-
Callback when the controller calls undo. If the function returns false, the undo action is canceled. If it returns true, the undo action is performed as expected
A callback containing the horizontal and vertical swipe direction
false
showBackCardOnUndo
-
If true, the previous card will be shown in the background when swiping, and the swipe action will trigger an undo
false
undoSwipeThreshold
50
The horizontal swipe distance threshold, in pixels, after which the back card switches to the previous card. Only active when showBackCardOnUndo is true
false
undoDirection
UndoDirection.left
The direction of the swipe to trigger an undo
false
Controller
The Controller is used to swipe the card from outside of the widget. You can create a controller called CardSwiperController and save the instance for further usage. Please have a closer look at our Example for the usage.