> ## 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.

# Widgets

> View your budget at a glance from your home screen

## Overview

Kualia offers iOS home screen widgets that let you see key budget information without opening the app.

{/* <img src="/images/widgets-homescreen.png" alt="Widgets on Home Screen" /> */}

## How Widgets Work

Widgets use a dedicated authentication system separate from your main app session. When you set up widgets:

1. The app creates a long-lived widget token
2. The widget uses this token to fetch data via secure HTTP endpoints
3. Data refreshes periodically based on iOS widget refresh schedules

This means widgets work even when you're not actively logged into the app.

## Available Widgets

{/* TODO: Add screenshot for each widget type */}

{/* <img src="/images/widget-medium.png" alt="Medium Widget" /> */}

<Note>Widget details and types are being expanded. Check back for updates on available widget configurations.</Note>

## Setting Up Widgets

<Steps>
  <Step title="Long-press your home screen">Enter edit mode on your iPhone home screen.</Step>
  <Step title="Tap the + button">Search for "Kualia" in the widget gallery.</Step>
  <Step title="Choose a widget">Select the widget size and type you want.</Step>
  <Step title="Add to home screen">Place the widget where you'd like it.</Step>
</Steps>

## Security

Widget tokens can be revoked from within the app if needed. Revoking tokens will stop all widgets from displaying data until new tokens are generated.