Skip to content

adit9852/Kripto

BranchesTags

Repository files navigation

Kripto Logo

Kripto

A Modern Cryptocurrency Tracking App for Android

Android Kotlin API License

Demonstration • Features • Architecture • Setup • Contributing • License

⚠️ Notice

This app is currently under active development. You may encounter bugs or incomplete features. Please report any issues via our GitHub Issues page.

🎬 Demonstration

🚀 Launch Live Demo

📱 About

Kripto is a modern, feature-rich cryptocurrency tracking application for Android that provides real-time market data for over 7,000 cryptocurrencies. Built with the latest Android development practices and powered by CoinGecko's API, Kripto offers a seamless user experience with dark mode, biometric security, and smooth animations.

Powered by CoinGecko

Powered by CoinGecko API

✨ Features

Core Features

  • 📊 Real-Time Market Data - Track prices, market cap, volume, and price charts for 7000+ cryptocurrencies
  • 🏦 Exchange Tracking - Monitor 400+ exchanges with Trust Score ratings
  • ⭐ Favorites - Bookmark your preferred coins for quick access
  • 🌍 Global Market Stats - View comprehensive cryptocurrency and DeFi market statistics
  • 💱 Multi-Currency Support - Choose from multiple fiat currencies
  • 📈 Interactive Charts - Beautiful price charts with multiple timeframes

Modern UI/UX Features

  • 🌙 Dark Mode - Full dark theme support with system-following option
  • 🔐 Biometric Authentication - Secure your app with fingerprint/face unlock
  • ✨ Smooth Animations - Material Design animations and transitions
  • 📳 Haptic Feedback - Tactile response for better user interaction
  • 🎨 Multiple Themes - Choose from various color themes
  • ⚡ Skeleton Loading - Shimmer effect while loading data
  • 🚀 Modern Splash Screen - Updated splash screen using Android 12+ API

🏗️ Architecture

Kripto follows modern Android development best practices with clean architecture and MVVM pattern.

graph TB
    subgraph "Presentation Layer"
        A[Activities/Fragments] --> B[ViewModels]
        B --> C[LiveData/StateFlow]
    end

    subgraph "Domain Layer"
        D[Use Cases]
        E[Repository Interface]
    end

    subgraph "Data Layer"
        F[Repository Implementation]
        F --> G[Remote Data Source]
        F --> H[Local Data Source]
        G --> I[Retrofit API]
        H --> J[Room Database]
    end

    subgraph "External Services"
        K[CoinGecko API]
        I --> K
    end

    subgraph "Dependency Injection"
        L[Hilt/Dagger]
        L -.->|Provides| B
        L -.->|Provides| F
        L -.->|Provides| I
        L -.->|Provides| J
    end

    B --> D
    D --> E
    E --> F

    subgraph "Utilities"
        M[ThemeManager]
        N[BiometricManager]
        O[AnimationUtils]
        P[HapticUtils]
    end

    A -.->|Uses| M
    A -.->|Uses| N
    A -.->|Uses| O
    A -.->|Uses| P

    style A fill:#42A5F5
    style B fill:#66BB6A
    style F fill:#FFA726
    style I fill:#EC407A
    style J fill:#AB47BC
    style K fill:#FF7043
    style L fill:#26C6DA
Loading

Architecture Components

  • MVVM Pattern - Separation of concerns with ViewModel and LiveData
  • Repository Pattern - Single source of truth for data operations
  • Dependency Injection - Hilt for managing dependencies
  • Reactive Programming - Kotlin Coroutines and Flow for asynchronous operations
  • Single Activity - Navigation Component for fragment management

🛠️ Tech Stack

Core Technologies

  • Language: Kotlin 1.9.25
  • Min SDK: 24 (Android 7.0)
  • Target SDK: 35 (Android 15)
  • Build System: Gradle 8.10.2 with AGP 8.7.2

Libraries and Dependencies

Networking

UI & Design

Architecture & DI

Async & Concurrency

Other

📋 Prerequisites

Before you begin, ensure you have the following installed:

  • Android Studio - Latest stable version (Hedgehog | 2023.1.1 or newer)
  • JDK - Java Development Kit 17
  • Gradle - Will be downloaded automatically by the wrapper
  • Android SDK - API Level 35

Download Android Studio

🚀 Development Setup

Method 1: Clone from Git

  1. Open Android Studio
  2. Select "Get from VCS" on the welcome screen
  3. Enter the repository URL: 
    https://github.com/YOUR_USERNAME/Kripto.git
  4. Click Clone
  5. Wait for Gradle sync to complete
  6. Click Run ▶️ to build and install the app

Method 2: Download ZIP

  1. Download the project as ZIP from GitHub
  2. Extract the ZIP file
  3. Open Android Studio
  4. Select "Open" and navigate to the extracted folder
  5. Wait for Gradle sync to complete
  6. Click Run ▶️ to build and install the app

Building APK

To build an APK file:

  1. Go to Build → Build Bundle(s) / APK(s) → Build APK(s)
  2. Wait for the build to complete
  3. Click "locate" in the notification to find your APK
  4. APK location: app/build/outputs/apk/debug/app-debug.apk

Or via command line:

# Windows
.\gradlew.bat assembleDebug

# Linux/Mac
./gradlew assembleDebug

🔧 Configuration

Gradle Configuration

The project uses:

  • Gradle: 8.10.2
  • Android Gradle Plugin: 8.7.2
  • Kotlin: 1.9.25
  • Java: 17

API Configuration

The app uses CoinGecko's free API which doesn't require an API key. However, rate limits apply:

📱 Permissions Required

The app requires the following permissions:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.USE_BIOMETRIC" />
  • INTERNET - Required to fetch cryptocurrency data from API
  • ACCESS_NETWORK_STATE - Check network connectivity status
  • VIBRATE - Haptic feedback for user interactions
  • USE_BIOMETRIC - Optional biometric authentication

🎨 Features Showcase

Dark Mode

Full dark theme support with three options:

  • Light Mode
  • Dark Mode
  • Follow System (Android 10+)

Biometric Security

Optional fingerprint or face unlock to secure the app.

Smooth Animations

  • Fade-in animations for list items
  • Pulse effects on button clicks
  • Shake animations for errors
  • Material Design transitions

Multi-Theme Support

Choose from various color themes:

  • Red
  • Blue
  • Green
  • Blue Gray
  • And more...

🤝 Contribution

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Please read our Contributing Guidelines for more details.

Areas for Contribution

  • 🐛 Bug fixes
  • ✨ New features
  • 📝 Documentation improvements
  • 🎨 UI/UX enhancements
  • 🌐 Translations
  • ♿ Accessibility improvements

📝 Project Structure

Kripto/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/camo/kripto/
│   │   │   │   ├── error/          # Error handling
│   │   │   │   ├── local/          # Room database
│   │   │   │   ├── remote/         # API services
│   │   │   │   ├── repos/          # Repository pattern
│   │   │   │   ├── ui/             # Activities, Fragments, Adapters
│   │   │   │   │   ├── adapter/
│   │   │   │   │   ├── presentation/
│   │   │   │   │   └── viewModel/
│   │   │   │   ├── utils/          # Utility classes
│   │   │   │   └── workers/        # Background workers
│   │   │   ├── res/                # Resources
│   │   │   │   ├── layout/
│   │   │   │   ├── values/
│   │   │   │   ├── values-night/   # Dark theme colors
│   │   │   │   ├── drawable/
│   │   │   │   └── mipmap/
│   │   │   └── AndroidManifest.xml
│   │   ├── test/                   # Unit tests
│   │   └── androidTest/            # Instrumentation tests
│   └── build.gradle
├── gradle/
├── build.gradle
└── settings.gradle

🐛 Known Issues

  • Rate limiting may occur with rapid API calls (CoinGecko free tier limitation)
  • Some cryptocurrency logos may not load due to API response

🔮 Future Enhancements

  • Price alerts and notifications
  • Portfolio tracking
  • News integration
  • Widget support
  • Export data to CSV
  • Compare cryptocurrencies
  • Watchlist sync across devices
  • Support for more fiat currencies

📄 License

Kripto - A Cryptocurrency Tracking App
Copyright (C) 2024

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

GNU GPLv3

👨‍💻 Author

Created with ❤️ by the Kripto team

🙏 Acknowledgments

  • CoinGecko for providing the comprehensive cryptocurrency API
  • Heroicons for beautiful icons
  • All open-source contributors whose libraries made this project possible

📞 Support

If you encounter any issues or have questions:

If you find this project useful, please consider giving it a ⭐️!

Made with ❤️ using Kotlin and Android

About

Kripto is a modern Android application for tracking real-time cryptocurrency prices, market analytics, and exchange credibility. Built using Kotlin, MVVM, Hilt, Coroutines, Retrofit, and Room, it offers interactive charts, global market data, watchlist personalization, dark mode, and biometric etc

appetize.io/app/b_bwfv35l2yu4chbojkd7a5pti3y

Resources

Readme

License

GPL-3.0 license

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Contributors

Languages