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

# Install as App

> Install Peanuts on your device for the best experience

Peanuts works in any browser, but installing it as an app gives you a better experience with faster loading, offline access, and push notifications.

## Why Install?

<CardGroup cols={2}>
  <Card title="Faster Access" icon="rocket">
    Launch from your home screen instantly
  </Card>

  <Card title="Push Notifications" icon="bell">
    Get reminders even when the browser is closed
  </Card>

  <Card title="Offline Mode" icon="wifi-slash">
    View recent entries without internet
  </Card>

  <Card title="Full Screen" icon="expand">
    No browser UI taking up space
  </Card>
</CardGroup>

## Install on iPhone/iPad

<Steps>
  <Step title="Open in Safari">
    Go to peanutsapp.com in Safari (not Chrome or other browsers).
  </Step>

  <Step title="Tap Share Button">
    Tap the share icon at the bottom of the screen (square with arrow).
  </Step>

  <Step title="Add to Home Screen">
    Scroll down and tap "Add to Home Screen."
  </Step>

  <Step title="Name and Add">
    Keep the name "Peanuts" and tap "Add."
  </Step>
</Steps>

<Warning>
  On iOS, you must use Safari. The install option is not available in Chrome, Firefox, or other browsers.
</Warning>

## Install on Android

<Steps>
  <Step title="Open in Chrome">
    Go to peanutsapp.com in Chrome.
  </Step>

  <Step title="Tap Install Banner">
    If prompted, tap "Install" on the banner that appears.
  </Step>

  <Step title="Or Use Menu">
    Tap the three-dot menu and select "Install app" or "Add to Home screen."
  </Step>

  <Step title="Confirm">
    Tap "Install" to add Peanuts to your home screen.
  </Step>
</Steps>

## Install on Desktop

### Chrome / Edge

<Steps>
  <Step title="Look for Install Icon">
    In the address bar, look for the install icon (monitor with arrow).
  </Step>

  <Step title="Click Install">
    Click the icon and confirm installation.
  </Step>

  <Step title="Launch">
    Peanuts opens in its own window. Find it in your applications.
  </Step>
</Steps>

### Other Browsers

Not all desktop browsers support PWA installation. Chrome and Edge work best.

## After Installation

Once installed, Peanuts behaves like a native app:

* **Launch**: Tap the icon on your home screen or in your app list
* **Notifications**: Enable push notifications in Settings for reminders
* **Updates**: The app updates automatically in the background

## Push Notifications

To receive reminders and alerts:

<Steps>
  <Step title="Open Settings">
    Go to Settings in Peanuts.
  </Step>

  <Step title="Find Notifications">
    Scroll to the Notifications section.
  </Step>

  <Step title="Enable Push">
    Toggle on "Push Notifications" and allow when prompted.
  </Step>
</Steps>

<Info>
  Push notifications require the installed app. Browser notifications work but are less reliable.
</Info>

## Offline Capabilities

Peanuts works offline with full support for entry logging:

* **Instant Logs** ⚡ work fully offline (0 credits)
* View recently accessed helpers and entries
* Queue entries for sync when online
* See cached data from your last session

When back online:

* Data syncs automatically
* Pending entries are uploaded
* You'll see a confirmation toast

<Info>
  For detailed offline functionality, see [Offline Mode](/features/offline-mode).
</Info>

## Updating the App

Peanuts updates automatically. When a new version is available:

1. Close the app completely
2. Reopen it
3. The update installs in the background

You don't need to reinstall from the browser.

## Uninstalling

### iOS

Long-press the Peanuts icon and tap "Remove App."

### Android

Long-press the icon and drag to "Uninstall" or go to Settings > Apps > Peanuts > Uninstall.

### Desktop

Right-click the Peanuts icon in your taskbar or dock and select "Uninstall."

## Troubleshooting

<AccordionGroup>
  <Accordion title="Install option not showing">
    Make sure you're using Safari (iOS) or Chrome (Android/Desktop). Refresh the page and wait a few seconds for the banner to appear.
  </Accordion>

  <Accordion title="Notifications not working">
    Check that notifications are enabled both in Peanuts settings and in your device's system settings for the Peanuts app.
  </Accordion>

  <Accordion title="App feels slow">
    Close and reopen the app to get the latest version. Clear app cache if issues persist.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Notifications" icon="bell" href="/features/notifications">
    Configure reminders and alerts
  </Card>

  <Card title="Telegram Bot" icon="paper-plane" href="/integrations/telegram">
    Use Peanuts via Telegram instead
  </Card>
</CardGroup>