mhmoudalim/currency

A proof-of-concept Android app designed to help customers to handle different currency conversions.

Currency

Currency is a proof-of-concept Android app designed to help customers to hand different currency conversions.

---

Table of contents

• Features
• Implementation Details
• API
• Why Modularization
• App Modules
• App Architecture
• Preview
• Demo
• Credits
• License

---

Features

• User can convert currencies form different bases to any currency.
• User can swap between FROM - TO currencies and accordingly converted data changed.
• User can view list of his conversion history for the last 3 days (day by day).
• User can view a chart of conversions historical data in the last 3 days (day by day).
• User can view a list of rates of 10 most popular currencies form his selected base.
• User can make any conversion offline mode with the last cached rates fetched from Rest Api.

---

Implementation Details & technologies used

• Kotlin
• Modular Architecture
• Clean Architecture
• MVVM pattern
• Repository Pattern
• Observer Pattern
• Kotlin Dsl Gradle
• Dependency Injection using Dagger Hilt
• Unit testing
• Kotlin Coroutines
• Kotlin Flow
• Android Jetpack
• Android-KTX
• Room Database
• Navigation Component
• ViewBinding
• Jetpack Compose
• Retrofit & OkHttp
• Gson
• Java ThreeTen

---

Api

• Fixer Api

---

Why Modular Architecture ?

• Clean, Testable, Maintainable and extendable Codebase
• Apply high cohesion and low coupling
• Faster Gradle Build Time
• Easier Team-working on same project
• High Usability allowance of Codes
• Fine-grained dependency control.
• Improve reusability across other apps.
• Improves the ownership & the quality of the codebase.
• Stricter boundaries when compared to packages.
• Makes Instant Apps & Dynamic Features possible (improving discoverability).

---

App Modules

• App : contains views, state holders - represent presentation Logic (UI) Layer.
• Data : contains data, repos , use-cases, database - represent business logic (domain-data) Layers.
• Core : contains helper classes and shared claes with all modules.

---

App Architecture

---

Preview

1	2

---

Demo

Download App sample : Currency

---

Credits

• Guide to app architecture
• Android Components Architecture in a Modular Word

---

License

Click to reveal 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.