flutter_confetti_engine library

flutter_confetti_engine

A celebration package that combines confetti particle animation, haptic feedback, and optional sound in a single API call.

Quick start:

import 'package:flutter_confetti_engine/flutter_confetti_engine.dart';

// One-liner — full-screen burst with haptics:
ConfettiEngine.celebrate(context);

// With a preset:
ConfettiEngine.celebrate(context, preset: Preset.nova);

// Stock clip for the preset you pass to celebrate():
ConfettiEngine.celebrate(
  context,
  preset: Preset.cascade,
  feedback: CelebrationFeedback.bundledForPreset(Preset.cascade),
);

// Your own asset + toggle haptics/sound:
ConfettiEngine.celebrate(
  context,
  feedback: CelebrationFeedback.customAsset(
    'assets/party.mp3',
    enableHaptics: true,
    enableSound: true,
  ),
);

// Message banner + max duration (overlay closes at 3s or when particles end):
ConfettiEngine.celebrate(
  context,
  overlayMessage: CelebrationMessageOptions.withDefaults(
    'Congratulations! 🎉',
    durationInSeconds: 3,
    alignment: Alignment.center,
    decoration: BoxDecoration(
      color: Color(0x88000000),
      borderRadius: BorderRadius.all(Radius.circular(16)),
    ),
  ),
);

// Manual control:
final controller = ConfettiController();
ConfettiWidget(preset: Preset.flare, controller: controller, autoPlay: false)
controller.play();