🎯 ShowTime #

Touch indicator overlay for Flutter widgets — useful for demos, screen recordings, and tutorials.

Inspired by KaneCheshire/ShowTime, but works purely at the widget level for Flutter apps.

✨ Features #

• Visualizes all user touch interactions as fading dots.
• Customize pointer color, opacity, radius, and fade duration.
• Plug-and-play: wrap any widget, no app-wide setup required.
• Ideal for:
  • Live presentations
  • User testing
  • Video recordings

🚫 Caveats #

• The overlay is rendered within the widget tree — it won’t appear above system-level UI, like:
  • Permission dialogs
  • Native alerts
  • Toasts or overlays outside your widget context

🚀 Getting Started #

1. Add dependency #

dependencies:
  showtime: ^0.0.5

...or just copy the showtime.dart file somewhere into your project!

2. Wrap your widget #

import 'package:showtime/showtime.dart';

ShowTime(
  child: YourWidget(),
)

// e.g.
void main() => runApp(const ShowTime(child: MyApp()));

🔧 Configuration #

You can pass extra parameters to further configure the pointer appearance.

🧪 Testing #

Use flutter_test and simulate gestures to validate behavior. See showtime_test.dart for example tests.

💡 Inspiration #

This package is based on the iOS library ShowTime by Kane Cheshire. Unlike the original, this version focuses on widget-level rendering only, making it lightweight and flexible — but not global or system-level.