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

# Updating

> The extension updates itself — just click a button. Here's how it works and what to expect.

## Updates are automatic

fees.fun checks for new versions in the background. When one drops, you'll see a full-screen prompt the next time you open the popup. Click the button, allow Chrome to write to your folder, and the extension restarts with the new code in seconds.

Your wallets, settings, and session are all preserved. Nothing is lost.

<Info>
  After your first update, the extension remembers your folder. Future updates are just two clicks — **Update Now** and **Allow**.
</Info>

## First-time update

The first time you update, you'll need to tell the extension where it lives on your computer. After that, it remembers.

<Steps>
  <Step title="Hit Continue on the update screen">
    When you open the extension and a new version is out, you'll see **"Update Required"**. Hit **Continue**.

    You can dismiss this, but it'll come back every time you open the popup until you update.
  </Step>

  <Step title="Pick your extension folder">
    Chrome's folder picker opens. Navigate to the folder you originally loaded into Chrome via **Load unpacked** — the one with `manifest.json` inside it.

    <Warning>
      Pick the exact folder, not a parent or subfolder. The updater verifies it's the right one by checking for `manifest.json`.
    </Warning>

    Don't know where your extension folder is? See [how to find it](#find-your-extension-folder) below.
  </Step>

  <Step title="Click Allow">
    Chrome shows a permission dialog asking to **edit files in that folder**. This is Chrome's own built-in prompt — same one Google Docs uses. Click **Allow**.

    The extension can only touch the specific folder you selected, nothing else on your system.
  </Step>

  <Step title="Done — it handles the rest">
    The extension downloads the update from GitHub, verifies the file integrity, writes the new files, and reloads itself. Takes a few seconds.

    <Check>
      You won't need to pick the folder again. Next time, it's just **Update Now** → **Allow** → done.
    </Check>
  </Step>
</Steps>

## Find your extension folder

Not sure which folder to select? Here's how to find it in 30 seconds.

<Steps>
  <Step title="Go to chrome://extensions">
    Type `chrome://extensions` in your address bar and hit Enter. Make sure **Developer mode** is on (top-right toggle).
  </Step>

  <Step title="Click Details on fees.fun">
    Find the fees.fun card and click **Details**.
  </Step>

  <Step title="Scroll to the bottom">
    At the very bottom you'll see:

    ```text theme={null}
    Source
    Unpacked extension
    Loaded from: C:\Users\YourName\path\to\extension
    ```

    That **"Loaded from"** path is the folder you need to select when updating.

    <Tip>
      Copy this path or take a screenshot before you start the update — makes it easy to find in the folder picker.
    </Tip>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="'That folder doesn't look like the extension directory'">
    Wrong folder. Go to `chrome://extensions` → fees.fun → **Details** → scroll to bottom → check the **"Loaded from"** path. That's the one you need to select. Not the parent folder, not a subfolder — the exact folder shown there.
  </Accordion>

  <Accordion title="Folder picker won't open">
    The picker only opens from a direct button click inside the popup. If it's not working, close the popup and reopen it, then try again.
  </Accordion>

  <Accordion title="Download failed">
    Check your internet. Updates are downloaded from [GitHub ](https://github.com/feesdotfun/the-extension)— if GitHub is down or blocked on your network, it'll fail. Close the popup and try again in a minute.
  </Accordion>

  <Accordion title="Integrity check failed">
    The download got corrupted in transit. Close the popup and try again — it'll re-download fresh.
  </Accordion>

  <Accordion title="Extension didn't reload">
    Go to `chrome://extensions`, find fees.fun, and click the reload icon (circular arrow). That'll force it to pick up the new files.
  </Accordion>

  <Accordion title="Settings or wallets gone after update">
    This shouldn't happen — updates preserve all your data. If something's missing, make sure you selected the right folder (the same one Chrome was loading from, not a new one). Your wallets are tied to your Turnkey account — log in again and they'll be there.
  </Accordion>
</AccordionGroup>

## Common questions

<AccordionGroup>
  <Accordion title="Is this safe?">
    Yes. It uses Chrome's [File System Access API](https://developer.chrome.com/docs/capabilities/web-apis/file-system-access) — the same tech behind VS Code for the Web, Google Docs, and other trusted apps. Chrome controls the permission dialog and restricts access to only the folder you pick. Every download is verified with a SHA-256 hash.
  </Accordion>

  <Accordion title="Why do I have to pick a folder?">
    Chrome doesn't let extensions touch the filesystem on their own. The folder picker is how Chrome lets you explicitly say "yes, this extension can write here." Same reason Google Docs asks you to pick a file when saving to disk.
  </Accordion>

  <Accordion title="Why does Chrome ask permission every time?">
    Chrome resets file permissions when the browser restarts. This is a security feature — the extension can't bypass it. You'll always click **Allow** once per update, but you only pick the folder the first time.
  </Accordion>

  <Accordion title="Can I update manually?">
    Sure. Grab the latest `extension.zip` from the [releases page](https://github.com/feesdotfun/the-extension/releases), extract it over your existing folder (overwrite everything), then reload the extension in `chrome://extensions`. The in-app updater just does this automatically.
  </Accordion>

  <Accordion title="Can I skip an update?">
    You can dismiss the prompt, but it comes back every time you open the popup. Updates are required — your current version may stop working correctly without them.
  </Accordion>
</AccordionGroup>

***

<Card title="Still stuck?" icon="discord" horizontal href="https://discord.gg/feesdotfun">
  Drop a message in the [discord server](https://discord.gg/feesdotfun) with a screenshot of any error you're seeing. We'll sort it out.
</Card>