SmartSnack 🍿 #

Author: Salauddin Majumder • [email protected] • Portfolio • GitHub

A beautiful, feature-rich and Highly Customizable Dynamic Island-style notification system for Flutter.

Inspired by iOS Dynamic Island • Premium Animations • Highly Customizable

✨ Features #

🎨 Beautiful Design

• iOS Dynamic Island inspired aesthetics
• Premium color palette with semantic colors
• Glass morphism & gradient effects
• Smooth spring-based animations

⚡ Smart Queue System

• Intelligent notification queuing
• Priority-based display (normal, high, urgent)
• Loading → Success/Error transitions
• Update notifications in real-time

🎯 Multiple Preset Styles

• Success, Error, Warning, Info
• Loading with animated gradient border
• Glass morphism with blur
• Custom gradient backgrounds
• Minimal style

🖼️ Screenshots #

Add screenshot images to the screenshots/ folder and reference them in pubspec.yaml under the screenshots section. Recommended image specs:

• Format: png or jpg
• Recommended size: 1280×720 (landscape) or 720×1280 (portrait)
• Keep file sizes under 500 KB for faster uploads

Example pubspec.yaml snippet:

# screenshots:
#   - description: 'SmartSnack success notification (top)'
#     path: screenshots/success.png
#   - description: 'SmartSnack loading state (animated)'
#     path: screenshots/loading.png

Steps to add screenshots:

1. Create high-quality images and save them into the screenshots/ folder.
2. Uncomment and update the screenshots: section in pubspec.yaml with correct paths.
3. Run flutter pub publish --dry-run to validate before publishing.
4. When ready, run flutter pub publish to publish the new version.

If you prefer not to upload images during the first publish, keep the screenshots section commented — you can add screenshots in a later release.

🛠️ Highly Customizable

• Custom icons, colors, and typography
• Action buttons with callbacks
• Progress indicators
• Subtitles and body widgets
• Position (top/bottom)

📳 Interactive

• Swipe-to-dismiss gestures
• Haptic feedback support
• Tap callbacks
• Configurable dismiss directions

📦 Installation #

Add to your pubspec.yaml:

dependencies:
  smart_snack: ^1.0.0

Then run:

flutter pub get

🚀 Quick Start #

Basic Usage #

import 'package:smart_snack/smart_snack.dart';

// Success notification
SmartSnack.success(context, title: 'Payment successful!');

// Error notification
SmartSnack.error(context, title: 'Connection failed');

// Warning notification
SmartSnack.warning(context, title: 'Low battery');

// Info notification
SmartSnack.info(context, title: 'New update available');

Loading State #

// Show loading
SmartSnack.loading(context, title: 'Processing...');

// Do your async work
await someAsyncOperation();

// Then show result
SmartSnack.success(context, title: 'Complete!');
// or
SmartSnack.error(context, title: 'Failed');

With Subtitles #

SmartSnack.success(
  context,
  title: 'Payment Received',
  subtitle: '\$50.00 from John',
);

🎨 Styles #

Glass Morphism #

SmartSnack.glass(
  context,
  title: 'AirDrop Received',
  subtitle: 'Photo from nearby iPhone',
);

Gradient Background #

SmartSnack.gradient(
  context,
  title: 'Premium Unlocked! ✨',
  gradientColors: [Color(0xFF8B5CF6), Color(0xFFEC4899)],
);

Progress Indicator #

SmartSnack.progress(
  context,
  title: 'Uploading...',
  progress: 0.65,
  showProgressText: true,
);

🔧 Advanced Usage #

Action Buttons #

SmartSnack.info(
  context,
  title: 'File deleted',
  actions: [
    SmartSnackAction(
      label: 'Undo',
      onPressed: () => restoreFile(),
    ),
  ],
);

Custom Notification #

SmartSnack.show(
  context,
  title: 'Now Playing',
  style: SmartSnackStyle.custom,
  leading: ClipRRect(
    borderRadius: BorderRadius.circular(6),
    child: Image.network(albumArt, width: 36, height: 36),
  ),
  bodyWidget: Column(
    crossAxisAlignment: CrossAxisAlignment.start,
    mainAxisAlignment: MainAxisAlignment.center,
    children: [
      Text('Song Title', style: TextStyle(color: Colors.white)),
      Text('Artist Name', style: TextStyle(color: Colors.white54)),
    ],
  ),
  trailing: Icon(Icons.music_note, color: Colors.white54),
);

Priority Queue #

// Normal priority (queued)
SmartSnack.info(context, title: 'Normal notification');

// Urgent priority (shows immediately)
SmartSnack.show(
  context,
  title: 'URGENT: Action required!',
  style: SmartSnackStyle.warning,
  priority: SmartSnackPriority.urgent,
);

Bottom Position #

SmartSnack.success(
  context,
  title: 'Saved to favorites',
  position: SmartSnackPosition.bottom,
);

Update Existing Notification #

// Show with ID
SmartSnack.loading(
  context,
  id: 'download',
  title: 'Downloading...',
);

// Update progress
SmartSnack.progress(
  context,
  id: 'download',
  title: 'Downloading...',
  progress: 0.5,
);

📖 API Reference #

SmartSnack Static Methods #

SmartSnackStyle #

SmartSnackPosition #

SmartSnackPriority #

SmartSnackHaptic #

🎨 Customization #

Custom Colors #

SmartSnack.show(
  context,
  title: 'Custom styled',
  style: SmartSnackStyle.custom,
  backgroundColor: Colors.indigo,
  accentColor: Colors.amber,
  borderColor: Colors.amber.withOpacity(0.3),
);

Custom Typography #

SmartSnack.success(
  context,
  title: 'Styled text',
  titleTextStyle: TextStyle(
    fontSize: 16,
    fontWeight: FontWeight.bold,
    color: Colors.white,
  ),
);

Available Components #

The package also exports reusable widgets:

import 'package:smart_snack/smart_snack.dart';

// Animated checkmark
AnimatedCheckmark(color: Colors.green, size: 24)

// Animated X mark
AnimatedXMark(color: Colors.red, size: 24)

// Gradient progress bar
GradientProgressBar(progress: 0.7)

// Circular progress indicator
GradientCircularProgress(indeterminate: true)

// Status avatar with indicator
StatusAvatar(
  image: NetworkImage(url),
  showStatus: true,
  statusColor: Colors.green,
)

🤝 Contributing #

Contributions are welcome! Please read our contributing guidelines before submitting a PR.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing)
5. Open a Pull Request

🙏 Acknowledgments #

• Inspired by Apple's Dynamic Island
• Built with ❤️ for the Flutter community

If you like this package, please ⭐ the repo!