Phase 2 done for app

Author: myofficework000

.gitignore

@@ -0,0 +1,16 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
+**/build/

.idea/.gitignore

@@ -0,0 +1,54 @@
+# GithubCompose (Kotlin + Jetpack Compose + Navigation + MVI)
+
+![Language](https://img.shields.io/github/languages/top/cortinico/kotlin-android-template?color=blue&logo=kotlin)
+
+GithubCompose is a sample project that presents a modern approach to Android app development.
+
+The project tries to combine popular Android tools and to demonstrate best development practices by utilizing up to date tech-stack like Compose, Kotlin Flow and Koin.
+
+The sample app presents a modern Android application Architecture that is scalable and maintainable through a MVI.
+
+## Description
+
+* UI
+    * [Compose](https://developer.android.com/jetpack/compose) declarative UI framework
+    * [Material design](https://material.io/design)
+
+* Tech/Tools
+    * [Kotlin](https://kotlinlang.org/) 100% coverage
+    * [Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) and [Flow](https://developer.android.com/kotlin/flow) for async operations
+    * [Koin](https://insert-koin.io/) for dependency injection
+    * [Jetpack](https://developer.android.com/jetpack)
+        * [Compose](https://developer.android.com/jetpack/compose)
+        * [Navigation](https://developer.android.com/topic/libraries/architecture/navigation/) for navigation between composables
+        * [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel) that stores, exposes and manages UI state
+    * [Retrofit](https://square.github.io/retrofit/) for networking
+    * [Coil](https://github.com/coil-kt/coil) for image loading
+
+* Modern Architecture
+    * Single activity architecture (with [Navigation component](https://developer.android.com/guide/navigation/navigation-getting-started)) that defines navigation graphs
+    * MVI
+    * [Android Architecture components](https://developer.android.com/topic/libraries/architecture) ([ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel), [Navigation](https://developer.android.com/jetpack/androidx/releases/navigation))
+    * [Android KTX](https://developer.android.com/kotlin/ktx) - Jetpack Kotlin extensions
+    
+## Light and Dark mode
+<img src="misc/demo_light_mode.gif" width="360" height="820"> <img src="misc/demo_dark_mode.gif" width="360" height="820">
+
+## Architecture
+The project is layered traditionally with a View, Presentation, Model separation and presents a MVI inspired from [Yusuf Ceylan's architecture](https://proandroiddev.com/mvi-architecture-with-kotlin-flows-and-channels-d36820b2028d) but adapted to Compose.
+
+Architecture layers:
+* View - Composable screens that consume state, apply effects and delegate events.
+* ViewModel - [AAC ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel) that manages and reduces the state of the corresponding screen. Additionally, it intercepts UI events and produces side-effects. The ViewModel lifecycle scope is tied to the corresponding screen composable.
+* Model - Repository classes that retrieve data. In a clean architecture context, one should use use-cases that tap into repositories.
+
+![](https://i.imgur.com/UXwFbmv.png)
+
+There are a three core components described:
+* **State** - data class that holds the state content of the corresponding screen e.g. list of `User`, loading status etc. The state is exposed as a Compose runtime `MutableState` object from that perfectly matches the use-case of receiving continuous updates with initial value.
+
+* **Event** - plain object that is sent through callbacks from the UI to the presentation layer. Events should reflect UI events caused by the user. Event updates are exposed as a `MutableSharedFlow` type which is similar to `StateFlow` and that behaves as in the absence of a subscriber, any posted event will be immediately dropped.
+
+* **Effect** - plain object that signals one-time side-effect actions that should impact the UI e.g. triggering a navigation action, showing a Toast, SnackBar etc. Effects are exposed as `ChannelFlow` which behave as in each event is delivered to a single subscriber. An attempt to post an event without subscribers will suspend as soon as the channel buffer becomes full, waiting for a subscriber to appear.
+
+Every screen/flow defines its own contract class that states all corresponding core components described above: state content, events and effects.

.idea/.name

@@ -0,0 +1 @@
+/build

.idea/compiler.xml

@@ -0,0 +1,112 @@
+plugins {
+    id(Dependencies.Plugins.application)
+    id(Dependencies.Plugins.kotlinAndroid)
+}
+
+android {
+    compileSdk = AppConfig.compileSdk
+
+    defaultConfig {
+        applicationId = AppConfig.applicationId
+        minSdk = AppConfig.minSdk
+        targetSdk = AppConfig.targetSdk
+        versionCode = AppConfig.versionCode
+        versionName = AppConfig.versionName
+
+        testInstrumentationRunner = AppConfig.androidTestInstrumentation
+        vectorDrawables {
+            useSupportLibrary = true
+        }
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = AppConfig.javaCompatibility
+        targetCompatibility = AppConfig.javaCompatibility
+    }
+
+    kotlinOptions {
+        jvmTarget = AppConfig.javaJvmTarget
+    }
+
+    buildFeatures {
+        compose = true
+    }
+
+    composeOptions {
+        kotlinCompilerExtensionVersion = Dependencies.Android.Version.compose
+    }
+
+    packagingOptions {
+        resources {
+            excludes += "/META-INF/{AL2.0,LGPL2.1}"
+        }
+    }
+
+    testOptions {
+        unitTests.apply {
+            isReturnDefaultValues = true
+        }
+    }
+
+    sourceSets {
+        getByName("main").java.srcDirs("src/main/resources", "src/main/test/resources")
+        getByName("test").java.srcDirs("src/test/resources")
+        getByName("androidTest").java.srcDirs("src/androidTest/resources")
+    }
+}
+
+dependencies {
+    // Android
+    implementation(Dependencies.Android.coreKts)
+    implementation(Dependencies.Android.appCompat)
+    implementation(Dependencies.Android.activityCompose)
+    implementation(Dependencies.Android.navigationCompose)
+
+    implementation(Dependencies.Android.composeUi)
+    implementation(Dependencies.Android.composeMaterial)
+    implementation(Dependencies.Android.composeMaterialIconsExtended)
+    implementation(Dependencies.Android.composeUiTooling)
+    implementation(Dependencies.Android.composeUiToolingPreview)
+
+    implementation(Dependencies.Android.lifecycleRuntimeKtx)
+    implementation(Dependencies.Android.lifecycleViewModelKtx)
+    implementation(Dependencies.Android.lifecycleExtensions)
+    implementation(Dependencies.Android.lifecycleViewModelCompose)
+
+    // Third Party
+    implementation(Dependencies.ThirdParty.coilCompose)
+    implementation(Dependencies.ThirdParty.androidMaterial)
+
+    implementation(Dependencies.ThirdParty.kotlinxCoroutinesCore)
+    implementation(Dependencies.ThirdParty.kotlinxCoroutinesAndroid)
+
+    implementation(Dependencies.ThirdParty.retrofit)
+    implementation(Dependencies.ThirdParty.retrofitConverterGson)
+
+    implementation(Dependencies.ThirdParty.koinAndroid)
+    implementation(Dependencies.ThirdParty.koinAndroidxCompose)
+
+    // Test
+    testImplementation(Dependencies.Test.junit)
+    testImplementation(Dependencies.Test.roboeletric)
+    testImplementation(Dependencies.Test.mockk)
+    testImplementation(Dependencies.Test.kotlinxCoroutinesTest)
+    testImplementation(Dependencies.Test.koinTest)
+    testImplementation(Dependencies.Test.okHttp3MockWebServer)
+
+    // Android Test
+    androidTestImplementation(Dependencies.AndroidTest.junit)
+    androidTestImplementation(Dependencies.AndroidTest.espressoCore)
+    androidTestImplementation(Dependencies.AndroidTest.composeJunit)
+    debugImplementation(Dependencies.AndroidTest.composeUiTooling)
+}

.idea/gradle.xml

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.kts.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

.idea/kotlinc.xml

@@ -0,0 +1,24 @@
+package com.abhishek.pathak.kotlin.android.githubcompose
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+    @Test
+    fun useAppContext() {
+        // Context of the app under test.
+        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+        assertEquals("com.br.wcabral.kotlin.android.githubcompose", appContext.packageName)
+    }
+}

.idea/misc.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.abhishek.pathak.kotlin.android.githubcompose">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+        android:name="com.abhishek.pathak.kotlin.android.githubcompose.GithubApplication"
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.GithubCompose">
+        <activity
+            android:name="com.abhishek.pathak.kotlin.android.githubcompose.ui.feature.main.MainActivity"
+            android:exported="true"
+            android:theme="@style/Theme.GithubCompose.NoActionBar">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

.idea/vcs.xml

@@ -0,0 +1,21 @@
+package com.abhishek.pathak.kotlin.android.githubcompose
+
+import android.app.Application
+import com.abhishek.pathak.kotlin.android.githubcompose.di.appModules
+import org.koin.android.ext.koin.androidContext
+import org.koin.android.ext.koin.androidLogger
+import org.koin.core.context.startKoin
+import org.koin.core.logger.Level
+
+class GithubApplication: Application() {
+
+    override fun onCreate() {
+        super.onCreate()
+        startKoin {
+            androidLogger(Level.ERROR)
+            androidContext(this@GithubApplication)
+            modules(appModules)
+        }
+    }
+
+}

README.md

@@ -0,0 +1,6 @@
+package com.abhishek.pathak.kotlin.android.githubcompose.common
+
+import android.content.Intent
+import android.net.Uri
+
+fun buildUrlIntent(url: String) = Intent(Intent.ACTION_VIEW, Uri.parse(url))