create-solana-mobile-app
v1.2.1
Published
Scaffold Expo + Solana Mobile starter apps with Mobile Wallet Adapter support
Maintainers
Readme
create-solana-mobile-app
CLI to scaffold Expo + Solana Mobile starter apps with Mobile Wallet Adapter support.
What It Creates
This tool generates a new Expo TypeScript app and injects Solana-ready starter code.
You can choose one of two variants:
--kit-only: Solana Kit provider and logic only.--wallet-ui: Solana Kit provider plus a ready-made wallet button UI.
Prerequisites
- Node.js 18+
- npm
- Android development environment (for Solana Mobile testing)
- Expo dev client workflow (
expo run:android), not Expo Go
Usage
Create a New App
npx create-solana-mobile-app <app-name> --kit-onlyor
npx create-solana-mobile-app <app-name> --wallet-uiIf no variant flag is provided, --kit-only is used by default.
Run the App
cd <app-name>
npx expo run:androidEnvironment
You can optionally set a custom RPC URL:
EXPO_PUBLIC_RPC_URL=https://api.devnet.solana.comIf not set, the starter defaults to Solana devnet.
Generated Project Includes
@solana/kit@solana-mobile/mobile-wallet-adapter-protocol-web3jsreact-native-quick-cryptobuffer- Metro config updates for crypto/buffer compatibility
- Buffer polyfill injection in app entry file
Local Development (This Repo)
Run the CLI directly from source:
node index.js my-app --wallet-uiTroubleshooting
"Wallet connected, but no valid base58 account address was returned"
Use the latest package version. Recent updates normalize wallet account addresses returned in multiple formats (base58, base64/base64url, and raw bytes).
Android build issues
- Confirm Android SDK and emulator/device are configured.
- Rebuild the app after dependency changes:
npx expo run:androidLicense
ISC
