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

# PWA Installation Guide

> Install InkySwap as a Progressive Web App for a native app experience

<Note>
  InkySwap is available as a Progressive Web App (PWA), allowing you to install it on your device for a faster, more native experience with offline capabilities.
</Note>

## What is a PWA?

A Progressive Web App combines the best of web and mobile apps:

* **Installable**: Add to your home screen like a native app
* **Offline Support**: Works even without internet connection (limited features)
* **Fast Loading**: Cached resources for instant loading
* **Automatic Updates**: Always get the latest version
* **No App Store**: Install directly from your browser

## Installation Instructions

<Tabs>
  <Tab title="Desktop Chrome">
    <Steps>
      <Step title="Visit InkySwap">
        Navigate to [https://inkyswap.com](https://inkyswap.com) in Google Chrome
      </Step>

      <Step title="Look for Install Prompt">
        Click the install icon in the address bar (looks like a computer with an arrow)

        Alternatively:

        * Click the three dots menu (⋮) in the top right
        * Select "Install InkySwap..."
      </Step>

      <Step title="Confirm Installation">
        Click "Install" in the popup dialog
      </Step>

      <Step title="Launch the App">
        InkySwap will open in its own window. You can also find it in:

        * Chrome Apps (chrome://apps)
        * Your desktop/dock
        * Start menu (Windows) or Applications folder (Mac)
      </Step>
    </Steps>
  </Tab>

  <Tab title="Desktop Edge">
    <Steps>
      <Step title="Visit InkySwap">
        Navigate to [https://inkyswap.com](https://inkyswap.com) in Microsoft Edge
      </Step>

      <Step title="Look for Install Prompt">
        Click the install icon in the address bar

        Alternatively:

        * Click the three dots menu (⋯) in the top right
        * Select "Apps" → "Install this site as an app"
      </Step>

      <Step title="Name Your App">
        Optionally customize the app name, then click "Install"
      </Step>

      <Step title="Launch Options">
        Choose to:

        * Pin to taskbar
        * Pin to Start
        * Create desktop shortcut
        * Auto-start on device login
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS (iPhone/iPad)">
    <Steps>
      <Step title="Open in Safari">
        Navigate to [https://inkyswap.com](https://inkyswap.com) in Safari

        <Warning>
          PWA installation only works in Safari on iOS, not in Chrome or other browsers
        </Warning>
      </Step>

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

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

      <Step title="Name and Add">
        * Edit the name if desired
        * Tap "Add" in the top right corner
        * The PWA icon will appear on your home screen
      </Step>
    </Steps>
  </Tab>

  <Tab title="Android">
    <Steps>
      <Step title="Open in Chrome">
        Navigate to [https://inkyswap.com](https://inkyswap.com) in Chrome

        <Info>
          Also works in Edge, Firefox, and Samsung Internet
        </Info>
      </Step>

      <Step title="Look for Install Banner">
        You may see an "Add InkySwap to Home screen" banner at the bottom

        If not:

        * Tap the three dots menu (⋮) in the top right
        * Select "Add to Home screen" or "Install app"
      </Step>

      <Step title="Confirm Installation">
        * Review the app name
        * Tap "Add" or "Install"
      </Step>

      <Step title="Launch the App">
        The PWA will appear:

        * On your home screen
        * In your app drawer
        * In recent apps when running
      </Step>
    </Steps>
  </Tab>

  <Tab title="Desktop Firefox">
    <Steps>
      <Step title="Visit InkySwap">
        Navigate to [https://inkyswap.com](https://inkyswap.com) in Firefox
      </Step>

      <Step title="Look for Install Icon">
        Look for an install icon in the address bar

        <Warning>
          Firefox PWA support is limited. Consider using Chrome or Edge for full PWA features.
        </Warning>
      </Step>

      <Step title="Use Extension (Optional)">
        Install the "Progressive Web Apps for Firefox" extension for better PWA support
      </Step>

      <Step title="Alternative: Bookmark">
        As an alternative:

        * Bookmark the site (Ctrl/Cmd + D)
        * Add to bookmarks toolbar for quick access
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Features Available in PWA

### Full Functionality

✅ Token trading and swapping\
✅ Token creation and launching\
✅ Portfolio tracking\
✅ Chat and social features\
✅ Wallet connections\
✅ Real-time price updates

### Enhanced Experience

✅ Faster loading times\
✅ Full-screen mode\
✅ App-like navigation\
✅ Push notifications (coming soon)\
✅ Offline browsing of cached pages\
✅ Home screen shortcut

## Managing Your PWA

### Update the App

<CardGroup cols={2}>
  <Card title="Automatic Updates" icon="arrows-rotate">
    The PWA automatically checks for updates when you open it. Updates are applied in the background.
  </Card>

  <Card title="Force Update" icon="refresh">
    Pull down to refresh (mobile) or press Ctrl/Cmd + R (desktop) to force check for updates.
  </Card>
</CardGroup>

### Uninstall the App

<Tabs>
  <Tab title="Desktop">
    **Chrome/Edge:**

    1. Open the PWA
    2. Click the three dots menu
    3. Select "Uninstall InkySwap..."

    **Alternative:**

    * Go to chrome://apps or edge://apps
    * Right-click InkySwap
    * Select "Remove from Chrome/Edge"
  </Tab>

  <Tab title="iOS">
    1. Long press the InkySwap icon on home screen
    2. Tap "Remove App" or the (x) button
    3. Confirm deletion
  </Tab>

  <Tab title="Android">
    1. Long press the InkySwap icon
    2. Drag to "Uninstall" or tap "App info"
    3. Select "Uninstall"

    **Alternative:**

    * Go to Settings → Apps
    * Find InkySwap
    * Tap "Uninstall"
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Install option not appearing">
    * Ensure you're using a supported browser (Chrome, Edge, Safari)
    * Check you're on HTTPS ([https://inkyswap.com](https://inkyswap.com))
    * Clear browser cache and cookies
    * Try incognito/private mode
    * Wait a few seconds for the install prompt
  </Accordion>

  <Accordion title="PWA not updating">
    * Close and reopen the app
    * Clear the app cache in browser settings
    * Uninstall and reinstall the PWA
    * Check your internet connection
  </Accordion>

  <Accordion title="Wallet connection issues">
    * Ensure your wallet extension is installed in the browser
    * For mobile, use WalletConnect for best compatibility
    * Try connecting in the browser first, then in PWA
  </Accordion>

  <Accordion title="Performance issues">
    * Clear app data and cache
    * Ensure you have sufficient storage space
    * Close other apps to free up memory
    * Update your browser to the latest version
  </Accordion>

  <Accordion title="iOS limitations">
    iOS PWAs have some limitations:

    * No push notifications (yet)
    * Limited to 50MB cache
    * Must use Safari for installation
    * May lose data if unused for weeks
  </Accordion>
</AccordionGroup>

## Benefits of Using the PWA

<CardGroup cols={2}>
  <Card title="Speed" icon="rocket">
    Cached resources mean near-instant loading and smooth navigation
  </Card>

  <Card title="Convenience" icon="mobile">
    Access InkySwap directly from your home screen or desktop
  </Card>

  <Card title="Storage Efficient" icon="hard-drive">
    Takes up minimal space compared to native apps
  </Card>

  <Card title="Always Updated" icon="arrows-rotate">
    Automatically stays current with the latest features
  </Card>
</CardGroup>

## Browser Compatibility

| Browser          | Desktop    | Mobile     | PWA Support |
| ---------------- | ---------- | ---------- | ----------- |
| Chrome           | ✅ Full     | ✅ Full     | Excellent   |
| Edge             | ✅ Full     | ✅ Full     | Excellent   |
| Safari           | ✅ Full     | ✅ iOS only | Good (iOS)  |
| Firefox          | ⚠️ Limited | ⚠️ Limited | Limited     |
| Brave            | ✅ Full     | ✅ Full     | Excellent   |
| Opera            | ✅ Full     | ✅ Full     | Good        |
| Samsung Internet | N/A        | ✅ Full     | Good        |

<Note>
  For the best PWA experience, we recommend using Chrome, Edge, or Brave on desktop, and Safari on iOS or Chrome on Android.
</Note>

## Need Help?

If you're experiencing issues with the PWA installation or usage:

<CardGroup cols={2}>
  <Card title="Community Support" icon="telegram">
    Join our Telegram: [@inkyswap](https://t.me/inkyswap)
  </Card>

  <Card title="Report Issues" icon="bug">
    Contact: @emperoroftheink on Telegram
  </Card>
</CardGroup>