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

# Widgets

> Add Peanuts Helpers to your phone home screen for quick access

## What are Widgets?

Widgets let you add mini versions of your Peanuts Helpers directly to your phone's home screen. See key data and add entries without opening the app.

<Info>
  Widgets require the Peanuts PWA to be installed on your device.
</Info>

## Available Widget Types

<CardGroup cols={2}>
  <Card title="Summary Widget" icon="chart-simple">
    Shows key metrics from your Helper (totals, averages, streaks)
  </Card>

  <Card title="Quick Add Widget" icon="plus">
    One-tap button to add a new entry to a specific Helper
  </Card>

  <Card title="Recent Entries" icon="clock">
    Shows your latest entries from a Helper
  </Card>

  <Card title="Streak Widget" icon="fire">
    Displays your current streak for Habit Helpers
  </Card>
</CardGroup>

## Adding Widgets

### iOS

1. Long-press on your home screen
2. Tap the **+** button in the top corner
3. Search for "Peanuts"
4. Choose a widget size
5. Tap **Add Widget**
6. Configure which Helper to display

### Android

1. Long-press on your home screen
2. Tap **Widgets**
3. Find "Peanuts" in the list
4. Drag a widget to your home screen
5. Select the Helper to display

<Warning>
  Widget support depends on your device and browser. PWA widgets work best on newer iOS and Android versions.
</Warning>

## Widget Configuration

After adding a widget, you can configure:

* **Which Helper** to display
* **What data** to show (for summary widgets)
* **Quick action** to perform on tap
* **Refresh frequency**

## Use Cases

### Expense Tracking

Add a summary widget showing:

* This month's spending total
* Budget remaining
* Quick add button for new expenses

### Habit Tracking

Add a streak widget showing:

* Current streak count
* One-tap to mark complete
* Completion rate

### Quick Logging

Add quick-add widgets for frequently used Helpers:

* Log meals without opening app
* Track symptoms with one tap
* Add tasks instantly

## Limitations

* Widgets require PWA installation
* Data updates every 15-30 minutes (not real-time)
* Some widget types not available on all devices
* Limited customization options

## Related Features

<CardGroup cols={2}>
  <Card title="Install PWA" icon="download" href="/getting-started/pwa-installation">
    Install Peanuts as an app for widget support
  </Card>

  <Card title="Widget Sharing" icon="share" href="/features/widget-sharing">
    Share widgets and embeds with others
  </Card>
</CardGroup>