Android - peer-network/peer_backend GitHub Wiki

🤖 Android App — Peer Network

This page documents the Android client for Peer Network, built in Kotlin with a modern modular architecture.

📱 Project Overview

Built using Jetpack Compose (no XML)
Clean modular structure with data, domain, remote, and ui layers
Uses Kotlin Coroutines and Flow for reactive state management
Connects to the backend GraphQL API (Apollo)
Handles authentication, posting, wallet, profile — with more features in development

🧱 Tech Stack

Layer	Tech / Tool
Language	Kotlin
UI Framework	Jetpack Compose
State Management	Kotlin Flow + ViewModel
Networking	Apollo GraphQL
Token Storage	SharedPreferences
Build System	Gradle (modular setup)
Architecture	Clean Architecture (Modular)

✅ Implemented Features

User authentication (register, login, logout)
Profile editing (username, bio, image)
Content feed: create, read, comment on posts
Follow/block users
Wallet screen with balance and activity

🚫 Not Yet Implemented

❌ Real-time messaging (chat system not integrated)
❌ Push notifications
❌ Token transfer from wallet
❌ Referral logic on registration

⚙️ Backend Integration

All operations use GraphQL via Apollo client
Token (JWT) is stored securely in SharedPreferences
referralUuid is passed when available during registration
GraphQL schema code is generated automatically for type safety

🧪 Testing

Manual testing is currently used for most flows
CI test integration with backend is planned
Some modules are structured for future unit testing (domain and data layers)

📁 Project Structure

peer_android_frontend/

├── app/                    # Main application module (entry point)

├── blog/                   # Feature module: blog
│   ├── data/               # Repositories, data sources
│   ├── domain/             # Use cases, domain models
│   ├── remote/             # Remote API handling (Apollo)
│   └── ui/                 # UI layer (Composables, ViewModels)

├── core/                   # Shared code across all modules
│   ├── common/             # Common utilities, base classes
│   ├── remote/             # Shared network code
│   └── ui/                 # Shared UI components, themes, styles

├── media/                  # Media handling (images/videos)
│   ├── core/
│   └── ui/

├── persistence/            # Local storage & persistence logic
│   ├── data/
│   ├── domain/
│   ├── local/              # SharedPreferences, etc.

├── social/                 # Friends, chat, follow system
│   ├── data/
│   ├── domain/
│   ├── remote/
│   └── ui/

├── user/                   # Auth, profile, user info
│   ├── data/
│   ├── domain/
│   ├── remote/
│   └── ui/

├── wallet/                 # Token display & wallet interaction
│   ├── data/
│   ├── domain/
│   ├── remote/
│   └── ui/

📓 Related Pages

💻 Clients
🍏 iOS
🌐 WebApp
🏠 Home
📬 GraphQL Schema Overview