Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shorthouse/CoinWatch
CoinWatch is an Android cryptocurrency app providing real-time coin prices, price histories, and market data, built using the latest Android architecture components
https://github.com/shorthouse/CoinWatch
android android-clean-architecture android-jetpack bitcoin compose coroutines crypto cryptocurrency finance hilt jetpack-compose jetpack-compose-example junit kotlin kotlin-coroutines ktlint material-design-3 mvvm retrofit room-persistence-library
Last synced: about 1 month ago
JSON representation
CoinWatch is an Android cryptocurrency app providing real-time coin prices, price histories, and market data, built using the latest Android architecture components
- Host: GitHub
- URL: https://github.com/shorthouse/CoinWatch
- Owner: shorthouse
- Created: 2023-06-18T11:28:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-21T17:10:52.000Z (3 months ago)
- Last Synced: 2024-08-21T19:20:23.894Z (3 months ago)
- Topics: android, android-clean-architecture, android-jetpack, bitcoin, compose, coroutines, crypto, cryptocurrency, finance, hilt, jetpack-compose, jetpack-compose-example, junit, kotlin, kotlin-coroutines, ktlint, material-design-3, mvvm, retrofit, room-persistence-library
- Language: Kotlin
- Homepage:
- Size: 1.83 MB
- Stars: 82
- Watchers: 4
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
- jetpack-compose-awesome - CoinWatch - Delightful cryptocurrency app providing real-time coin prices, price histories, and market data (<a name="app-projects"></a> App Projects / UI)
- jetpack-compose-awesome - CoinWatch - Delightful cryptocurrency app providing real-time coin prices, price histories, and market data (<a name="app-projects"></a> App Projects / UI)
README
# CoinWatch
[](https://androidweekly.net/issues/issue-636)
[](https://github.com/shorthouse/CoinWatch/actions)
[](https://github.com/shorthouse/CoinWatch/releases)
[](https://www.apache.org/licenses/LICENSE-2.0)
[](https://medium.com/@shorthousedev)
[](https://github.com/shorthouse)
[](https://pinterest.github.io/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](https://developer.android.com/topic/architecture/recommendations) - resulting in a scalable, modularised and testable app.
# 📱 Download
# ⭐ 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](https://developer.android.com/topic/architecture).
# 🤝 Contributing
Contributions to the project are welcome and highly encouraged! To get started, please check out the [contributing guidelines](https://github.com/shorthouse/CoinWatch/blob/main/CONTRIBUTING.md).
# 📥 Contact
Do you have ideas to improve the app or a query for the developer?
Please get in touch via email - [email protected]
# ❤️ Acknowledgements
- Coin data provided by [CoinRanking API](https://developers.coinranking.com/api)
- Empty state images provided by [unDraw](https://undraw.co/illustrations)
# 🔖 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.
```