> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apostra on your phone

> Add the Apostra web app to your iPhone or Android home screen, so it opens full screen like an app.

You can add the Apostra web app to your phone's home screen. It then opens
full screen with the Apostra icon, without the browser's address bar, and works
as it does in the browser: the same account, the same chat, the same pages. There is nothing to download from an app store.

## iPhone

1. Open [app.apostra.com](https://app.apostra.com) in Safari.
2. Tap **Share**, then **Add to Home Screen**.
3. Tap **Add**.

## Android

1. Open [app.apostra.com](https://app.apostra.com) in Chrome and sign in.
2. Tap the menu, then **Add to Home screen** or **Install app**.
3. Tap **Install**.

## Notifications (beta)

Apostra can send notifications to your phone or to a browser. They are in
beta, for accounts in the beta.

### What Apostra notifies you about

Apostra sends a notification only when something needs you to act now. In the
beta, notifications go only to buyer accounts, and each one goes to every phone
or browser where you have turned them on.

Today, one event sends a notification: a live media buy did not take a
property-list change, or its property lists can no longer be enforced, and
Apostra's attempt to pause that buy failed. The buy may still be running
without your property lists applied. The message tells you to pause it now or
contact support.

When Apostra did pause the buy, it sends no notification. That event stays in
your notification inbox in the app and in email, and so does every other event.

* **Same words as the email.** The notification has the same title and message
  as the email for that event.
* **Tapping it opens the chat.** It opens the Apostra chat on the buy's
  campaign.
* **Each device gets one.** If a device is off or offline, its notification
  service keeps the notification for 24 hours, then drops it. The event is still
  in your inbox and email.
* **The lock screen follows your phone.** What shows there depends on your
  phone's own notification preview setting.

### Turn notifications on

On iPhone, notifications work only in the Apostra app on your Home Screen
(iOS 16.4 or later), not in Safari. Add it to your Home Screen first, as
above, and open it from there. On Android and on a computer, they work in the
browser.

1. In the Apostra web app on that device, open your account menu and choose
   **Notification settings**.
2. Turn on **Notifications on this device**.
3. Your phone or browser asks whether Apostra may send you notifications. Tap
   **Allow**.

Turn them on once on each device where you want them. They come to you, the
person signed in, whichever of your accounts they are about. If you share a
device, each person turns them on for themselves.

If the browser says notifications are blocked, allow them for Apostra in your
browser or phone settings, then turn them on again.

Your phone or browser shows the prompt itself, so this step works only in the
Apostra web app on the device. It cannot be done from Claude, ChatGPT or
another app that connects to Apostra.

### Turn notifications off

* On the device: turn off **Notifications on this device** in **Notification
  settings**.
* Signing out of the web app on a device turns its notifications off. If
  the device cannot reach Apostra as you sign out, it still stops receiving
  them, and it may stay on your list of devices until Apostra next tries to
  reach it.
* From anywhere: your agent can list your devices and remove one, with
  `get({"kind":"notification_config"})` and
  `save_notification_config({"removePushDeviceId": "..."})`. See the
  [tool catalog](https://docs.apostra.com/v3/tool-reference.md#push-devices).

You can have up to 10 devices. Turning notifications on for an eleventh turns
them off on the one you have used least recently.

## What it does and does not do

* It is the web app, so anything that changes on the web changes here too.
* On iPhone it keeps its own sign-in, separate from Safari's, so sign in once
  more the first time you open it.
* It does not work offline. Without a connection it shows what your browser
  would.
* To remove it, delete the icon the way you delete any app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.