Skip to content
pubscout

check_app_version

3.1.1, released 2 weeks ago by vdes.it

Check app version against app stores or remote JSON and display update dialogs.

WASM-ready
$ flutter pub add check_app_version
Source repository

What it does

Checks the currently installed app version against the Apple App Store, Google Play Store, or a custom remote JSON config. Provides built-in presentation layers like Material/Cupertino dialogs, bottom sheets, full-screen pages, and an UpdateGate widget to handle force updates and smart snooze.

AI-written summary of version 3.1.1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to enforce minimum app versions or prompt users for soft updates.
  • You want to query App Store and Google Play directly without setting up a backend.
  • You want a declarative widget wrapper to check updates automatically on startup and resume.

Skip it when

  • Your app is deployed exclusively via enterprise or private distribution channels that lack store lookups or custom JSON configuration.
  • You want completely custom state management for update flows rather than the library's built-in dialogs and logic.

Strengths

  • Zero-backend store lookup directly from Apple App Store and Google Play Store.
  • Supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux.
  • Includes declarative UpdateGate widget with lifecycle check-on-resume support.
  • Smart snooze and skip-version logic to reduce update fatigue.

Weaknesses

  • Relies on scraping store pages or third-party store metadata which can occasionally break if stores change their layout.
  • Limited to update checking and built-in UI prompts.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
2

Not documented

Future<void> checkForUpdates(BuildContext context) async {
  final decision = await CheckAppVersion.get('https://example.com/version.json');
  if (decision.shouldUpdate && context.mounted) {
    CheckAppVersion.showUpdateDialog(context, decision: decision, onOpenStore: () {});
  }
}

Alternatives

Packages that do the same job and could replace check_app_version.

Works with

Packages commonly used together with check_app_version: ones it builds on, ones built on it, and its own family.