Skip to content

Fitstyle is an app that allows users to merge photos and art to create styled images.

License

Notifications You must be signed in to change notification settings

gojoel/fitStyle-android

Repository files navigation

Fitstyle

License API

Fitstyle is an app that allows users to merge photos and art to create styled images. This app showcases modern Android development with Kotlin, Coroutines, Flow, Jetpack, Hilt, Material Design and an MVVM architecture.

Tech stack

  • Minimum SDK level 21.
  • Kotlin based, utilizing Coroutines + Flow for asynchronous operations.
  • Jetpack Libraries:
    • Lifecycle: Observes Android lifecycles and manages UI states upon lifecycle changes.
    • ViewModel: Persists UI state, handles events and provides access to business logic through configuration changes.
    • Navigation: Facilitates screen navigation, complemented by Hilt Navigation Compose for dependency injection.
    • Room: Provides an abstraction layer over SQLite for seamless database access.
    • DataBinding: Binds UI components in your layouts to data sources in your app using a declarative format rather than programmatically.
    • Hilt: Dependency injection library to manage dependencies.
  • Architecture:
    • MVVM Architecture (View - ViewModel - Model): Facilitates separation of concerns and promotes maintainability.
    • Repository Pattern: Acts as a bridge between different data sources and the application's business logic.
  • Retrofit2 & OkHttp3: A type-safe HTTP client for consuming RESTful APIs.
  • Moshi: A modern JSON library for Kotlin and Java.
  • Glide: An image loading library that fetches and displays network images.
  • AWS Amplify: An Android library that facilitates interaction with AWS services.

Architecture

Fitstyle adopts the MVVM architecture and implements the Repository pattern, aligning with Google's official architecture guidance.

architecture

Architecture Overview

The architecture is constructed of two distinct layers, the UI layer and the data layer.

UI Layer

architecture

The role of the UI layer is to display application data and handle user interactions. It consists of UI elements that render the data on the sreen and state holders such as the ViewModel which can persist UI states through configuration changes and provide access to business logic.

Data Layer

architecture

The role of the data layer is to hold, manage, and provide access to the application data. It is made of repositories that abstract data sources from the rest of the app and contain business logic such as retrieving local or remote data. This layer adopts the single source of truth (SSOT) principle which ensures that all data is accessed and updated through a centralized repository for consistency and reliability.

architecture

Both the UI and data layer adhere to the Unidirectional Data Flow (UDF) pattern which enforce a separation of responsibility between the layers. In UDF, state flows moves in one direction and events that modify the data (e.g user actions) flow in the opposite direction.

This loosely coupled, layered architecture improves the maintainability, quality and robustness of the overall app.

License

Designed and developed by 2024 gojoel (Joel Goncalves)

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

   http://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.