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

# Migrate to Wallet Standard

> On the web, Mobile Wallet Adapter (MWA) is available as a *standard wallet* with the package:

* [`@solana-mobile/wallet-standard-mobile`](https://github.com/solana-mobile/mobile-wallet-adapter/tree/main/js/packages/wallet-standard-mobile)

This is the recommended library for MWA on web and this guide explains why and how to migrate your web app.

## How to upgrade

### 1. Install Mobile Wallet Standard

Installing the standard wallet takes two steps:

<Steps>
  <Step>
    Add the library `@solana-mobile/wallet-standard-mobile`.

    ```bash theme={null}
    npm install @solana-mobile/wallet-standard-mobile
    ```
  </Step>

  <Step>
    Call the `registerMwa` function.

    <Warning>
      **CAUTION**

      Ensure `registerMwa` is invoked in a non-SSR context. if you're using a framework with Server Side Rendering (e.g Next.js),
    </Warning>

    ```ts expandable theme={null}
    // 'use client' - If using Next.js, ensure it is registered in a non-SSR context.

    import { 
        createDefaultAuthorizationCache, 
        createDefaultChainSelector, 
        createDefaultWalletNotFoundHandler,
        registerMwa, 
    } from '@solana-mobile/wallet-standard-mobile';

    registerMwa({
        appIdentity: {
          name: 'My app',
          uri: 'https://myapp.io',
          icon: 'relative/path/to/icon.png', // resolves to https://myapp.io/relative/path/to/icon.png
        },    
        authorizationCache: createDefaultAuthorizationCache(),
        chains: ['solana:devnet', 'solana:mainnet'],
        chainSelector: createDefaultChainSelector(),
        onWalletNotFound: createDefaultWalletNotFoundHandler(),
    })
    ```

    Now, `Mobile Wallet Adapter` will appear as a wallet option.
  </Step>
</Steps>

For more context, view the **full [installation guide](/get-started/web/installation).**

### 2. Update to wallet-adapter >= 0.15.36

If your web app is using `@solana/wallet-adapter-react` update to a version `>= 0.15.36`.
Updating fixes common MWA Web issues like:

* the [*No connect after selecting MWA*](https://github.com/solana-mobile/mobile-wallet-adapter/issues/1086) bug.

## Why switch?

There are several reasons to upgrade to using MWA via Wallet Standard.

### Wallet Adapter no longer includes MWA as a default

The `@solana/wallet-adapter-react` library will [not include MWA as a default option](https://github.com/anza-xyz/wallet-adapter/pull/1097) starting from versions `>= 1.0.0`.

This means any web app using `@solana/wallet-adapter-react` will no longer display `Mobile Wallet Adapter` as an option for users
browsing on Android Chrome, unless explicitly added.

### Bug fixes and stability

The `@solana-mobile/wallet-standard-mobile` is the recommended web library for MWA going forward. This means it will receive all the latest feature additions and updates.

The legacy `@solana-mobile/wallet-adapter-mobile` library will be deprecated and enter maintenance mode, and only receive updates for bug fixes.