---
title: "Install guide (web)"
description: "One widget that shows people how to install your Flutter web app where it is needed: iPhone Safari, Android, and in-app browsers like Instagram."
product: push
language: en
url: https://abrova.ir/en/docs/push/install-guide
updated: 2026-11-15
---

# Install guide (web)

One widget that shows people how to install your Flutter web app where it is needed: iPhone Safari, Android, and in-app browsers like Instagram.

> **Notifications need the installed app**
>
> On iPhone, Web Push works only in an app added to the Home Screen. `abrova_web` shows the right steps for wherever your app is opened, and nothing once it is installed.

## Step 1: Add the package

```yaml
dependencies:
  abrova_web:
    hosted: https://center.abrova.ir/api/packages/abrova/pub
    version: ^0.1.0
```

## Step 2: Show the guide

```dart
import 'package:abrova_web/abrova_web.dart';

AbrovaInstallGuide(appName: 'Lino', icon: Image.asset('assets/icon.png'))
```

| Where the app is open | What people see |
| --- | --- |
| `iPhone or iPad, Safari` | Share › Add to Home Screen › open from the icon, with look-alikes of the iPhone controls |
| `Android browser` | An Install button (the browser’s install prompt), or the menu steps |
| `Inside Instagram, Facebook or another app` | Open it in the browser, with Copy link |
| `Installed, on a computer, or a native build` | Nothing |

| Option | Default | What it does |
| --- | --- | --- |
| `appName` | required | Your app’s name, as on its icon |
| `icon` | a generic icon | Your app’s icon in the header |
| `accentColor` | the theme’s primary colour | The header’s colour |
| `strings` | Persian for fa, else English | Your own texts |
| `dismissDays` | 7 | How long “Not now” hides it |

## Step 3: Where the app runs

```dart
final where = AbrovaWeb.context;
where.installed;     // opened from the Home Screen
where.installNeed;   // none, iosAddToHomeScreen, androidInstall, openInBrowser
where.inAppBrowser;  // 'Instagram', … or null
```

Use it with [Web Push](https://abrova.ir/docs/push/flutter#web-push): ask for notifications once `where.installed` is true. For new versions of the app, see [New versions (web)](https://abrova.ir/docs/push/web-updates).