Zyra - AI-Powered Global Payment Platform

Revolutionary blockchain-powered payment platform with AI voice interface, NFT rewards, and global accessibility.

🌟 Live Demos

🌐 Web Demo

Try Zyra in your browser →

📱 Mobile Demo

Scan QR code or open in Expo Go:

exp://u.expo.dev/b7990505-d700-4424-91b2-90b56ad33951/group/f64c1873-960f-4245-aed4-a2fcbd8c8618

---

🚀 Quick Start • 📱 Features • 🛠️ Development • 📚 Documentation

• 🌟 Live Demos
• ✨ Features
• 🏗️ Architecture
• 🚀 Quick Start
• ⚙️ Installation
• 🔧 Configuration
• 🛠️ Development
• 🌐 Deployment
• 🧪 Testing
• 📚 API Documentation
• 🤝 Contributing
• 📄 License
• 🆘 Support

• Real Algorand Integration - Live testnet transactions with actual blockchain verification
• Secure Wallet Creation - Generate real 58-character Algorand addresses
• Transaction History - Complete on-chain transaction tracking
• Cross-border Payments - Global transfers for just $0.0002 per transaction

• Voice Assistant - Natural language payment commands via ElevenLabs AI
• Smart Transaction Processing - AI-driven payment optimization
• Contextual Help - Intelligent assistance throughout the app

• NFT Rewards - Earn unique blockchain assets for transaction milestones
• Achievement System - Progress tracking with dynamic rewards
• Multi-tier Subscriptions - Basic, Pro, and Enterprise tiers with RevenueCat
• Loyalty Program - Transaction-based reward multipliers

• QR Code Scanning - Support for global payment formats (UPI, PIX, PayNow)
• Multi-currency Support - ALGO and custom Zyro token transfers
• Dark/Light Themes - Comprehensive theming system
• Responsive Design - Works on mobile and web platforms

• KYC Verification - Compliance-ready identity verification
• Demo Mode - Presentation-ready demonstration toggle
• Real-time Balances - Live blockchain balance updates
• Transaction Analytics - Comprehensive payment insights

{
  "@supabase/supabase-js": "^2.39.0",
  "algosdk": "^2.7.0", 
  "expo-router": "^3.5.23",
  "lucide-react-native": "^0.400.0",
  "react-native-get-random-values": "^1.11.0"
}

⚡ Get Zyra running in under 5 minutes

# Clone and install
git clone https://github.com/ItsAakif/Zyra.git
cd Zyra
npm install

# Set up environment (auto-guided setup)
npm run setup

# Start development server
npm start

That's it! The setup script will guide you through configuring all required services.

Before starting, ensure you have:

Run our interactive setup script:

npm run setup

This will:

• ✅ Check system requirements
• ✅ Guide you through service configuration
• ✅ Set up environment variables
• ✅ Initialize database schema
• ✅ Verify installation

Zyra requires several API keys for full functionality. Create a .env file in the root directory:

# 🗄️ Database Configuration
EXPO_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
EXPO_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key

# ⛓️ Blockchain Configuration  
EXPO_PUBLIC_ALGORAND_NODE_URL=https://testnet-api.algonode.cloud
EXPO_PUBLIC_ALGORAND_INDEXER_URL=https://testnet-idx.algonode.cloud
EXPO_PUBLIC_ALGORAND_NETWORK=testnet

# 🎤 AI Voice Configuration (Optional)
EXPO_PUBLIC_ELEVENLABS_API_KEY=your-elevenlabs-api-key

# 💳 Subscription Configuration (Optional)
EXPO_PUBLIC_REVENUECAT_APPLE_API_KEY=your-revenuecat-apple-key
EXPO_PUBLIC_REVENUECAT_GOOGLE_API_KEY=your-revenuecat-google-key

📦 Zyra/
├── 📱 app/                    # Application screens
│   ├── 🔐 (auth)/            # Authentication flow
│   ├── 📊 (tabs)/            # Main app navigation
│   ├── ⚙️ api/               # API route handlers
│   └── 🎨 _layout.tsx        # Root layout configuration
│
├── 🧩 components/            # Reusable UI components
│   ├── 💳 SubscriptionManager.tsx
│   ├── 🎙️ VoiceAssistant.tsx
│   └── 🔍 WalletDebug.tsx
│
├── ⚙️ lib/                   # Core business logic
│   ├── 🔐 auth.ts           # Authentication service
│   ├── ⛓️ algorand.ts       # Blockchain integration
│   ├── 🗄️ supabase.ts       # Database client
│   ├── 💰 real-wallet.ts    # Wallet management
│   ├── 🎤 voice-ai.ts       # AI voice processing
│   ├── 🎮 nft-marketplace.ts # NFT rewards system
│   └── 🌓 theme.tsx         # Dark/light theme system
│
├── 🎨 assets/               # Static assets
│   ├── 🖼️ images/          # App icons and logos
│   └── 📱 icons/            # Platform-specific icons
│
├── 🗄️ supabase/            # Database configuration
│   └── 📄 migrations/       # SQL schema migrations
│
└── 📋 types/               # TypeScript definitions
    └── 🔧 env.d.ts         # Environment type safety

# Start iOS simulator
npm run ios

# Open Xcode project
open ios/Zyra.xcworkspace

# Install on physical device
npx expo run:ios --device

# Start Android emulator
npm run android

# Install on physical device (USB debugging enabled)
npx expo run:android --device

# Open Android Studio
studio android/

# Start web development server
npm run web

# Build for web deployment
npx expo export:web

# Serve production build locally
npx serve web-build

• Fast Refresh: Instant code updates during development
• Live Reloading: Automatic app restart on changes
• Error Overlay: In-app error messages and stack traces

• React DevTools: Component inspection and profiling
• Flipper Integration: Network requests and performance monitoring
• Wallet Debug Panel: Blockchain transaction testing
• Demo Mode Toggle: Switch between real and demo data

• Real-time Logs: Console output from all platforms
• Performance Metrics: Bundle size and load times
• Error Tracking: Crash reports and error logs

• Strict mode enabled for type safety
• Path mapping for clean imports (@/lib, @/components)
• Environment type definitions
• Consistent code style with ESLint

# Run all tests
npm run test

# Run specific test suite
npm run test:unit
npm run test:integration
npm run test:e2e

# Generate coverage report
npm run test:coverage

# Run unit tests
npm run test:unit

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

# Run integration tests
npm run test:integration

# Test specific features
npm run test:auth
npm run test:payments
npm run test:voice

# Run E2E tests (iOS)
npm run test:e2e:ios

# Run E2E tests (Android)
npm run test:e2e:android

# Run E2E tests (Web)
npm run test:e2e:web

Special testing considerations for blockchain features:

# Test wallet functionality
npm run test:wallet

# Test transaction processing
npm run test:transactions

# Verify blockchain integration
npm run test:blockchain

Blockchain test coverage:

• ✅ Wallet creation and import
• ✅ Balance checking and updates
• ✅ Transaction signing and submission
• ✅ NFT minting and transfers
• ✅ Explorer link verification

# Install EAS CLI
npm install -g @expo/eas-cli

# Configure EAS
eas login
eas build:configure

# Build for app stores
eas build --platform all

# Submit to stores
eas submit --platform all

# Build web version
npx expo export:web

# Deploy to Vercel
npm install -g vercel
vercel --prod

# Deploy to Netlify
npm install -g netlify-cli
netlify deploy --prod --dir web-build

Create environment-specific configurations:

# Development
.env.development

# Staging  
.env.staging

# Production
.env.production

Environment Variables Checklist:

• ✅ Database URLs (Supabase)
• ✅ API Keys (ElevenLabs, RevenueCat)
• ✅ Blockchain Network (testnet/mainnet)
• ✅ Feature Flags
• ✅ Analytics Tokens

// Create new wallet
const wallet = await realWalletService.createWallet();

// Import existing wallet
const wallet = await realWalletService.importWallet(mnemonic);

// Get balance
const balance = await realWalletService.getBalance();

// Send payment
const txId = await realWalletService.sendPayment(
  toAddress: string,
  amount: number,
  currency: 'ALGO' | 'ZYRO',
  note?: string
);

// Check transaction status
const status = await algorandService.getTransactionStatus(txId);

// Process voice command
const result = await voiceService.processCommand(audioData);

// Text-to-speech
await voiceService.speak(text, options);

// Speech-to-text
const transcript = await voiceService.transcribe(audioData);

// Mint NFT reward
const nft = await nftService.mintRewardNFT(userId, rewardType);

// Get user NFTs
const nfts = await nftService.getUserNFTs(userId);

// Transfer NFT
await nftService.transferNFT(nftId, toAddress);

We welcome contributions! Here's how to get started:

1. Fork & Clone

   git clone https://github.com/YOUR_USERNAME/Zyra.git
   cd Zyra
   npm install

2. Create Feature Branch

   git checkout -b feature/your-feature-name

3. Make Changes

   • Follow TypeScript best practices
   • Add tests for new features
   • Update documentation as needed

4. Test Your Changes

   npm run test
   npm run build

5. Submit Pull Request

   • Clear description of changes
   • Link to related issues
   • Include screenshots for UI changes

• TypeScript: Strict mode enabled
• ESLint: Consistent code style
• Prettier: Automatic code formatting
• Testing: Unit and integration tests
• Documentation: JSDoc comments for public APIs

• 🐛 Bug Fixes: Report and fix issues
• ✨ Features: Add new functionality
• 📚 Documentation: Improve guides and examples
• 🧪 Testing: Increase test coverage
• 🎨 UI/UX: Enhance user experience
• ⚡ Performance: Optimize app performance

This project is licensed under the MIT License - see the LICENSE file for details.

• Algorand SDK: MIT License
• Supabase: MIT License
• React Native: MIT License
• Expo: MIT License

Common Issues:

Environment Check:

# Verify environment setup
npm run setup

# Check service status
npm run health-check