Skip to main content

​
System requirements

Before installing Synto Mobile, ensure your device meets these requirements:
  • Android 5.0 (Lollipop) or higher
  • At least 100MB of free storage
  • A Solana-compatible mobile wallet (Phantom, Solflare, etc.)

​
Installing on Android

1

Download the APK

Get the latest release from the GitHub releases page:
  1. Navigate to the latest release
  2. Download the .apk file to your Android device
  3. Wait for the download to complete
You can also download directly to your computer and transfer via USB.
2

Enable installation from unknown sources

Android requires permission to install apps outside the Play Store:
  1. Open Settings on your device
  2. Navigate to Security or Privacy
  3. Find Install unknown apps or Unknown sources
  4. Select your browser or file manager
  5. Toggle Allow from this source
Only enable this for trusted apps. Remember to disable it after installation for security.
3

Install the APK

  1. Open your device’s Downloads folder or file manager
  2. Tap the downloaded synto-mobile.apk file
  3. Review the permissions requested
  4. Tap Install
  5. Wait for installation to complete
  6. Tap Open or find Synto Mobile in your app drawer
4

Install a Solana wallet

If you don’t have a Solana wallet yet:

Phantom Mobile

Popular and user-friendly Solana wallet with mobile support.

Solflare

Full-featured Solana wallet with hardware wallet support.
Install one of these from the Google Play Store before proceeding.

​
Installing on iOS

iOS distribution: Synto Mobile is currently in development. iOS users can run the app using Expo Go while we prepare App Store distribution.
1

Install Expo Go

Download Expo Go from the App Store:
  1. Open the App Store on your iOS device
  2. Search for “Expo Go”
  3. Tap Get to install
  4. Open the app once installed
2

Get the development build

You have two options:Option A: Use a hosted build
  • Contact the development team for a QR code
  • Scan the QR code with your camera app
  • Tap the notification to open in Expo Go
Option B: Run locally
  • Clone the repository on your computer
  • Run npm install && npx expo start
  • Scan the QR code displayed in terminal
3

Install a Solana wallet

Install a compatible Solana wallet:

​
TestFlight (Coming Soon)

We’re working on TestFlight distribution for easier iOS installation. Join our community to get notified when it’s available!

​
Development setup

For developers who want to build from source or contribute to Synto Mobile:

​
Prerequisites

Install the required development tools: 
# Install Node.js 18 or higher
# Visit https://nodejs.org/ to download

# Verify installation
node --version  # Should be v18.0.0 or higher
npm --version

​
Clone and install

1

Clone the repository

git clone https://github.com/juiiceee/synto-mobile.git
cd synto-mobile
2

Install dependencies

Using npm:
npm install
Or using bun for faster installation:
bun install
Installation takes 2-3 minutes on first run. Subsequent installs are faster.
3

Configure environment

Create a .env file in the root directory:
.env
# Backend API configuration
EXPO_PUBLIC_BACKEND_URL=your_backend_url
EXPO_PUBLIC_BACKEND_KEY=your_api_key

# Optional: Solana RPC endpoint
EXPO_PUBLIC_RPC_URL=https://api.mainnet-beta.solana.com
Never commit your .env file to version control. It’s already in .gitignore.
4

Start the development server

npx expo start
This will start the Expo development server and display a QR code.

​
Running on devices

Physical device:
  1. Enable developer mode on your Android device
  2. Enable USB debugging in developer options
  3. Connect via USB
  4. Run: npx expo run:android
Emulator:
  1. Start Android Studio
  2. Open AVD Manager
  3. Launch an emulator
  4. Run: npx expo run:android
Expo Go:
  1. Install Expo Go from Play Store
  2. Scan the QR code from terminal
  3. App will load in Expo Go

​
Building for production

Create production builds for distribution: 
# Prebuild native Android project
npm run android:build

# Build APK
cd android
./gradlew assembleRelease

# APK location:
# android/app/build/outputs/apk/release/app-release.apk
EAS Build is recommended for production builds. It handles code signing, provisioning, and app store distribution automatically.

​
Troubleshooting

Problem: APK won’t install or shows errorSolutions:
  • Ensure you’ve enabled installation from unknown sources
  • Check that you have enough storage space (100MB+)
  • Try uninstalling previous version first
  • Verify APK is not corrupted by re-downloading
  • Check Android version is 5.0 or higher
Problem: Can’t connect to Solana walletSolutions:
  • Ensure you have a compatible wallet installed
  • Update your wallet app to the latest version
  • Try connecting with a different wallet
  • Check that Mobile Wallet Adapter is supported
  • Restart both Synto and your wallet app
Problem: expo start fails or shows errorsSolutions:
# Clear cache and reinstall
rm -rf node_modules
npm install
npx expo start --clear

# Update Expo
npm install expo@latest

# Check Node version
node --version  # Should be 18+
Problem: Expo Go can’t scan QR codeSolutions:
  • Ensure phone and computer are on same WiFi network
  • Try using tunnel mode: npx expo start --tunnel
  • Manually enter URL shown in terminal
  • Check firewall isn’t blocking port 19000
  • Try scanning with QR code reader first
Problem: TypeScript or build errorsSolutions:
# Run type checking
npm run build

# Run linter
npm run lint

# Format code
npm run fmt

# Prebuild native projects
npm run android:build

​
Package information

Synto Mobile uses these key dependencies: 
{
  "expo": "~53.0.16",
  "react-native": "0.79.5",
  "expo-router": "~5.1.0"
}

​
Next steps

Now that Synto Mobile is installed:

Quick start guide

Connect your wallet and send your first AI message.

AI capabilities

Discover everything you can do with Synto’s AI agent.

Development guide

Learn about the app architecture and start contributing.

Wallet operations

Master sending, receiving, and managing your crypto.
Need help? Join our GitHub Discussions or open an issue if you encounter problems.

Build docs developers (and LLMs) love

Get started for freeTalk to us