swipe_reveal_card 0.2.0

A lightweight Flutter card widget with horizontal swipe-to-reveal actions. Simple API, Material ink ripples, and scroll-position persistence.

swipe_reveal_card

A lightweight Flutter card with horizontal swipe-to-reveal actions.

Swipe left on a card to uncover Edit / Archive / Delete-style actions — with a small, typed API and no heavy gesture controllers.

Features

• Swipe left to reveal one or more actions
• SwipeRevealController for programmatic open / close / toggle
• SwipeRevealGroup so only one card is open in a list
• Auto-close after an action tap (closeOnAction)
• Close when tapping the card body while open (closeOnCardTap)
• Disable swipe with enabled: false
• Custom action widgets via SwipeAction.child
• Optional icons and custom action colors
• Material ink ripples on card and action taps
• Soft elevation with zero-margin “flush” mode
• Zero third-party dependencies beyond Flutter

Install

dependencies:
  swipe_reveal_card: ^0.2.0

import 'package:swipe_reveal_card/swipe_reveal_card.dart';

Usage

final group = SwipeRevealGroup();

SwipeRevealCard(
  group: group,
  closeOnAction: true,
  onTap: () => debugPrint('opened'),
  actions: [
    SwipeAction(
      label: 'Edit',
      icon: Icons.edit_outlined,
      onPressed: () {},
    ),
    SwipeAction(
      label: 'Delete',
      icon: Icons.delete_outline,
      color: Colors.red,
      onPressed: () {},
    ),
  ],
  child: const ListTile(
    title: Text('Ship checklist'),
    subtitle: Text('Docs, tests, and pub.dev dry-run'),
  ),
)

Controller

final controller = SwipeRevealController();

SwipeRevealCard(
  controller: controller,
  actions: [SwipeAction(label: 'Edit', onPressed: () {})],
  child: const ListTile(title: Text('Item')),
);

controller.open();
controller.close();
controller.toggle();

Plain card (no swipe)

Omit actions (or pass null) for a simple elevated card:

SwipeRevealCard(
  onTap: () {},
  child: const ListTile(title: Text('Hello')),
)

Customization

Parameter	Description
actions	List of SwipeActions revealed on swipe
controller	Programmatic open / close
group	Keep only one card open among peers
enabled	Disable swipe when false
closeOnAction	Close after an action tap (default true)
closeOnCardTap	Close when tapping an open card (default true)
onOpen / onClose	Open / close callbacks
backgroundColor	Card body color (default white)
actionsBackgroundColor	Color behind action buttons
borderRadius	Corner radius (default 10)
margin	Outer margin; EdgeInsets.zero disables shadow
elevation	Shadow depth when margin is non-zero
storageKey	Restores horizontal scroll offset
onTap	Card body tap callback

Screenshots

Resting	Actions revealed

Testing

Unit tests live under test/. Behavior is also specified with Gherkin (.feature) files under test/bdd/ using bdd_widget_test.

# After editing .feature files, regenerate and commit the Dart tests
dart run build_runner build
dart format .

# Run all tests (unit + BDD)
flutter test

Generated BDD tests under test/bdd/ are committed — CI does not regenerate them.

Example

cd example
flutter run

Compared to flutter_slidable

swipe_reveal_card is intentionally smaller: horizontal scroll-to-reveal actions on a card surface. If you need dismissible panes, start/end action regions, or custom motion types, prefer flutter_slidable.

License

MIT