Cointy

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 9 Open GitHub ↗

Cointy is a modern, cross-platform mobile application built with Kotlin Multiplatform that enables users to manage their cryptocurrency portfolios, discover new coins, and perform virtual buy/sell transactions. With a clean architecture and beautiful Material Design 3 UI, Cointy provides a seamless experience for both Android and iOS users.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 💰 Cointy

### Cross-Platform Cryptocurrency Portfolio Management App

[![Kotlin](https://img.shields.io/badge/Kotlin-2.0.21-7F52FF?style=for-the-badge&logo=kotlin&logoColor=white)](https://kotlinlang.org)
[![Compose Multiplatform](https://img.shields.io/badge/Compose%20Multiplatform-1.7-4285F4?style=for-the-badge&logo=jetpack-compose&logoColor=white)](https://www.jetbrains.com/lp/compose-multiplatform/)
[![Android](https://img.shields.io/badge/Android-API%2024+-3DDC84?style=for-the-badge&logo=android&logoColor=white)](https://www.android.com)
[![iOS](https://img.shields.io/badge/iOS-13.0+-000000?style=for-the-badge&logo=ios&logoColor=white)](https://www.apple.com/ios/)
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](https://raw.githubusercontent.com/kaaneneskpc/Cointy/main/LICENSE)

*Your intelligent companion for managing cryptocurrency portfolios, tracking investments, and exploring the crypto market across Android and iOS.*

[Features](#-features) • [Tech Stack](#-tech-stack) • [Architecture](#-architecture) • [Getting Started](#-getting-started) • [Screenshots](#-screenshots)

---

</div>

## 🎯 About

**Cointy** is a modern, cross-platform mobile application built with Kotlin Multiplatform that enables users to manage their cryptocurrency portfolios, discover new coins, and perform virtual buy/sell transactions. With a clean architecture and beautiful Material Design 3 UI, Cointy provides a seamless experience for both Android and iOS users.

## 📱 Screenshots

### Android

| Portfolio History | Notification & Price Alerts | Search & Filter | Dark Mode | Settings | Export Portfolio |
|:-:|:-:|:-:|:-:|:-:|:-:|
| <img src="https://github.com/user-attachments/assets/8735d96c-f089-4480-a386-091081b25929" width="200"/> | <table><tr><td> <img src="https://github.com/user-attachments/assets/ab387b01-aa74-4f50-b70b-f3ad5d7f4653" width="100"/> <img src="https://github.com/user-attachments/assets/4883e7d8-092d-4595-b9bf-7ddd2f0b407b" width="100"/></td></tr></table> | <table><tr><td> <img src="https://github.com/user-attachments/assets/6ac37ed7-b189-4d4e-9457-862bc9152e9d" width="100"/> <img src="https://github.com/user-attachments/assets/8a60298e-1112-4a23-a68b-bee4dc0136a2" width="100"/></td></tr></table> | <img src="https://github.com/user-attachments/assets/d3dde0ac-459c-4b76-9fa7-a9b7b6fd7c53" width="200"/> | <img src="https://github.com/user-attachments/assets/bd1a2c01-529a-4db5-a095-3856f804db2b" width="200"/> | <table><tr><td> <img src="https://github.com/user-attachments/assets/9f46474e-942e-4df2-8fe0-742f68badba3" width="100"/> <img src="https://github.com/user-attachments/assets/feda169c-8000-4957-8cd7-bb15ffae32f9" width="100"/></td></tr></table>

</div>

### IOS

| Portfolio History | Notification & Price Alerts | Search & Filter | Dark Mode | Settings | Export Portfolio |
|:-:|:-:|:-:|:-:|:-:|:-:|
| <img src="https://github.com/user-attachments/assets/1fd7deea-b2f8-4afe-ba74-a92ef4f801a3" width="200"/> |  <table><tr><td><img src="https://github.com/user-attachments/assets/2a65d11c-1fc1-42e5-838d-23708abf8bad" width="100"/> <img src="https://github.com/user-attachments/assets/50d56405-6a19-480b-9125-5cc6251bee31" width="100"/></td></tr></table> | <table><tr><td><img src="https://github.com/user-attachments/assets/9306e199-955e-49c7-888b-6dc1b8eef491" width="100"/> <img src="https://github.com/user-attachments/assets/3e520688-77b1-4a85-a478-312dd178edfc" width="100"/></td></tr></table> | <img src="https://github.com/user-attachments/assets/d0738910-06a0-4b46-9b75-bf7fc115084e" width="200"/> | <img src="https://github.com/user-attachments/assets/17560334-aae8-403f-b4a1-23ec2209e579" width="200"/> | <img src="https://github.com/user-attachments/assets/50ca013b-692e-4544-8668-450fffeb9424" width="200"/> |

</div>

### Why Cointy?

- 📱 **Cross-Platform**: Single codebase for Android and iOS using Kotlin Multiplatform
- 🚀 **Interactive Onboarding**: Engaging and animated introduction for new users
- 🔐 **Firebase Authentication**: Secure email/password login and registration system
- 🔐 **Biometric Security**: Face ID / Touch ID for enhanced security
- 📊 **Real-Time Data**: Live cryptocurrency prices and market data via CoinRanking API
- 💼 **Portfolio Management**: Track your investments with detailed performance metrics
- 📈 **Price Charts**: Professional TradingView-style charts with interactive crosshair
- 💰 **Virtual Trading**: Practice buying and selling cryptocurrencies without real money
- 🔔 **Price Alerts**: Set alerts for price targets and get notified
- 📊 **Volatility Notifications**: Automatic alerts when coins move significantly
- 🔍 **Search & Filter**: Find coins quickly with powerful search and filtering
- 📊 **Analytics**: Detailed portfolio analytics with charts and statistics
- 🎨 **Modern UI**: Beautiful Material Design 3 interface with smooth animations
- 🌙 **Dark Mode**: Full dark mode support with system, light, and dark theme options
- 💾 **Offline Support**: Local database for offline access to your portfolio
- 📤 **Export Data**: Export portfolio and transactions to CSV or JSON
- 📱 **Home Screen Widgets**: Quick access to portfolio value and coin prices (Android)
- ⚠️ **Risk Analysis**: Portfolio volatility and risk scoring algorithm

## ✨ Features

### 🏦 Core Features

- **Firebase Authentication**
  - Email and password login with form validation
  - Real-time input validation (email format, password length)
  - Password visibility toggle for better UX
  - User registration with display name
  - Password reset via email
  - Persistent login state (automatic session restoration)
  - Secure sign out with session clearing
  - Loading states and error handling
  - Multi-language support (English/Turkish)
  - Clean Architecture with Repository and Use Case patterns
  - MVVM pattern with StateFlow for reactive state management
  - GitLive Firebase SDK for Kotlin Multiplatform

- **Interactive Onboarding**
  - Smooth first-time user experience
  - Animated icons with floating, pulsing, and wobbling effects
  - Multi-page introduction to app concepts
  - Fully localized in English and Turkish

- **Portfolio Dashboard**
  - View total portfolio value and cash balance
  - Track all owned cryptocurrencies
  - Performance percentage with color-coded indicators
  - Average purchase price tracking
  - Real-time portfolio value calculations

- **Coin Discovery**
  - Browse comprehensive list of cryptocurrencies
  - View current prices and 24h change percentages
  - Search and explore new investment opportunities
  - Long-press to view price history charts

- **Buy & Sell**
  - Virtual cryptocurrency trading
  - Buy coins with available cash balance
  - Sell coins from your portfolio
  - Automatic average purchase price calculation (DCA)
  - Insufficient funds validation

- **Price Charts (TradingView Style)**
  - Professional TradingView-style dark theme charts
  - Interactive crosshair for precise price tracking
  - OHLC (Open, High, Low, Close) data display
  - Animated chart line drawing with smooth transitions
  - Gradient fill under the price line
  - Price axis with dynamic labels on the right
  - Time axis with HH:mm format at the bottom
  - Current price indicator with colored badge
  - 24h price change percentage display
  - Touch and drag gesture support
  - Quick access via long-press gesture

- **Biometric Security**
  - Face ID / Touch ID authentication (iOS)
  - Fingerprint / Face unlock (Android)
  - Secure app access on launch
  - Platform-native biometric implementation

- **Cash Balance Management**
  - Track virtual cash balance
  - Automatic balance updates on transactions
  - Initial balance setup
  - Real-time balance display

- **🔔 Price Alerts & Notifications**
  - Create price alerts for any cryptocurrency
  - Set target price with condition (Above/Below)
  - Enable/disable alerts with toggle
  - Platform-native notifications (Android/iOS)
  - Track triggered alerts history
  - Automatic alert checking on coin list refresh

- **📊 Volatility Notifications**
  - Automatic notifications when coins move significantly
  - Configurable threshold (3%, 5%, 10%, 15%)
  - 1-hour cooldown to prevent spam
  - No manual alert setup required
  - Works with background price checking

- **🔍 Search & Filter**
  - Real-time coin search by name or symbol
  - Filter coins by performance (All, Gainers, Losers)
  - Sort coins by name, price, or 24h change
  - Transaction history search and filtering
  - Filter transactions by type (Buy/Sell)
  - Sort transactions by date or amount

- **📊 Portfolio Analytics**
  - Total portfolio value and profit/loss summary
  - Interactive pie chart for coin distribution
  - Portfolio history line chart with trends
  - Transaction statistics (total, buy, sell counts)
  - Individual coin performance tracking
  - Color-coded profit/loss indicators

- **⚠️ Risk Analysis**
  - Portfolio volatility calculation using 24h price changes
  - Risk score algorithm (0-100 scale)
  - Risk levels: Low, Moderate, High, Critical
  - Diversification score tracking
  - Concentration risk assessment
  - Per-coin risk contribution metrics
  - Animated risk gauge visualization

- **📜 Transaction History**
  - Complete buy/sell transaction records
  - Chronological transaction listing
  - Detailed transaction information
  - Search transactions by coin name
  - Filter by transaction type
  - Sort by date or amount

- **📤 Export Portfolio Data**
  - Export to CSV format for spreadsheet compatibility
  - Export to JSON format for data interchange
  - Portfolio holdings with performance data
  - Complete transaction history
  - Export preview with statistics
  - Android: Saves to Downloads folder
  - iOS: Saves to Documents folder (Files app)

- **🌙 Dark Mode & Settings**
  - Three theme options: System, Light, Dark
  - Real-time theme switching
  - Accessible from Portfolio screen
  - Consistent design across all themes
  - Optimized colors for both light and dark modes

- **👤 User Profile**
  - Profile photo display with avatar initials
  - First name and last name management
  - Edit profile dialog
  - Personalized user experience

- **🌐 Multi-Language Support**
  - English language support
  - Turkish language support (Türkçe)
  - Real-time language switching
  - All UI texts update dynamically

- **💱 Currency Selection**
  - USD (US Dollar)
  - EUR (Euro)
  - TRY (Turkish Lira)
  - GBP (British Pound)

- **🔔 Notification Settings**
  - General notifications toggle
  - Price alerts notification toggle
  - Granular notification control

- **📱 Home Screen Widgets (Android)**
  - Portfolio Value widget with total value and cash balance
  - Coin Prices widget showing portfolio coins with 24h change
  - Manual refresh button for instant updates
  - Dark theme design matching app aesthetics
  - Resizable widgets for customization

## 🛠 Tech Stack

### Multiplatform & Language
- **Language**: Kotlin 2.0.21
- **Platform**: Kotlin Multiplatform (KMP)
- **Min SDK (Android)**: 24
- **Target SDK (Android)**: 35
- **iOS**: 13.0+

### UI Framework
- **Compose Multiplatform**: Shared UI across platforms
- **Material Design 3**: Modern design system
- **Coil**: Image loading and caching
- **Compose Navigation**: Type-safe navigation
- **Compose Animations**: Professional-grade animations and transitions

### Architecture & Patterns
- **Clean Architecture**: Separation of concerns with multiple layers
- **MVVM Pattern**: ViewModel for UI state management
- **Repository Pattern**: Data abstraction layer
- **Use Cases**: Single responsibility business logic
- **Flow/StateFlow**: Reactive data streams

### Dependency Injection
- **Koin**: Lightweight dependency injection framework
- **Koin Compose**: Compose integration
- **Koin ViewModel**: ViewModel injection

### Data & Networking
- **Room Database**: Local data persistence (SQLite)
- **Ktor Client**: Modern HTTP client
- **Kotlinx Serialization**: JSON serialization/deserialization
- **CoinRanking API**: Cryptocurrency data provider
- **GitLive Firebase SDK**: Cross-platform Firebase Authentication (KMP)

### Asynchronous Programming
- **Kotlin Coroutines**: Asynchronous programming
- **Flow**: Reactive data streams
- **StateFlow**: State management
- **Channel**: Event handling

### Other Libraries
- **Kotlinx DateTime**: Date and time handling
- **AndroidX Biometric**: Biometric authentication
- **GitLive Firebase SDK**: Cross-platform Firebase Authentication (KMP)
- **KSP**: Kotlin Symbol Processing

## 🏗 Architecture

The app follows **Clean Architecture** principles with clear separation of concerns:

```
📦 Cointy
├── 📱 composeApp                    # Main application module
│   ├── commonMain/                  # Shared code for all platforms
│   │   ├── biometric/               # Biometric authentication
│   │   ├── onboarding/              # Interactive onboarding
│   │   ├── coins/                   # Coin discovery feature
│   │   │   ├── data/                # Data layer
│   │   │   ├── domain/              # Domain layer
│   │   │   └── presentation/        # Presentation layer
│   │   ├── core/                    # Core modules
│   │   ├── di/                      # Dependency injection
│   │   ├── portfolio/               # Portfolio management
│   │   ├── analytics/               # Portfolio analytics
│   │   ├── risk/                    # Risk analysis
│   │   ├── transaction/             # Transaction history
│   │   ├── alert/                   # Price alerts
│   │   ├── auth/                    # Firebase Authentication (login, register, forgot password)
│   │   ├── export/                  # Export portfolio data (CSV/JSON)
│   │   ├── settings/                # Settings and personalization
│   │   ├── theme/                   # UI theme and styles
│   │   └── trade/                   # Buy/Sell functionality
│   ├── androidMain/                 # Android-specific code
│   └── iosMain/                     # iOS-specific code
│
└── 📱 iosApp/                       # iOS application entry point
```

## 🚀 Getting Started

### Prerequisites

- **Android Studio**: Hedgehog | 2023.1.1 or newer
- **Xcode**: 14.0+ (for iOS development)
- **JDK**: 17 or higher
- **Kotlin**: 2.0.21
- **Android SDK**: API 24+
- **CocoaPods**: Latest version (for iOS)

### Installation

1. **Clone the repository**
```bash
git clone https://github.com/kaaneneskpc/Cointy.git
cd Cointy
```

2. **Open in Android Studio**
   - Launch Android Studio
   - Select "Open an Existing Project"
   - Navigate to the cloned directory
   - Wait for Gradle sync to complete

3. **Build the project**
```bash
# For Android
./gradlew :composeApp:assembleDebug

# For iOS (macOS only)
./gradlew :composeApp:embedAndSignAppleFrameworkForXcode
```

4. **Run the app**

**Android:**
   - Connect an Android device or start an emulator
   - Click the "Run" button in Android Studio
   - Or use the command line:
   ```bash
   ./gradlew :composeApp:installDebug
   ```

**iOS:**
   - Open `iosApp/iosApp.xcodeproj` in Xcode
   - Select your target device or simulator
   - Click the "Run" button in Xcode

---

## 📋 Project Roadmap

- [x] Cross-platform setup (Android & iOS)
- [x] Portfolio management
- [x] Coin discovery and listing
- [x] Buy/Sell functionality
- [x] Price charts
- [x] Biometric authentication
- [x] Local database persistence
- [x] Transaction history
- [x] Price alerts and notifications
- [x] Portfolio analytics and charts
- [x] Search and filter functionality
- [x] Dark mode support
- [x] Multi-currency support (USD, EUR, TRY, GBP)
- [x] Export portfolio data
- [x] Interactive Onboarding 🚀
- [x] Multi-language support (English, Turkish)
- [x] User profile management
- [x] Notification settings
- [x] Widgets (Android/IOS)
- [x] Risk Analysis (portfolio volatility & scoring)
- [x] Volatility Notifications (automatic price change alerts)
- [x] Firebase Authentication (email/password login & registration)

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 👨‍💻 Author

**Kaan Enes Kapıcı**

- GitHub: [@kaaneneskpc](https://github.com/kaaneneskpc)
- LinkedIn: [Kaan Enes Kapıcı](https://www.linkedin.com/in/kaaneneskpc)
- Email: kaaneneskpc1@gmail.com

## 🙏 Acknowledgments

- [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html) for enabling cross-platform development
- [Jetpack Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/) for the amazing UI toolkit
- [Material Design 3](https://m3.material.io/) for design guidelines
- [CoinRanking API](https://developers.coinranking.com/) for cryptocurrency data
- All contributors who help improve this project

## ⭐ Show Your Support

Give a ⭐️ if this project helped you!

### Made with ❤️ and ☕

**Happy Trading! 💰📈**

</div>

Cointy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README