Overview
The is_first_run package provides a straightforward way to determine whether an application is being launched for the first time on a device. It uses shared preferences to store a flag indicating the app's run status, ensuring reliable detection across sessions. Ideal for initializing setup flows, displaying onboarding screens, or triggering first-time user actions. The package is lightweight and compatible with all major Flutter platforms, including mobile, web, and desktop. It requires no complex configuration and integrates seamlessly into existing projects.
Use cases
- Onboarding screen display
- First-time user setup
- Initial data initialization
- Welcome message delivery
- Feature toggle activation
Key features
- Simple API
- Persistent state storage
- Cross-platform support
- No external dependencies
- Easy integration
Suitable for
- New app launches
- User onboarding flows
- Initial configuration tasks
- Lightweight state tracking
- Apps needing first-run logic
Considerations
- Relies on shared preferences
- Does not reset automatically
- May require manual clearing
- Limited to first-run detection
- No built-in analytics