JumbeChap Mobile

The mobile application for JumbeChap messaging platform.

Description

This is a cross-platform mobile application that provides native iOS and Android experiences for the JumbeChap messaging platform. It offers real-time messaging capabilities, push notifications, and an intuitive mobile-first user interface.

Tech Stack

• React Native - Cross-platform mobile framework
• Expo (optional) - Development toolchain and SDK

Additional dependencies will be added as needed during development.

Features

• Native mobile experience for iOS and Android
• Real-time messaging
• Push notifications
• Offline support
• Fast and responsive UI

Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• React Native CLI or Expo CLI
• iOS: Xcode (macOS only)
• Android: Android Studio and Android SDK

Installation

1. Install dependencies:

npm install

2. Create a .env file in the mobile directory:

API_URL=http://localhost:8000
WS_URL=ws://localhost:8000

Running the App

Using React Native CLI:

# Start Metro bundler
npm start

# Run on iOS (macOS only)
npm run ios

# Run on Android
npm run android

Using Expo:

# Start Expo development server
npx expo start

# Run on iOS simulator
npx expo run:ios

# Run on Android emulator
npx expo run:android

Available Scripts

• npm start - Start the development server
• npm run ios - Run on iOS simulator
• npm run android - Run on Android emulator
• npm run lint - Run ESLint
• npm test - Run tests

Project Structure

mobile/
├── src/
│   ├── components/   # React components
│   ├── screens/      # Screen components
│   ├── navigation/   # Navigation setup
│   ├── services/     # API services
│   ├── utils/        # Utility functions
│   └── App.js        # Main App component
├── android/          # Android native code
├── ios/              # iOS native code
├── assets/           # Images, fonts, etc.
├── package.json      # Dependencies and scripts
└── README.md         # This file

Structure will expand as the application grows.

Building for Production

iOS:

# Build for iOS
npx react-native build-ios --mode Release

Android:

# Build APK
cd android
./gradlew assembleRelease

# Build App Bundle (for Play Store)
./gradlew bundleRelease

Testing on Physical Devices

iOS:

1. Connect your iPhone via USB
2. Open ios/JumbeChap.xcworkspace in Xcode
3. Select your device and click Run

Android:

1. Enable Developer Mode on your Android device
2. Enable USB Debugging
3. Connect via USB
4. Run: npm run android

Environment Variables

Environment variables can be configured in a .env file as needed during development.

Contributing

Please refer to the main project README for contribution guidelines.