This is the React Native mobile application for Confío, a Web3 wallet for Latin America.
- Node.js (v18 or higher)
- Yarn package manager
- React Native CLI
- Android Studio (for Android development)
- Xcode (for iOS development, macOS only)
-
Run the setup script:
./scripts/setup-platform.sh
-
Install dependencies:
yarn install
-
iOS setup (macOS only):
cd ios bundle install bundle exec pod install cd ..
-
Run the app:
# iOS (macOS only) yarn ios # Android yarn android
-
Run the setup script:
scripts\setup-platform.bat
-
Install dependencies:
yarn install
-
Run Android app:
yarn android
-
For iOS development on Windows:
- Use WSL2 with Ubuntu for limited iOS development
- Use a remote macOS machine
- Use cloud-based iOS development services
If the setup scripts don't work, you can manually configure platform-specific files:
- Create
android/local.properties:## This file must *NOT* be checked into Version Control Systems, # as it contains information specific to your local configuration. # # Location of the SDK. This is only used by Gradle. # For customization when using a Version Control System, please read the # header note. # macOS: /Users/YOUR_USERNAME/Library/Android/sdk # Windows: C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Android\\Sdk # Linux: /home/YOUR_USERNAME/Android/Sdk sdk.dir=/path/to/your/android/sdk
- Create
ios/.xcode.env.local:# macOS (Homebrew): /opt/homebrew/bin/node # macOS (nvm): /Users/YOUR_USERNAME/.nvm/versions/node/VERSION/bin/node # Windows: C:\\Program Files\\nodejs\\node.exe # Linux: /usr/bin/node or /usr/local/bin/node export NODE_BINARY=/path/to/your/node
The following files contain platform-specific paths and should never be committed to Git:
android/local.properties- Contains Android SDK pathios/.xcode.env.local- Contains Node.js path*.xcworkspace/xcuserdata/- Xcode user-specific data*.xcodeproj/xcuserdata/- Xcode user-specific data*.xcodeproj/project.xcworkspace/xcuserdata/- Xcode user-specific data.env*files - Environment variables
Use these template files as reference:
android/local.properties.template- Android SDK configuration templateios/.xcode.env.template- iOS Node.js configuration template
- Always run setup scripts when cloning the repository
- Never commit platform-specific configuration files
- Use template files as reference for manual configuration
- Test on both platforms before merging platform-specific changes
- Document platform differences in commit messages
apps/
├── android/ # Android-specific native code
├── ios/ # iOS-specific native code (macOS only)
├── src/ # React Native source code
│ ├── components/ # Reusable components
│ ├── screens/ # App screens
│ ├── services/ # API services
│ ├── utils/ # Utility functions
│ └── ...
├── scripts/ # Build and setup scripts
│ ├── setup-platform.sh # macOS/Linux setup script
│ └── setup-platform.bat # Windows setup script
└── ...
-
Shared Code Changes:
- All changes in
src/are shared across platforms - Test on both iOS and Android before committing
- All changes in
-
Platform-Specific Changes:
- Document platform differences clearly
- Use platform-specific files when necessary
- Test thoroughly on the target platform
-
Native Dependencies:
- iOS: Update
ios/Podfileand runpod install - Android: Update
android/app/build.gradleand sync
- iOS: Update
-
SDK not found:
- Run
./scripts/setup-platform.sh(macOS/Linux) orscripts\setup-platform.bat(Windows) - Verify Android SDK installation
- Check
android/local.propertiespath
- Run
-
Gradle sync failed:
- Clean project:
cd android && ./gradlew clean - Invalidate caches in Android Studio
- Check Gradle version compatibility
- Clean project:
-
Node.js not found:
- Run
./scripts/setup-platform.sh - Verify Node.js installation
- Check
ios/.xcode.env.localpath
- Run
-
Pod install failed:
- Update CocoaPods:
sudo gem install cocoapods - Clean and reinstall:
cd ios && rm -rf Pods && bundle exec pod install
- Update CocoaPods:
The app supports multiple accounts per user:
- Personal Accounts: Individual wallets for personal transactions
- Business Accounts: Dedicated wallets for business operations
- Account Switching: Seamless switching between accounts
- Deterministic Addresses: Same OAuth identity + account context = same Sui address
- Non-custodial: Private keys never stored on servers
- Secure Storage: Uses React Native Keychain for sensitive data
- zkLogin Integration: Zero-knowledge proof authentication
- Token Management: Automatic refresh and secure storage
# Run tests
yarn test
# Run tests with coverage
yarn test --coverage
# Run specific test file
yarn test zkLogin.test.ts# Generate signed APK
cd android
./gradlew assembleRelease
# Generate signed AAB (for Play Store)
./gradlew bundleRelease# Archive for App Store
# Use Xcode: Product > Archive- Fork the repository
- Create a feature branch
- Make your changes
- Test on both platforms (if applicable)
- Submit a pull request
- iOS changes: Test on macOS
- Android changes: Test on your platform
- Cross-platform changes: Test on both platforms
- Documentation: Update README for platform differences
MIT License - see main repository for details.