Trader App is a mobile trading simulator designed for practicing real-world trading using historical market data. It features full TradingView chart integration, a competitive community layer, and a robust backend powered by Supabase and Postgres.
The goal is to help users build real trading skills in a risk-free environment while competing on performance-based leaderboards.
Key Features
📊 Deterministic Chart Replay
Every trade is replayed with exact historical accuracy, ensuring:
Identical candle windows every time
Consistent visible chart ranges
Reliable behavior across weekends and market gaps
⏱ Multi-Timeframe Anchoring
A shared 2-year time anchor system ensures:
All timeframes (1m → 1W) stay synchronized
Consistent market context across views
Accurate multi-timeframe analysis
📉 Smart Candle Calculation Engine
A dynamic system that:
Normalizes chart depth across asset classes
Applies multipliers for forex, stocks, crypto, and commodities
Ensures uniform visual and analytical experience
🔗 Native ↔ Web Chart Integration
Single Compose Multiplatform codebase
Seamless integration with TradingView JS charts
Shared logic across Android and iOS via `expect/actual` bridges
👥 Social Trading Layer
Built-in community features powered by Supabase Realtime:
User profiles and follower system
Direct messaging (DMs)
Live community chat
Public trade feed
Push notifications via OneSignal
🏆 Skill-Based Ranking Systems
Competitive ranking model based on:
70% trading skill performance
30% engagement/work activity
All computed directly in PostgreSQL RPC functions for accuracy and speed.
💳 Subscriptions & Monetization
Powered by Adapty for in-app purchases
Webhook-driven subscription validation
`user_subscriptions` table as single source of truth
Secure paywall enforcement system
🎁 Referral System
Users earn rewards by inviting others
Every 2 paid referrals unlocks 1 free month
Rewards automatically applied during renewal cycles
🔐 Authentication & Account System
Google Sign-In support
Email and OTP authentication
Profile management with photos
GDPR-style full account deletion
Performance & Resilience
Designed for production-grade stability:
Twelve Data API circuit breaker for API failures
Local trading-pair cache for instant startup (0ms perceived load)
Race-condition protection on rapid timeframe switching
Engineering Highlights
Single Codebase Delivery: One Compose Multiplatform project runs on Android and iOS
Thin Client Architecture: Business logic centralized in Postgres (ranking, referrals, rewards)
Database as Source of Truth: Eliminated 318+ lines of hardcoded symbol mappings
Scalable Backend Design: Supabase + RPC-driven logic ensures maintainability and performance
Trader App is built as a modern, scalable trading simulation platform combining real market data, social competition, and strong backend engineering principles. It bridges education and gamification to help users develop real trading discipline in a structured environment.
