Overview
A lightweight Flutter package that simplifies checking whether an app is running for the first time. It provides a straightforward API to detect first-run scenarios and execute custom logic accordingly, such as showing onboarding screens or initializing default settings. Designed for ease of use across all major platforms, it integrates seamlessly into existing workflows without adding overhead. Ideal for developers seeking minimal, reliable first-run detection in their applications.
Use cases
- App onboarding flows
- Initial setup configurations
- First-time user welcome messages
- Resetting default preferences
- Tracking first launch events
- Custom first-run actions
Key features
- Simple API for first-run detection
- Supports all Flutter platforms
- Lightweight and minimal dependencies
- Extensible for custom logic
- Persistent storage using shared_preferences
- Easy integration with flutter pub add
Suitable for
- New Flutter projects
- Onboarding implementations
- Apps needing first-launch logic
- Developers prioritizing simplicity
- Cross-platform apps
- Minimalist utility needs
Considerations
- Relies on shared_preferences for persistence
- Does not handle multiple app reinstalls differently
- No built-in UI components
- Limited to first-run detection only
- Requires manual handling of edge cases
- Not suitable for complex state management