Stellar-Wallets-Kit icon indicating copy to clipboard operation
Stellar-Wallets-Kit copied to clipboard

Add more info for wallets on wallet kit

Open janewang opened this issue 4 months ago • 2 comments

Problem

The term “Not Available” is overloaded in the current wallet UI. It’s being used to mean:

  • The wallet is not installed.
  • The wallet exists, but cannot be used on the current platform (e.g. a mobile-only wallet when on desktop).

This creates confusion for users. For example, if I visit with Hana Wallet and only see “Not Available,” I don’t understand whether it’s because I need to install it, or because my platform isn’t supported.

Proposal

Decouple states into two callouts:

  • Install → visible as a link out to the wallet’s installation page/store.
  • Not Available → used only when the wallet is unsupported on the user’s current platform.
Image

Platform awareness:

Show the Install link only if the user is on a platform where installation is possible (e.g., Chrome desktop → show Chrome extension install link). For unsupported platforms (e.g., desktop browser for a mobile-only wallet), show Not Available.

Additional clarity:

Consider adding a small platform tag (e.g., Desktop, Mobile, Extension) next to each wallet, so users can quickly understand compatibility.

janewang avatar Aug 26 '25 17:08 janewang

Wouldn't it be better to just hide wallets that aren't available on the user's platform, rather than having "Not Available"?

JakeUrban avatar Aug 26 '25 17:08 JakeUrban

@janewang I agree with @JakeUrban in not showing the wallet if we know is unsupported by the platform, I also believe is going to be difficult to know that a wallet is supported or not in all cases, for example a Ledger device is supported on mobile based on the browser and version of the OS you are using, but we can make it so if the kit is not fully sure it just shows the install button instead of hiding it. That way we avoid hiding wallets because of false positives

earrietadev avatar Sep 02 '25 23:09 earrietadev