Overview
The 'once' package enables developers to execute code exactly once based on various triggers such as daily, weekly, monthly, on a new app build, or on a new version release. It simplifies the implementation of one-time actions like showing welcome screens, collecting user feedback, or initializing data after updates. Built with simplicity and reliability in mind, it works seamlessly across Android and iOS platforms. The package is ideal for managing periodic or event-based one-time logic without manual state tracking.
Use cases
- Show onboarding screens once per app version
- Trigger analytics collection on first launch
- Display update changelogs only on new version
- Run initialization tasks after app rebuild
- Schedule one-time notifications
- Execute setup routines on first app open
Key features
- Supports multiple trigger types (daily, weekly, monthly, etc.)
- Automatic persistence across app restarts
- No need for manual state management
- Lightweight and easy to integrate
- Works on both Android and iOS
- Handles version and build number detection
Suitable for
- App onboarding flows
- User engagement features
- Analytics and feedback collection
- Post-update setup tasks
- Simple scheduled one-time actions
Considerations
- Does not support custom time intervals beyond predefined options
- Relies on device's system clock for timing
- May require handling edge cases around time zone changes
- Limited to one-time execution per trigger type
- Not suitable for recurring tasks