Flutter Card Stack

A beautiful, customizable card stack widget for Flutter. Create swipeable card stacks with images, titles, and optional action buttons.

Features

Swipeable card stack with smooth animations
Customizable card images (supports both network and asset images)
Card titles with overlay text
Optional action buttons per card
Tap callbacks for cards and buttons
Configurable card height and widget height
Customizable padding and vertical inset

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_card_stack: ^1.0.0

Then run:

flutter pub get

Usage

import 'package:flutter_card_stack/flutter_card_stack.dart';

// Basic usage
FlutterCardStack(
  currentPage,
  images: [
    'assets/images/image_01.png',
    'assets/images/image_02.jpg',
    'https://example.com/image.jpg',
  ],
  title: [
    'Card One',
    'Card Two',
    'Card Three',
  ],
)

// With optional parameters
FlutterCardStack(
  currentPage,
  images: imagesList,
  title: titlesList,
  buttonText: ['Learn More', 'View Details', null],
  onCardTap: [
    () => print('Card 1 tapped'),
    () => print('Card 2 tapped'),
    null,
  ],
  onButtonTap: [
    () => print('Button 1 tapped'),
    () => print('Button 2 tapped'),
    null,
  ],
  cardHeight: 400.0,
  widgetHeight: 500.0,
  padding: 20.0,
  verticalInset: 20.0,
)

Parameters

Parameter	Type	Required	Description
`currentPage`	`double`	Yes	Current page index for the card stack
`images`	`List<String>`	Yes	List of image paths (asset or network URLs)
`title`	`List<String>`	Yes	List of titles for each card
`buttonText`	`List<String?>?`	No	Optional button text for each card
`onCardTap`	`List<VoidCallback?>?`	No	Tap callbacks for each card
`onButtonTap`	`List<VoidCallback?>?`	No	Tap callbacks for each button
`cardHeight`	`double?`	No	Custom card height
`widgetHeight`	`double?`	No	Custom widget height
`padding`	`double`	No	Padding around cards (default: 20.0)
`verticalInset`	`double`	No	Vertical inset for stacked cards (default: 20.0)

Example

Check out the example folder for a complete working example.

Issues and Feedback

Please file issues and feedback on the GitHub repository.

License

MIT License - see the LICENSE file for details.

Author

DivyanshVish