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

# iOS Home-Screen Widget

> Add the AtllasX widget to keep your hot leads and today's results on your iOS home screen.

The AtllasX home-screen widget puts your hot leads and today's calling results on your iOS home and lock screens, so you can see what's waiting without opening the app. Tapping the widget deep-links straight into your **Follow-ups** so you can act on the hottest lead in one move.

The widget is part of AtllasX, the mobile surface of AI Calling. It is available on iOS only and is fed by the app while you're signed in.

## What the Widget Shows

The widget reflects a snapshot the app saves each time it refreshes your data: today's results from your **Home** screen and your hottest waiting lead from **Follow-ups**. The figures it shows are:

| Field                | Meaning                                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Hot** (ring count) | The number of leads currently waiting for follow-up                                                                    |
| **Calls**            | Calls placed today                                                                                                     |
| **Answered**         | Calls answered today                                                                                                   |
| **Hot** (Today stat) | Hot leads from today's calls                                                                                           |
| **Hottest lead**     | The single top lead from your follow-up feed — name, initials, and a short detail (such as a booking time or headline) |
| **As of**            | The time the snapshot was last updated (medium widget only)                                                            |

## Widget Sizes

The widget supports two home-screen sizes and two lock-screen styles. All of them tap through to your follow-ups.

| Size                       | What it displays                                                                                                                                                                                         |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Small**                  | A ring with your waiting hot-lead count and **hot 🔥** label, plus a `calls · answered` line for today                                                                                                   |
| **Medium**                 | A **Today** panel with **calls**, **answered**, and **hot** stat pills and an *as of* timestamp, alongside a **HOTTEST LEAD** card showing the lead's avatar, name, detail, and a **Follow up →** button |
| **Lock screen (circular)** | A compact count with a **hot** label                                                                                                                                                                     |
| **Lock screen (inline)**   | A single line such as **🔥 5 hot leads**, or **🔥 5 hot · Jamie Diaz** when a top lead is known                                                                                                          |

<Note>
  When you have no waiting leads yet, the medium widget shows a **Hot leads land here** placeholder instead of a lead card. Once leads come in, the hottest one appears automatically.
</Note>

## Tapping the Widget

The widget is a shortcut into the app:

* Tapping the **small**, **circular**, or **inline** widget opens your **Follow-ups**.
* On the **medium** widget, tapping the **HOTTEST LEAD** card (or the **Follow up →** button) opens **Follow-ups**; tapping the empty placeholder opens your **Home** screen.

## How the Data Stays Current

You don't refresh the widget manually. The app writes a fresh snapshot whenever it loads new data:

1. Your today's results update when the **Home** screen refreshes its stats.
2. Your hottest lead updates when the **Follow-ups** feed reloads (hottest first).

The widget re-renders on iOS roughly every 30 minutes on its own, and the app forces an immediate refresh whenever it loads new data. Open the app periodically to keep the numbers fresh.

<Note>
  When you sign out or switch accounts, the widget is cleared so the next person on the device never sees the previous user's leads or stats.
</Note>

## Adding the Widget

The widget installs the same way as any iOS widget:

<Steps>
  <Step title="Long-press the home screen">
    Press and hold an empty area of your iOS home screen until the apps jiggle.
  </Step>

  <Step title="Tap the + button">
    Tap the **+** in the top corner to open the widget gallery.
  </Step>

  <Step title="Search for AtllasX">
    Search for **AtllasX**, choose the **Hot leads** widget, pick the size you want, and add it to your home screen.
  </Step>
</Steps>

<Tip>
  To add a lock-screen version, long-press your lock screen, tap **Customize**, and add the **Hot leads** widget to the lock-screen widget area.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Follow-ups" icon="fire" href="/docs/ai-calling/mobile-app/follow-ups">
    Work the leads the widget surfaces, hottest first.
  </Card>

  <Card title="Insights" icon="chart-bar" href="/docs/ai-calling/mobile-app/insights">
    See your calling results and trends in the app.
  </Card>
</CardGroup>