Skip to content

Latest commit

 

History

History
88 lines (71 loc) · 4.13 KB

README.md

File metadata and controls

88 lines (71 loc) · 4.13 KB

CoinWatch

Android Weekly Android CI Workflow Release License Apache 2.0 Medium shorthousedev GitHub shorthouse ktlint

CoinWatch is an Android cryptocurrency app providing real-time coin prices, price histories, and market data.

The app is built using the latest Android architecture components - resulting in a scalable, modularised and testable app.

📱 Download

Get it on Google Play

⭐ Features

  • Get a list of real-time prices and price changes of the top cryptocurrencies
  • Analyse coins in detail with animated price history graphs and market stats data
  • Search through thousands of cryptocurrencies by name or symbol
  • Create a personalized list of favourite cryptocurrencies

🛠 Built With

  • Kotlin
  • Jetpack Compose
  • Retrofit
  • Coil
  • OkHttp
  • Coroutines
  • Flow
  • Hilt
  • ViewModel
  • Timber logging
  • Room
  • Material Design 3
  • Static code analysis using Ktlint

🧬 Testing

CoinWatch features an extensive test suite, using the following:

  • JUnit for local tests
  • Jetpack Compose testing APIs for instrumented tests
  • Truth for assertions
  • MockK for mocks

🧱 Architecture

The design of CoinWatch follows a few key principles:

  1. Unidirectional Data Flow (UDF) - State flows in one direction, and events that modify the data flow in the opposite direction.
  2. Single Source of Truth (SSOT) - The SSOT is the owner of data, and only the SSOT can modify or mutate it.
  3. Drive UI from immutable data models - App data is contained within persistent data models and drives UI components.

A high-level overview of the app's architecture is displayed below. The architecture follows Google's official architecture guidance.

🤝 Contributing

Contributions to the project are welcome and highly encouraged! To get started, please check out the contributing guidelines.

📥 Contact

Do you have ideas to improve the app or a query for the developer?

Please get in touch via email - shorthousedev@gmail.com

❤️ Acknowledgements

🔖 License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.