restart_app

restart_app gives Flutter apps a single Dart API for restarting or relaunching across Android, iOS, web, macOS, Linux, and Windows. Each platform uses the safest restart path available to Flutter apps. The package returns a structured RestartResult so you can handle unsupported modes, denied permissions, or platform limits without guessing.

import 'package:restart_app/restart_app.dart';

final result = await Restart.restartApp();

if (!result.success) {
  // Show or log result.code and result.message.
}

What it handles

Android activity relaunch, including Android TV and Fire TV launcher fallback.
iOS Flutter engine restart when the host app registers plugins for a new engine.
Optional iOS notification fallback when a user-tap relaunch is acceptable.
Web page reload through window.location.
macOS and Windows process relaunch where app packaging permits it.
Linux execv process replacement.

Requirements

Dart SDK >=3.4.0
Flutter >=3.22.0

Next steps

Start with the quickstart.
Check platform behavior before shipping a restart flow.
Configure iOS engine restart when your app targets iOS.

Start

Product

Reference

What it handles

Requirements

Next steps

​What it handles

​Requirements

​Next steps

What it handles

Requirements

Next steps