📈 Stockistan — PSX Pakistan Stock Exchange

A modern Android app for tracking the Pakistan Stock Exchange (PSX) — real-time market data, portfolio management, and market analytics, built with Jetpack Compose.

Get it on Google Play

---

✨ Features

📊 Market

• Live PSX indices — KSE-100, KSE-30, All Share
• Real-time price updates
• Market summary and sector performance
• Interactive intraday & historical charts

🏢 Companies

• Detailed company profiles
• Key fundamentals — EPS, P/E, Market Cap
• Dividends & corporate actions history
• Historical and intraday candlestick charts

💼 Portfolio

• Portfolio tracking with live valuation
• Profit & loss breakdown
• Watchlists
• Price alerts

🎨 UI/UX

• Material 3 design system
• Dark / Light theme
• Offline caching for uninterrupted browsing
• Built entirely with Jetpack Compose

---

📱 Screenshots

---

🏗️ Architecture

The app follows Clean Architecture with an MVVM presentation layer:

data/        → Retrofit services, Room DAOs, repository implementations
domain/      → Use cases, domain models, repository interfaces
presentation/→ Compose UI, ViewModels, navigation

State flows from repositories → use cases → ViewModels (exposed as StateFlow) → Compose UI.

🛠️ Tech Stack

Layer	Technology
Language	Kotlin
UI	Jetpack Compose, Material 3
Async	Coroutines + Flow
Networking	Retrofit
Local storage	Room
DI	Hilt
Backend	Custom FastAPI service (PSX data scraping & caching)

📦 Requirements

• Android Studio Ladybug or newer
• JDK 17
• Android SDK 34
• Min SDK 24 (Android 7.0)

🚀 Getting Started

git clone https://github.com/<your-username>/psx-app.git
cd psx-app

🤝 Contributing

Contributions, issues, and feature requests are welcome. Feel free to check the issues page if you want to contribute.

📬 Contact

For questions or feedback, open an issue or reach out via the Google Play listing.