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

# Notifications

> Stay informed about upcoming bills and budget events

## Overview

Kualia sends push notifications to keep you on top of your finances. Notifications are delivered to your iOS device.

{/* <img src="/images/notifications-ios.png" alt="iOS Notification" /> */}

## Planned Transaction Reminders

When you create a planned transaction, you can enable a reminder with these timing options:

| Reminder Timing | Description                                 |
| --------------- | ------------------------------------------- |
| On due date     | Notified on the day the payment is expected |
| 1 day before    | One day before the due date                 |
| 2 days before   | Two days before the due date                |
| 1 week before   | One week before the due date                |
| 1 month before  | One month before the due date               |

### How Reminders Work

1. Kualia schedules the reminder from the plan's due date
2. A background job checks for due reminders periodically
3. When a reminder is due, a push notification is sent to your iOS device via APNs
4. For recurring plans, the next reminder is scheduled from the next due date

### Configuring Reminders

To set up a reminder:

1. Open a planned transaction or create a new one
2. Select your preferred reminder timing
3. Save

{/* <img src="/images/notifications-config.png" alt="Reminder Configuration" /> */}

## Notification Delivery

Notifications are delivered via Apple Push Notification service (APNs) to your registered iOS devices. Make sure:

* Push notifications are enabled for Kualia in your iOS Settings
* You're signed in to the app on your device

{/* TODO: Document web notification support when available */}