Skip to content

REXREUS/Resonance

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Resonance Logo

๐ŸŽ™๏ธ Resonance

AI-Powered High-Stakes Communication Training

Features โ€ข Download โ€ข Screenshots โ€ข Getting Started โ€ข Tech Stack โ€ข Contributing

Platform Expo React Native License


๐ŸŒŸ Overview

Resonance is an offline-first Android mobile application that provides high-stakes communication training through real-time AI voice interactions. Train for critical conversations with AI-powered simulations that adapt to your performance.

Perfect for:

  • ๐Ÿ’ผ Sales Professionals - Practice difficult negotiations and objection handling
  • ๐Ÿ“ž Customer Service Representatives - Handle crisis situations and complaints
  • ๐Ÿ‘” Managers - Prepare for performance reviews and difficult conversations
  • ๐ŸŽค Public Speakers - Master Q&A sessions and investor pitches

โœจ Features

๐ŸŽฏ Core Features

Feature Description
Ultra-Low Latency Voice interactions under 800ms response time
Natural Interruption VAD (Voice Activity Detection) allows natural barge-in
25+ Scenarios Sales, Customer Service, HR, Presentations & more
Real-time Metrics Pace (WPM), Clarity, Confidence, Filler Words
Bilingual Support Indonesian ๐Ÿ‡ฎ๐Ÿ‡ฉ & English ๐Ÿ‡ฌ๐Ÿ‡ง

๐Ÿ”ฅ Chaos Engine

Simulate real-world disruptions to build resilience:

  • ๐ŸŽญ Random Voice Gen - Pitch and speed variations
  • ๐Ÿ”Š Background Noise - Office, rain, traffic, cafe sounds
  • โšก Hardware Failure - Mic mute, connection drops simulation

๐ŸŽ™๏ธ Voice Lab

  • Clone up to 5 custom voices with ElevenLabs
  • Adjust stability and similarity settings
  • TTS Playground for voice testing

๐Ÿ“Š Analytics & Reports

  • Comprehensive session reports with AI coaching feedback
  • Performance trends and progress tracking
  • Export reports as PDF/CSV
  • Achievement system with gamification

๐Ÿ”’ Privacy-First

  • Offline-First: Full functionality without internet
  • Local Storage: All data stays on your device
  • Encrypted Keys: API keys stored securely

๐Ÿ“ฅ Download

Latest Release

Download APK

Installation Steps:

  1. Download the latest .apk file from Releases
  2. Enable "Install from Unknown Sources" in your Android settings
  3. Open the downloaded APK file
  4. Tap "Install"
  5. Launch Resonance and start training!

โš ๏ธ Note: You'll need to configure your own API keys (ElevenLabs & Gemini) in Settings for full functionality. The app works in Mock Mode without API keys.


๐Ÿ“ฑ Screenshots

Dashboard Session Setup Simulation Report


๐Ÿš€ Getting Started

Prerequisites

  • Node.js v18 or higher
  • npm or yarn
  • Android Studio (for development)
  • Expo CLI (npm install -g expo-cli)

Installation

# Clone the repository
git clone https://github.com/REXREUS/resonance.git
cd resonance-mobile-app

# Install dependencies
npm install

# Start development server
npx expo start

# Run on Android
npx expo run:android

API Configuration

To use AI features, you'll need:

  1. ElevenLabs API Key - Get it here
  2. Gemini API Key - Get it here

Configure keys in: Settings > API Configuration


๐Ÿ› ๏ธ Tech Stack

Framework & Platform

Technology Version Purpose
Expo SDK 52.0.0 Managed workflow with config plugins
React Native 0.76.0 Cross-platform mobile development
Expo Router 4.0.0 File-based navigation

UI & Styling

Technology Purpose
NativeWind Tailwind CSS for React Native
Moti Declarative animations
React Native Reanimated Performance animations
Lucide Icons Beautiful icon library
Lottie High-performance animations

AI & Audio

Technology Purpose
Gemini 2.5 Flash AI conversation logic
ElevenLabs WebSocket Real-time TTS streaming
react-native-live-audio-stream Real-time audio input
expo-av Audio playback and recording

Data & Storage

Technology Purpose
expo-sqlite Local SQLite database
expo-secure-store Encrypted API key storage
Zustand Lightweight state management

๐Ÿ“ Project Structure

resonance-mobile-app/
โ”œโ”€โ”€ ๐Ÿ“‚ app/                    # Expo Router screens
โ”‚   โ”œโ”€โ”€ (tabs)/               # Tab navigation screens
โ”‚   โ”œโ”€โ”€ session-setup.jsx     # Training configuration
โ”‚   โ”œโ”€โ”€ simulation.jsx        # Active simulation
โ”‚   โ”œโ”€โ”€ stress-mode.jsx       # Stress test mode
โ”‚   โ””โ”€โ”€ report.jsx            # Session report
โ”œโ”€โ”€ ๐Ÿ“‚ components/             # Reusable UI components
โ”‚   โ”œโ”€โ”€ ui/                   # Base UI components
โ”‚   โ”œโ”€โ”€ audio/                # Audio-related components
โ”‚   โ””โ”€โ”€ charts/               # Data visualization
โ”œโ”€โ”€ ๐Ÿ“‚ services/               # Core business logic
โ”‚   โ”œโ”€โ”€ audioEngine.js        # Audio I/O management
โ”‚   โ”œโ”€โ”€ vadService.js         # Voice Activity Detection
โ”‚   โ”œโ”€โ”€ elevenLabsService.js  # ElevenLabs integration
โ”‚   โ”œโ”€โ”€ geminiService.js      # Gemini AI logic
โ”‚   โ””โ”€โ”€ chaosEngine.js        # Disruption simulation
โ”œโ”€โ”€ ๐Ÿ“‚ hooks/                  # Custom React hooks
โ”œโ”€โ”€ ๐Ÿ“‚ stores/                 # Zustand state stores
โ”œโ”€โ”€ ๐Ÿ“‚ constants/              # App configuration
โ”œโ”€โ”€ ๐Ÿ“‚ utils/                  # Utility functions
โ””โ”€โ”€ ๐Ÿ“‚ assets/                 # Static assets

๐ŸŽฎ Usage Guide

1. First Launch

  • Complete the onboarding tutorial
  • Configure your API keys in Settings (optional for Mock Mode)
  • Set your preferred language (Indonesian/English)

2. Start Training

  1. Tap the yellow microphone button on the dashboard
  2. Select a scenario (e.g., Sales Objection, Customer Complaint)
  3. Choose training mode:
    • Standard Training: Single conversation practice
    • Stress Mode: Handle multiple callers under pressure
  4. Configure Chaos Engine options (optional)
  5. Tap Start Simulation

3. During Simulation

  • Speak naturally - the AI will respond in real-time
  • Interrupt anytime - VAD detects when you want to speak
  • Monitor your metrics in the HUD
  • Tap End Call when finished

4. Review Performance

  • View your overall score and letter grade
  • Check detailed metrics (Pace, Clarity, Confidence)
  • Read AI coaching feedback
  • Export report as PDF/CSV

๐Ÿงช Testing

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run with coverage
npm run test:coverage

๐Ÿ—๏ธ Building

Development Build

npx expo run:android

Production APK

# Using EAS Build
eas build --platform android --profile production

# Local build
npx expo prebuild
cd android && ./gradlew assembleRelease

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License

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


๐Ÿ™ Acknowledgments


Made with โค๏ธ for better communication

Report Bug โ€ข Request Feature