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

# Introduction

> Push notifications for iOS apps, with the strategy written by AI and every send made by rules you can read.

PushNotifAI runs your app's push notifications. Your app streams its analytics
events to us. An AI reads how your users behave and proposes which
notifications to send, when, and to whom. You approve or reject each proposal.
A deterministic engine then makes every send over our own APNs connection.

> [!NOTE]
>
> **The AI writes the strategy. It never decides an individual send.** Every
> push traces back to a rule you approved and can read, so "why did this user get
> this notification?" always has an exact answer.

## What you get

> [card] [Proposals with a reason](https://docs.pushnotif.ai/strategy/composer.md)
>
> Each suggested change comes with the diagnosis behind it: "61% of users
> never add a second connection, so nudge them after 48 hours."

> [card] [Flows you can read](https://docs.pushnotif.ai/strategy/flows.md)
>
> A flow is a plain rule over one user's events: "did X, then didn't do Y for
> two days, so send this."

> [card] [Real delivery numbers](https://docs.pushnotif.ai/sdk/delivery-telemetry.md)
>
> APNs only confirms it accepted a push. Our extension reports when it
> actually reached the device, then whether it was opened or dismissed.

> [card] [Honest measurement](https://docs.pushnotif.ai/strategy/holdout.md)
>
> A permanent holdout group gets no notifications, so you can see whether
> your notifications help or hurt retention.

## How the pieces fit

1. **The iOS SDK** sends your events, links devices to your user ids, registers
   push tokens, and reports delivered, opened and dismissed.
2. **The Composer** reads the aggregate behavior and how your current flows
   are doing, and proposes flows to create, adjust, pause or retire.
3. **You review** proposals in the dashboard. Nothing sends until a person
   activates a flow.
4. **The engine** matches events against active flows, applies quiet hours,
   caps and cooldowns, and sends. It records every decision, including the
   ones where it chose not to send, and why.

Ready to integrate? Start with the [quickstart](https://docs.pushnotif.ai/quickstart.md).


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