diff --git a/.github/workflows/pr-checks.yml b/.github/workflows/pr-checks.yml
index c2c32e463e..54e8e0fde3 100644
--- a/.github/workflows/pr-checks.yml
+++ b/.github/workflows/pr-checks.yml
@@ -65,6 +65,7 @@ jobs:
                 feature:alert
                 feature:exit-form
                 feature:select-subject-age-group
+                feature:external-credential
             reportsId: feature1
 
     feature-unit-tests2:
diff --git a/feature/external-credential/build.gradle.kts b/feature/external-credential/build.gradle.kts
index 2db2841b64..b3d0f060fa 100644
--- a/feature/external-credential/build.gradle.kts
+++ b/feature/external-credential/build.gradle.kts
@@ -8,5 +8,9 @@ android {
 }
 
 dependencies {
+    implementation(project(":infra:config-store"))
+    implementation(project(":infra:config-sync"))
+    implementation(project(":infra:ui-base"))
     implementation(project(":feature:exit-form"))
+    implementation(libs.androidX.cameraX.view)
 }
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/ext/ResourceExt.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/ext/ResourceExt.kt
new file mode 100644
index 0000000000..acaa6ed77f
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/ext/ResourceExt.kt
@@ -0,0 +1,25 @@
+package com.simprints.feature.externalcredential.ext
+
+import android.content.res.Resources
+import androidx.annotation.PluralsRes
+import androidx.annotation.StringRes
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+
+fun Resources.getQuantityCredentialString(
+    @PluralsRes id: Int,
+    @StringRes specificCredentialRes: Int,
+    @StringRes multipleCredentialsRes: Int,
+    credentialTypes: List<ExternalCredentialType>,
+): String {
+    val credentialsAmount = credentialTypes.size
+    val documentTypeRes = if (credentialsAmount == 1) {
+        specificCredentialRes
+    } else {
+        multipleCredentialsRes
+    }
+    return getQuantityString(
+        id,
+        credentialsAmount,
+        getString(documentTypeRes)
+    )
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialControllerFragment.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialControllerFragment.kt
index e95d488dc3..3cf0cb453f 100644
--- a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialControllerFragment.kt
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialControllerFragment.kt
@@ -2,23 +2,27 @@ package com.simprints.feature.externalcredential.screens.controller
 
 import android.os.Bundle
 import android.view.View
+import androidx.activity.addCallback
 import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
 import androidx.navigation.NavController
 import androidx.navigation.fragment.findNavController
-import androidx.navigation.fragment.navArgs
 import com.simprints.feature.exitform.ExitFormContract
 import com.simprints.feature.exitform.ExitFormResult
 import com.simprints.feature.externalcredential.GraphExternalCredentialInternalDirections
 import com.simprints.feature.externalcredential.R
+import com.simprints.feature.externalcredential.model.ExternalCredentialParams
 import com.simprints.infra.uibase.navigation.finishWithResult
 import com.simprints.infra.uibase.navigation.handleResult
 import com.simprints.infra.uibase.navigation.navigateSafely
+import com.simprints.infra.uibase.navigation.navigationParams
 import dagger.hilt.android.AndroidEntryPoint
 import kotlin.getValue
 
 @AndroidEntryPoint
 internal class ExternalCredentialControllerFragment : Fragment(R.layout.fragment_external_credential_controller) {
-    private val args: ExternalCredentialControllerFragmentArgs by navArgs()
+    private val params: ExternalCredentialParams by navigationParams()
+    private val viewModel: ExternalCredentialViewModel by activityViewModels()
 
     private val hostFragment: Fragment?
         get() = childFragmentManager.findFragmentById(R.id.external_credential_host_fragment)
@@ -32,6 +36,8 @@ internal class ExternalCredentialControllerFragment : Fragment(R.layout.fragment
     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
         super.onViewCreated(view, savedInstanceState)
 
+        viewModel.init(params)
+
         findNavController().handleResult<ExitFormResult>(
             this,
             R.id.externalCredentialControllerFragment,
@@ -48,5 +54,29 @@ internal class ExternalCredentialControllerFragment : Fragment(R.layout.fragment
             }
         }
         internalNavController?.setGraph(R.navigation.graph_external_credential_internal)
+
+        initObservers()
+        initListeners()
+    }
+
+    private fun initObservers() {
+        viewModel.stateLiveData.observe(viewLifecycleOwner) {
+        }
+    }
+
+    private fun initListeners() {
+        requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner) {
+            when (internalNavController?.currentDestination?.id) {
+                R.id.externalCredentialSelectFragment, R.id.externalCredentialSearch -> {
+                    // Exit form navigation
+                    findNavController().navigateSafely(
+                        this@ExternalCredentialControllerFragment,
+                        R.id.action_global_refusalFragment,
+                    )
+                }
+
+                else -> internalNavController?.popBackStack()
+            }
+        }
     }
 }
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialState.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialState.kt
new file mode 100644
index 0000000000..9ceb7409db
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialState.kt
@@ -0,0 +1,20 @@
+package com.simprints.feature.externalcredential.screens.controller
+
+import com.simprints.core.domain.common.FlowType
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+
+internal data class ExternalCredentialState(
+    val subjectId: String?,
+    val flowType: FlowType,
+    val credentialValue: String?,
+    val selectedType: ExternalCredentialType?
+) {
+    companion object {
+        val EMPTY = ExternalCredentialState(
+            subjectId = null,
+            flowType = FlowType.VERIFY,
+            credentialValue = null,
+            selectedType = null,
+        )
+    }
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModel.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModel.kt
new file mode 100644
index 0000000000..53dea8553c
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModel.kt
@@ -0,0 +1,50 @@
+package com.simprints.feature.externalcredential.screens.controller
+
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import androidx.lifecycle.ViewModel
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+import com.simprints.feature.externalcredential.model.ExternalCredentialParams
+import dagger.hilt.android.lifecycle.HiltViewModel
+import javax.inject.Inject
+import com.simprints.infra.resources.R as IDR
+
+@HiltViewModel
+internal class ExternalCredentialViewModel @Inject internal constructor() : ViewModel() {
+
+    private var isInitialized = false
+    private var state: ExternalCredentialState = ExternalCredentialState.EMPTY
+        set(value) {
+            field = value
+            _stateLiveData.postValue(value)
+        }
+    private val _stateLiveData = MutableLiveData(ExternalCredentialState.EMPTY)
+    val stateLiveData: LiveData<ExternalCredentialState> = _stateLiveData
+
+    private fun updateState(state: (ExternalCredentialState) -> ExternalCredentialState) {
+        this.state = state(this.state)
+    }
+
+    fun setSelectedExternalCredentialType(selectedType: ExternalCredentialType?) {
+        updateState { it.copy(selectedType = selectedType) }
+    }
+
+    fun setExternalCredentialValue(value: String) {
+        updateState { it.copy(credentialValue = value) }
+    }
+
+    fun init(params: ExternalCredentialParams) {
+        if (!isInitialized) {
+            isInitialized = true
+            updateState { ExternalCredentialState.EMPTY.copy(subjectId = params.subjectId, flowType = params.flowType) }
+        }
+    }
+
+
+    fun mapTypeToStringResource(type: ExternalCredentialType?) = when (type) {
+        ExternalCredentialType.NHISCard -> IDR.string.mfid_type_nhis_card
+        ExternalCredentialType.GhanaIdCard -> IDR.string.mfid_type_ghana_id_card
+        ExternalCredentialType.QRCode -> IDR.string.mfid_type_qr_code
+        null -> IDR.string.mfid_type_any_document
+    }
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrFragment.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrFragment.kt
index 93c452cc05..f842b52525 100644
--- a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrFragment.kt
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrFragment.kt
@@ -1,9 +1,259 @@
 package com.simprints.feature.externalcredential.screens.scanqr
 
+import android.Manifest.permission.CAMERA
+import android.app.Dialog
+import android.content.Intent
+import android.graphics.Rect
+import android.os.Bundle
+import android.provider.Settings
+import android.view.View
+import android.widget.Button
+import android.widget.TextView
+import android.widget.Toast
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.core.net.toUri
+import androidx.core.view.isVisible
 import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.fragment.app.viewModels
+import androidx.lifecycle.Lifecycle
+import androidx.lifecycle.lifecycleScope
+import androidx.lifecycle.repeatOnLifecycle
+import androidx.navigation.fragment.findNavController
+import com.google.android.material.bottomsheet.BottomSheetBehavior
+import com.google.android.material.bottomsheet.BottomSheetDialog
+import com.simprints.core.tools.extentions.getCurrentPermissionStatus
+import com.simprints.core.tools.extentions.hasPermission
+import com.simprints.core.tools.extentions.permissionFromResult
 import com.simprints.feature.externalcredential.R
+import com.simprints.feature.externalcredential.databinding.FragmentExternalCredentialScanQrBinding
+import com.simprints.feature.externalcredential.screens.controller.ExternalCredentialViewModel
+import com.simprints.infra.logging.LoggingConstants
+import com.simprints.infra.logging.LoggingConstants.CrashReportTag.MULTI_FACTOR_ID
+import com.simprints.infra.logging.Simber
+import com.simprints.infra.uibase.camera.qrscan.CameraHelper
+import com.simprints.infra.uibase.camera.qrscan.QrCodeAnalyzer
+import com.simprints.infra.uibase.navigation.navigateSafely
+import com.simprints.infra.uibase.view.applySystemBarInsets
+import com.simprints.infra.uibase.viewbinding.viewBinding
 import dagger.hilt.android.AndroidEntryPoint
+import kotlinx.coroutines.flow.catch
+import kotlinx.coroutines.flow.collectLatest
+import kotlinx.coroutines.launch
+import javax.inject.Inject
+import kotlin.getValue
+import com.simprints.infra.resources.R as IDR
 
 @AndroidEntryPoint
 internal class ExternalCredentialScanQrFragment : Fragment(R.layout.fragment_external_credential_scan_qr) {
+
+    private val binding by viewBinding(FragmentExternalCredentialScanQrBinding::bind)
+    private val crashReportTag = MULTI_FACTOR_ID
+    private val mainViewModel: ExternalCredentialViewModel by activityViewModels()
+    private val viewModel by viewModels<ExternalCredentialScanQrViewModel>()
+
+    private var dialog: Dialog? = null
+    private var isCameraInitialized = false
+
+    @Inject
+    lateinit var cameraHelperFactory: CameraHelper.Factory
+    private val cameraHelper: CameraHelper by lazy {
+        cameraHelperFactory.create(crashReportTag)
+    }
+
+    @Inject
+    lateinit var qrCodeAnalyzerFactory: QrCodeAnalyzer.Factory
+    private lateinit var qrCodeAnalyzer: QrCodeAnalyzer
+
+    private val launchPermissionRequest = registerForActivityResult(
+        ActivityResultContracts.RequestPermission(),
+    ) { granted ->
+        val cameraPermissionStatus = requireActivity().permissionFromResult(CAMERA, granted)
+        viewModel.updateCameraPermissionStatus(cameraPermissionStatus)
+    }
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+        applySystemBarInsets(view)
+        Simber.i("ExternalCredentialScanQrFragment started", tag = MULTI_FACTOR_ID)
+
+
+        initObservers()
+
+        if (!requireActivity().hasPermission(CAMERA)) {
+            launchPermissionRequest.launch(CAMERA)
+        }
+    }
+
+    override fun onResume() {
+        super.onResume()
+        val cameraPermissionStatus = requireActivity().getCurrentPermissionStatus(CAMERA)
+        viewModel.updateCameraPermissionStatus(cameraPermissionStatus)
+    }
+
+    override fun onDestroy() {
+        dismissDialog()
+        super.onDestroy()
+    }
+
+    private fun dismissDialog() {
+        dialog?.dismiss()
+        dialog = null
+    }
+
+    private fun initObservers() {
+        viewModel.stateLiveData.observe(viewLifecycleOwner) { state ->
+            when (state) {
+                ScanQrState.ReadyToScan -> {
+                    renderInitialState()
+                    initCamera()
+                }
+
+                is ScanQrState.QrCodeCaptured -> renderScanComplete(state)
+                is ScanQrState.NoCameraPermission -> renderNoPermission(state.shouldOpenPhoneSettings)
+            }
+        }
+    }
+
+    private fun renderInitialState() = with(binding) {
+        permissionRequestView.isVisible = false
+        qrInstructionsText.isVisible = true
+        qrPreviewCard.isVisible = false
+        buttonScan.setText(IDR.string.mfid_qr_scan_no_qr_detected)
+        buttonScan.isVisible = true
+        buttonScan.isEnabled = false
+        buttonScan.setOnClickListener {}
+    }
+
+    private fun renderScanComplete(state: ScanQrState.QrCodeCaptured) = with(binding) {
+        val qrCodeValue = state.qrCodeValue
+        qrInstructionsText.isVisible = false
+        qrPreviewCard.isVisible = true
+        qrPreviewText.text = state.qrCodeValue
+        buttonScan.setText(IDR.string.mfid_continue)
+        buttonScan.isEnabled = true
+        buttonScan.setOnClickListener {
+            if (viewModel.isValidQrCodeFormat(qrCodeValue)) {
+                mainViewModel.setExternalCredentialValue(qrCodeValue)
+                findNavController().navigateSafely(
+                    this@ExternalCredentialScanQrFragment,
+                    R.id.action_externalCredentialSelectScanQr_to_externalCredentialSearch
+                )
+            } else {
+                showInvalidQrCodeFormatDialog(
+                    qrCodeValue = qrCodeValue,
+                    onDismiss = {
+                        dismissDialog()
+                        viewModel.updateCapturedValue(null)
+                    }
+                )
+            }
+        }
+    }
+
+    private fun showInvalidQrCodeFormatDialog(
+        qrCodeValue: String,
+        onDismiss: () -> Unit,
+    ) {
+        dismissDialog()
+        dialog = BottomSheetDialog(requireContext()).also {
+            val view = layoutInflater.inflate(R.layout.dialog_qr_wrong_value, null)
+                .also { view ->
+                    val qrValueTextView = view.findViewById<TextView>(R.id.qrValue)
+                    val buttonRescan = view.findViewById<Button>(R.id.buttonRescan)
+                    qrValueTextView.text = qrCodeValue
+                    buttonRescan.setOnClickListener { dismissDialog() }
+                }
+            it.setContentView(view)
+            it.setOnDismissListener { onDismiss() }
+            it.setCancelable(true)
+            it.behavior.state = BottomSheetBehavior.STATE_EXPANDED
+            it.behavior.isDraggable = false
+        }
+        dialog?.show()
+    }
+
+    private fun initCamera() {
+        binding.qrScannerArea.post {
+            if (isCameraInitialized) return@post
+            isCameraInitialized = true
+            startCamera()
+            startAnalyzer()
+        }
+    }
+
+    private fun startAnalyzer() {
+        viewLifecycleOwner.lifecycleScope.launch {
+            viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.RESUMED) {
+                qrCodeAnalyzer.scannedCode
+                    .catch { e ->
+                        Simber.e("Camera not available for QR scanning", e, tag = crashReportTag)
+                        Toast.makeText(requireActivity(), "No camera", Toast.LENGTH_LONG).show()
+                    }.collectLatest { qrCode ->
+                        viewModel.updateCapturedValue(qrCode)
+                    }
+            }
+        }
+    }
+
+    private fun startCamera() {
+        val cropConfig = getCropConfig()
+        qrCodeAnalyzer = qrCodeAnalyzerFactory.create(cropConfig = cropConfig, crashReportTag = crashReportTag)
+
+        cameraHelper.startCamera(
+            viewLifecycleOwner,
+            binding.qrScannerPreview,
+            qrCodeAnalyzer,
+        ) {
+            Toast.makeText(requireActivity(), "No Camera available", Toast.LENGTH_LONG).show()
+        }
+    }
+
+    private fun getCropConfig(): QrCodeAnalyzer.CropConfig = with(binding) {
+        val qrScannerArea = Rect(
+            qrScannerArea.left,
+            qrScannerArea.top,
+            qrScannerArea.right,
+            qrScannerArea.bottom
+        )
+        val orientation = resources.configuration.orientation
+        val previewWidth = qrScannerPreview.width
+        val previewHeight = qrScannerPreview.height
+        return QrCodeAnalyzer.CropConfig(
+            rect = qrScannerArea,
+            orientation = orientation,
+            rootViewWidth = previewWidth,
+            rootViewHeight = previewHeight
+        )
+    }
+
+    private fun renderNoPermission(shouldOpenPhoneSettings: Boolean) = with(binding) {
+        qrInstructionsText.isVisible = false
+        buttonScan.isVisible = false
+        if (shouldOpenPhoneSettings) {
+            permissionRequestView.init(
+                title = IDR.string.face_capture_permission_denied,
+                body = IDR.string.login_qr_code_scanning_camera_permission_error,
+                buttonText = IDR.string.fingerprint_connect_phone_settings_button,
+                onClickListener = {
+                    requireActivity().startActivity(
+                        Intent(
+                            Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
+                            "package:${requireActivity().packageName}".toUri(),
+                        ),
+                    )
+                }
+            )
+        } else {
+            permissionRequestView.init(
+                title = IDR.string.face_capture_permission_denied,
+                body = IDR.string.login_qr_code_scanning_camera_permission_error,
+                buttonText = IDR.string.face_capture_permission_action,
+                onClickListener = {
+                    launchPermissionRequest.launch(CAMERA)
+                }
+            )
+        }
+        permissionRequestView.isVisible = true
+    }
 }
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModel.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModel.kt
new file mode 100644
index 0000000000..8cfda721fa
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModel.kt
@@ -0,0 +1,46 @@
+package com.simprints.feature.externalcredential.screens.scanqr
+
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import androidx.lifecycle.ViewModel
+import com.simprints.core.domain.permission.PermissionStatus
+import com.simprints.feature.externalcredential.screens.scanqr.usecase.ExternalCredentialQrCodeValidatorUseCase
+import dagger.hilt.android.lifecycle.HiltViewModel
+import javax.inject.Inject
+
+@HiltViewModel
+internal class ExternalCredentialScanQrViewModel @Inject constructor(
+    private val externalCredentialQrCodeValidator: ExternalCredentialQrCodeValidatorUseCase
+) : ViewModel() {
+
+    private var state: ScanQrState = ScanQrState.ReadyToScan
+        set(value) {
+            field = value
+            _stateLiveData.postValue(value)
+        }
+    private val _stateLiveData = MutableLiveData<ScanQrState>(ScanQrState.ReadyToScan)
+    val stateLiveData: LiveData<ScanQrState> = _stateLiveData
+
+    private fun updateState(state: (ScanQrState) -> ScanQrState) {
+        this.state = state(this.state)
+    }
+
+    fun updateCapturedValue(value: String?) {
+        val newState = when (value) {
+            null -> ScanQrState.ReadyToScan
+            else -> ScanQrState.QrCodeCaptured(value)
+        }
+        updateState { newState }
+    }
+
+    fun updateCameraPermissionStatus(permissionStatus: PermissionStatus) {
+        val newState = when (permissionStatus) {
+            PermissionStatus.Granted -> ScanQrState.ReadyToScan
+            PermissionStatus.Denied -> ScanQrState.NoCameraPermission(shouldOpenPhoneSettings = false)
+            PermissionStatus.DeniedNeverAskAgain -> ScanQrState.NoCameraPermission(shouldOpenPhoneSettings = true)
+        }
+        updateState { newState }
+    }
+
+    fun isValidQrCodeFormat(qrCodeValue: String): Boolean = externalCredentialQrCodeValidator(qrCodeValue)
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ScanQrState.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ScanQrState.kt
new file mode 100644
index 0000000000..dee0423d5e
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/ScanQrState.kt
@@ -0,0 +1,13 @@
+package com.simprints.feature.externalcredential.screens.scanqr
+
+sealed class ScanQrState {
+    data object ReadyToScan : ScanQrState()
+
+    data class NoCameraPermission(
+        val shouldOpenPhoneSettings: Boolean
+    ) : ScanQrState()
+
+    data class QrCodeCaptured(
+        val qrCodeValue: String
+    ) : ScanQrState()
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/usecase/ExternalCredentialQrCodeValidatorUseCase.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/usecase/ExternalCredentialQrCodeValidatorUseCase.kt
new file mode 100644
index 0000000000..b0b6438da4
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/usecase/ExternalCredentialQrCodeValidatorUseCase.kt
@@ -0,0 +1,17 @@
+package com.simprints.feature.externalcredential.screens.scanqr.usecase
+
+import javax.inject.Inject
+
+internal class ExternalCredentialQrCodeValidatorUseCase @Inject constructor() {
+    /**
+     * Checks whether the scanned QR code value is valid to be used in the Multi-Factor ID. Currently, it uses hardcoded values.
+     * In future, the validity criteria should be passed from the project configuration.
+     */
+    operator fun invoke(qrCodeValue: String): Boolean {
+        return qrCodeValue.length == QR_CODE_LENGTH
+    }
+
+    companion object {
+        private const val QR_CODE_LENGTH = 6
+    }
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/view/QrScannerOverlay.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/view/QrScannerOverlay.kt
new file mode 100644
index 0000000000..80dfcff514
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/scanqr/view/QrScannerOverlay.kt
@@ -0,0 +1,44 @@
+package com.simprints.feature.externalcredential.screens.scanqr.view
+
+import android.content.Context
+import android.graphics.Canvas
+import android.graphics.Paint
+import android.graphics.PorterDuff
+import android.graphics.PorterDuffXfermode
+import android.graphics.Rect
+import android.util.AttributeSet
+import android.view.View
+import android.view.ViewGroup
+import androidx.core.content.ContextCompat
+import com.simprints.feature.externalcredential.R
+import com.simprints.infra.uibase.annotations.ExcludedFromGeneratedTestCoverageReports
+import com.simprints.infra.resources.R as IDR
+
+@ExcludedFromGeneratedTestCoverageReports("UI Code")
+internal class QrScannerOverlay(context: Context, attrs: AttributeSet? = null) : View(context, attrs) {
+    private val bgPaint = Paint().apply {
+        color = ContextCompat.getColor(context, IDR.color.simprints_black)
+    }
+    private val clearPaint = Paint().apply { xfermode = PorterDuffXfermode(PorterDuff.Mode.CLEAR) }
+    private val rect = Rect()
+
+    override fun onDraw(canvas: Canvas) {
+        super.onDraw(canvas)
+        (parent as ViewGroup).findViewById<View>(R.id.qrScannerArea)?.let { qrScannerArea ->
+            canvas.drawRect(0f, 0f, width.toFloat(), height.toFloat(), bgPaint)
+
+            // geting rect in this view’s coordinates
+            rect.setEmpty()
+            qrScannerArea.getGlobalVisibleRect(rect)
+            val offset = IntArray(2)
+            getLocationOnScreen(offset)
+            rect.offset(-offset[0], -offset[1])
+
+            // shrink each side so that QR code area indicators and at the top
+            val inset = (8 * resources.displayMetrics.density).toInt()
+            rect.inset(inset, inset)
+
+            canvas.drawRect(rect, clearPaint)
+        }
+    }
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectFragment.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectFragment.kt
index ffd14f1e37..c449cbc0e2 100644
--- a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectFragment.kt
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectFragment.kt
@@ -1,9 +1,160 @@
 package com.simprints.feature.externalcredential.screens.select
 
+import android.app.Dialog
+import android.os.Bundle
+import android.view.View
+import android.widget.Button
+import android.widget.TextView
 import androidx.fragment.app.Fragment
+import androidx.fragment.app.activityViewModels
+import androidx.fragment.app.viewModels
+import androidx.navigation.fragment.findNavController
+import androidx.recyclerview.widget.LinearLayoutManager
+import com.google.android.material.bottomsheet.BottomSheetBehavior
+import com.google.android.material.bottomsheet.BottomSheetDialog
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
 import com.simprints.feature.externalcredential.R
+import com.simprints.feature.externalcredential.databinding.FragmentExternalCredentialSelectBinding
+import com.simprints.feature.externalcredential.ext.getQuantityCredentialString
+import com.simprints.feature.externalcredential.screens.controller.ExternalCredentialViewModel
+import com.simprints.feature.externalcredential.screens.select.view.ExternalCredentialTypeAdapter
+import com.simprints.infra.logging.LoggingConstants.CrashReportTag.ORCHESTRATION
+import com.simprints.infra.logging.Simber
+import com.simprints.infra.uibase.navigation.navigateSafely
+import com.simprints.infra.uibase.view.applySystemBarInsets
+import com.simprints.infra.uibase.viewbinding.viewBinding
 import dagger.hilt.android.AndroidEntryPoint
+import com.simprints.infra.resources.R as IDR
 
 @AndroidEntryPoint
 internal class ExternalCredentialSelectFragment : Fragment(R.layout.fragment_external_credential_select) {
+
+    private val mainViewModel: ExternalCredentialViewModel by activityViewModels()
+    private val viewModel by viewModels<ExternalCredentialSelectViewModel>()
+    private val binding by viewBinding(FragmentExternalCredentialSelectBinding::bind)
+
+    private var dialog: Dialog? = null
+
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+        applySystemBarInsets(view)
+        Simber.i("ExternalCredentialSelectFragment started", tag = ORCHESTRATION)
+
+        observeChanges()
+        viewModel.loadExternalCredentials()
+    }
+
+    override fun onDestroy() {
+        dismissDialog()
+        super.onDestroy()
+    }
+
+    private fun dismissDialog() {
+        dialog?.dismiss()
+        dialog = null
+    }
+
+    private fun initListeners(types: List<ExternalCredentialType>) {
+        binding.skipScanning.setOnClickListener {
+            displaySkipScanningConfirmationDialog(
+                credentialTypes = types,
+                onConfirm = {
+                    dismissDialog()
+                    findNavController().navigateSafely(
+                        this,
+                        ExternalCredentialSelectFragmentDirections.actionExternalCredentialSelectFragmentToExternalCredentialSkip(),
+                    )
+                },
+                onCancel = ::dismissDialog
+            )
+        }
+    }
+
+    private fun initViews(types: List<ExternalCredentialType>) {
+        binding.title.text = resources.getQuantityCredentialString(
+            id = IDR.plurals.mfid_scan_action,
+            specificCredentialRes = mainViewModel.mapTypeToStringResource(types.firstOrNull()),
+            multipleCredentialsRes = IDR.string.mfid_type_any_document,
+            credentialTypes = types,
+        )
+    }
+
+    private fun observeChanges() {
+        viewModel.externalCredentialTypes.observe(viewLifecycleOwner) { externalCredentialTypes ->
+            updateSelectedCredentialType(null)
+            fillRecyclerView(externalCredentialTypes)
+            initViews(externalCredentialTypes)
+            initListeners(externalCredentialTypes)
+        }
+    }
+
+    private fun fillRecyclerView(types: List<ExternalCredentialType>) {
+        with(binding.documentsRecyclerView) {
+            layoutManager = LinearLayoutManager(requireContext())
+            adapter = ExternalCredentialTypeAdapter(types) { selectedType ->
+                updateSelectedCredentialType(selectedType)
+                navigateToScanner(selectedType)
+            }
+        }
+    }
+
+    private fun updateSelectedCredentialType(type: ExternalCredentialType?) {
+        mainViewModel.setSelectedExternalCredentialType(type)
+    }
+
+    private fun navigateToScanner(type: ExternalCredentialType) {
+        when (type) {
+            ExternalCredentialType.NHISCard -> startOcr()
+            ExternalCredentialType.GhanaIdCard -> startOcr()
+            ExternalCredentialType.QRCode -> startQrScan()
+        }
+    }
+
+    private fun startQrScan() {
+        findNavController().navigateSafely(
+            this,
+            ExternalCredentialSelectFragmentDirections.actionExternalCredentialSelectFragmentToExternalCredentialScanQr(),
+        )
+    }
+
+    private fun displaySkipScanningConfirmationDialog(
+        credentialTypes: List<ExternalCredentialType>,
+        onConfirm: () -> Unit,
+        onCancel: () -> Unit
+    ) {
+        dismissDialog()
+        dialog = BottomSheetDialog(requireContext()).also {
+            val view = layoutInflater.inflate(R.layout.dialog_skip_scan_confirm, null)
+                .also { view ->
+                    val bodyText = view.findViewById<TextView>(R.id.skipDialogBodyText)
+                    val cancelButton = view.findViewById<Button>(R.id.buttonCancel)
+                    val confirmButton = view.findViewById<Button>(R.id.buttonSkip)
+
+                    bodyText.text = resources.getQuantityCredentialString(
+                        id = IDR.plurals.mfid_dialog_skip_scan_body,
+                        credentialTypes = credentialTypes,
+                        specificCredentialRes = mainViewModel.mapTypeToStringResource(credentialTypes.firstOrNull()),
+                        multipleCredentialsRes = IDR.string.mfid_type_any_document
+                    )
+
+                    confirmButton.setOnClickListener { onConfirm() }
+                    cancelButton.setOnClickListener { onCancel() }
+                }
+            it.setContentView(view)
+            it.setCancelable(true)
+            it.behavior.state = BottomSheetBehavior.STATE_EXPANDED
+            it.behavior.isDraggable = false
+        }
+
+        dialog?.show()
+    }
+
+    private fun startOcr() {
+        // TODO [MS-1163] add OCR parameters to navigation once the OCR fragment is implemented
+        findNavController().navigateSafely(
+            this,
+            ExternalCredentialSelectFragmentDirections.actionExternalCredentialSelectFragmentToExternalCredentialScanOcr(),
+        )
+    }
+
 }
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModel.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModel.kt
new file mode 100644
index 0000000000..49afb2557c
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModel.kt
@@ -0,0 +1,29 @@
+package com.simprints.feature.externalcredential.screens.select
+
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+import com.simprints.infra.config.sync.ConfigManager
+import dagger.hilt.android.lifecycle.HiltViewModel
+import kotlinx.coroutines.launch
+import javax.inject.Inject
+
+@HiltViewModel
+internal class ExternalCredentialSelectViewModel @Inject internal constructor(
+    private val configManager: ConfigManager,
+) : ViewModel() {
+
+    val externalCredentialTypes: LiveData<List<ExternalCredentialType>>
+        get() = _externalCredentialTypes
+    private val _externalCredentialTypes = MutableLiveData<List<ExternalCredentialType>>()
+
+    fun loadExternalCredentials() {
+        viewModelScope.launch {
+            val config = configManager.getProjectConfiguration()
+            val allowedExternalCredentials = config.multifactorId?.allowedExternalCredentials.orEmpty()
+            _externalCredentialTypes.postValue(allowedExternalCredentials)
+        }
+    }
+}
diff --git a/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/view/ExternalCredentialTypeAdapter.kt b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/view/ExternalCredentialTypeAdapter.kt
new file mode 100644
index 0000000000..439ac80fb8
--- /dev/null
+++ b/feature/external-credential/src/main/java/com/simprints/feature/externalcredential/screens/select/view/ExternalCredentialTypeAdapter.kt
@@ -0,0 +1,48 @@
+package com.simprints.feature.externalcredential.screens.select.view
+
+import android.view.LayoutInflater
+import android.view.ViewGroup
+import androidx.recyclerview.widget.RecyclerView
+import com.simprints.core.ExcludedFromGeneratedTestCoverageReports
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+import com.simprints.feature.externalcredential.R
+import com.simprints.feature.externalcredential.databinding.ItemDocumentBinding
+import com.simprints.infra.resources.R as IDR
+
+@ExcludedFromGeneratedTestCoverageReports("UI classes are not unit tested")
+internal class ExternalCredentialTypeAdapter(
+    private val items: List<ExternalCredentialType>,
+    private val onClick: (ExternalCredentialType) -> Unit = {}
+) : RecyclerView.Adapter<ExternalCredentialTypeAdapter.ViewHolder>() {
+    override fun onCreateViewHolder(
+        parent: ViewGroup,
+        viewType: Int
+    ): ViewHolder = ViewHolder(ItemDocumentBinding.inflate(LayoutInflater.from(parent.context), parent, false))
+
+    override fun onBindViewHolder(
+        holder: ViewHolder,
+        position: Int
+    ) = holder.bind(items[position])
+
+    override fun getItemCount(): Int = items.size
+
+    inner class ViewHolder(private val binding: ItemDocumentBinding) : RecyclerView.ViewHolder(binding.root) {
+        fun bind(credentialType: ExternalCredentialType) {
+            val c = binding.root.context
+            val credentialTypeText = when (credentialType) {
+                ExternalCredentialType.NHISCard -> IDR.string.mfid_type_nhis_card
+                ExternalCredentialType.GhanaIdCard -> IDR.string.mfid_type_ghana_id_card
+                ExternalCredentialType.QRCode -> IDR.string.mfid_type_qr_code
+            }.run(c::getString)
+            val text = c.resources.getQuantityString(IDR.plurals.mfid_scan_action, 1, credentialTypeText)
+            val image = when (credentialType) {
+                ExternalCredentialType.NHISCard -> R.drawable.ghana_nhis_card
+                ExternalCredentialType.GhanaIdCard -> R.drawable.ghana_id_card
+                ExternalCredentialType.QRCode -> R.drawable.qr_code
+            }
+            binding.documentText.text = text
+            binding.documentImage.setImageResource(image)
+            binding.root.setOnClickListener { onClick(credentialType) }
+        }
+    }
+}
diff --git a/feature/external-credential/src/main/res/drawable/ghana_id_card.webp b/feature/external-credential/src/main/res/drawable/ghana_id_card.webp
new file mode 100644
index 0000000000..8a11e2f71a
Binary files /dev/null and b/feature/external-credential/src/main/res/drawable/ghana_id_card.webp differ
diff --git a/feature/external-credential/src/main/res/drawable/ghana_nhis_card.webp b/feature/external-credential/src/main/res/drawable/ghana_nhis_card.webp
new file mode 100644
index 0000000000..935711129b
Binary files /dev/null and b/feature/external-credential/src/main/res/drawable/ghana_nhis_card.webp differ
diff --git a/feature/external-credential/src/main/res/drawable/ic_camera_focus_blue.xml b/feature/external-credential/src/main/res/drawable/ic_camera_focus_blue.xml
new file mode 100644
index 0000000000..d58e25d265
--- /dev/null
+++ b/feature/external-credential/src/main/res/drawable/ic_camera_focus_blue.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector android:height="200dp" android:viewportHeight="120"
+    android:viewportWidth="120" android:width="200dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M0,0l4,0l0,30l-4,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M0,0l40,0l0,4l-40,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M0,0l4,0l0,40l-4,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M80,0l40,0l0,4l-40,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M116,0l4,0l0,40l-4,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M0,80l4,0l0,40l-4,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M0,116l40,0l0,4l-40,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M80,116l40,0l0,4l-40,0z"/>
+    <path android:fillColor="@color/simprints_blue"
+        android:pathData="M116,80l4,0l0,36l-4,0z"/>
+</vector>
diff --git a/feature/external-credential/src/main/res/drawable/qr_code.webp b/feature/external-credential/src/main/res/drawable/qr_code.webp
new file mode 100644
index 0000000000..06c8c08dba
Binary files /dev/null and b/feature/external-credential/src/main/res/drawable/qr_code.webp differ
diff --git a/feature/external-credential/src/main/res/layout-land/item_document.xml b/feature/external-credential/src/main/res/layout-land/item_document.xml
new file mode 100644
index 0000000000..609501feb9
--- /dev/null
+++ b/feature/external-credential/src/main/res/layout-land/item_document.xml
@@ -0,0 +1,41 @@
+<com.google.android.material.card.MaterialCardView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="@color/simprints_white"
+    android:elevation="@dimen/cardview_default_elevation"
+    app:cardUseCompatPadding="true">
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <ImageView
+            android:id="@+id/documentImage"
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:elevation="4dp"
+            android:scaleType="centerCrop"
+            android:src="@drawable/ghana_nhis_card"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintDimensionRatio="H,16:10"
+            app:layout_constraintEnd_toStartOf="@id/documentText"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent"
+            app:layout_constraintWidth_percent="0.3" />
+
+        <TextView
+            android:id="@+id/documentText"
+            style="@style/Text.Body2"
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:gravity="center"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toEndOf="@id/documentImage"
+            app:layout_constraintTop_toTopOf="parent"
+            tools:text="Scan this document" />
+
+    </androidx.constraintlayout.widget.ConstraintLayout>
+</com.google.android.material.card.MaterialCardView>
diff --git a/feature/external-credential/src/main/res/layout/dialog_qr_wrong_value.xml b/feature/external-credential/src/main/res/layout/dialog_qr_wrong_value.xml
new file mode 100644
index 0000000000..f960d726df
--- /dev/null
+++ b/feature/external-credential/src/main/res/layout/dialog_qr_wrong_value.xml
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:clipToPadding="false"
+    android:fillViewport="true"
+    android:padding="@dimen/margin_large">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical">
+
+
+        <LinearLayout
+            android:id="@+id/titleLayout"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent">
+
+            <TextView
+                style="@style/Text.Headline5"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/mfid_dialog_wrong_qr_title" />
+
+            <View
+                android:layout_width="match_parent"
+                android:layout_height="1dp"
+                android:layout_marginVertical="@dimen/margin_large"
+                android:background="@color/simprints_grey_light" />
+
+            <TextView
+                style="@style/Text.Body1"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/mfid_dialog_wrong_qr_body_top" />
+
+            <TextView
+                android:id="@+id/qrValue"
+                style="@style/Text.Subtitle1.Bold"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:gravity="center"
+                android:paddingVertical="@dimen/padding_default"
+                tools:text="WRONG-QR-VALUE" />
+
+            <TextView
+                style="@style/Text.Body1"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/mfid_dialog_wrong_qr_body_bottom" />
+
+
+        </LinearLayout>
+
+        <Button
+            android:id="@+id/buttonRescan"
+            style="@style/Widget.Simprints.Button.Blue"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="@dimen/margin_large"
+            android:text="@string/mfid_dialog_wrong_qr_rescan" />
+    </LinearLayout>
+</ScrollView>
diff --git a/feature/external-credential/src/main/res/layout/dialog_skip_scan_confirm.xml b/feature/external-credential/src/main/res/layout/dialog_skip_scan_confirm.xml
new file mode 100644
index 0000000000..77ff066c46
--- /dev/null
+++ b/feature/external-credential/src/main/res/layout/dialog_skip_scan_confirm.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:clipToPadding="false"
+    android:fillViewport="true"
+    android:padding="@dimen/margin_large">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical">
+
+
+        <LinearLayout
+            android:id="@+id/titleLayout"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent">
+
+            <TextView
+                style="@style/Text.Headline5"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/mfid_dialog_skip_scan_title" />
+
+            <View
+                android:layout_width="match_parent"
+                android:layout_height="1dp"
+                android:layout_marginVertical="@dimen/margin_large"
+                android:background="@color/simprints_grey_light" />
+
+            <TextView
+                android:id="@+id/skipDialogBodyText"
+                style="@style/Text.Body1"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                tools:text="Scanning a document is required by this project. Are you sure you want to skip this step?" />
+
+
+        </LinearLayout>
+
+
+        <Button
+            android:id="@+id/buttonSkip"
+            style="@style/Widget.Simprints.Button.White"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="16dp"
+            android:text="@string/mfid_dialog_skip_scan_confirm"
+            android:textColor="@color/simprints_red" />
+
+        <Button
+            android:id="@+id/buttonCancel"
+            style="@style/Widget.Simprints.Button.Blue"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:text="@string/dashboard_select_modules_confirm_no" />
+    </LinearLayout>
+</ScrollView>
diff --git a/feature/external-credential/src/main/res/layout/fragment_external_credential_scan_qr.xml b/feature/external-credential/src/main/res/layout/fragment_external_credential_scan_qr.xml
index 187f72538b..0c79986a07 100644
--- a/feature/external-credential/src/main/res/layout/fragment_external_credential_scan_qr.xml
+++ b/feature/external-credential/src/main/res/layout/fragment_external_credential_scan_qr.xml
@@ -1,12 +1,88 @@
 <?xml version="1.0" encoding="utf-8"?>
 <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent">
-    <!--TODO [MS-1127] add content-->
-    <TextView
+
+    <androidx.camera.view.PreviewView
+        android:id="@+id/qrScannerPreview"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
-        android:gravity="center"
-        android:text="QR scanner" />
+        tools:visibility="gone" />
+
+    <com.simprints.feature.externalcredential.screens.scanqr.view.QrScannerOverlay
+        android:alpha="0.5"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+
+    <TextView
+        android:id="@+id/qrInstructionsText"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toTopOf="@+id/qrScannerArea"
+        android:text="@string/mfid_qr_scan_instructions"
+        style="@style/Text.Headline5.White"
+        android:layout_margin="@dimen/padding_default"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"/>
+
+    <ImageView
+        android:id="@+id/qrScannerArea"
+        android:layout_width="200dp"
+        android:layout_height="200dp"
+        android:importantForAccessibility="no"
+        android:src="@drawable/ic_camera_focus_blue"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <com.google.android.material.card.MaterialCardView
+        android:id="@+id/qrPreviewCard"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="16dp"
+        android:layout_marginTop="16dp"
+        android:visibility="gone"
+        app:cardBackgroundColor="@color/simprints_blue"
+        app:cardUseCompatPadding="true"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@+id/qrScannerArea"
+        tools:visibility="visible">
+
+        <TextView
+            android:id="@+id/qrPreviewText"
+            style="@style/Text.Body1.White"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_margin="8dp"
+            tools:text="QR_CODE" />
+    </com.google.android.material.card.MaterialCardView>
+
+    <Button
+        android:id="@+id/buttonScan"
+        style="@style/Widget.Simprints.Button.Blue"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="16dp"
+        android:layout_marginBottom="16dp"
+        android:enabled="false"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        tools:text="No QR code detected" />
 
+    <com.simprints.infra.view.PermissionRequestView
+        android:id="@+id/permissionRequestView"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_margin="@dimen/margin_large"
+        android:visibility="gone"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent"
+        tools:visibility="gone" />
 </androidx.constraintlayout.widget.ConstraintLayout>
diff --git a/feature/external-credential/src/main/res/layout/fragment_external_credential_select.xml b/feature/external-credential/src/main/res/layout/fragment_external_credential_select.xml
index fc81eec866..cc35c6b141 100644
--- a/feature/external-credential/src/main/res/layout/fragment_external_credential_select.xml
+++ b/feature/external-credential/src/main/res/layout/fragment_external_credential_select.xml
@@ -1,13 +1,55 @@
 <?xml version="1.0" encoding="utf-8"?>
 <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
-    android:layout_height="match_parent">
+    android:layout_height="match_parent"
+    android:background="@color/simprints_blue">
 
-    <!--TODO [MS-1127] add content-->
     <TextView
-        android:text="Credential Selection fragment"
+        android:id="@+id/title"
+        style="@style/Text.Headline5.White.Bold"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
         android:gravity="center"
-        android:layout_width="match_parent"
-        android:layout_height="match_parent"/>
+        android:padding="@dimen/padding_default"
+        tools:text="Scan a document"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <FrameLayout
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        app:layout_constraintBottom_toTopOf="@id/skipScanning"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/title">
+
+        <androidx.recyclerview.widget.RecyclerView
+            android:id="@+id/documentsRecyclerView"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_gravity="center"
+            android:clipToPadding="false"
+            android:paddingHorizontal="14dp"
+            tools:itemCount="3"
+            tools:listitem="@layout/item_document" />
+    </FrameLayout>
+
+    <TextView
+        android:id="@+id/skipScanning"
+        style="@style/Text.Body2.White"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:background="?attr/selectableItemBackground"
+        android:clickable="true"
+        android:focusable="true"
+        android:gravity="center"
+        android:padding="@dimen/padding_default"
+        android:text="@string/mfid_scanner_selection_skip"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent" />
 
 </androidx.constraintlayout.widget.ConstraintLayout>
diff --git a/feature/external-credential/src/main/res/layout/item_document.xml b/feature/external-credential/src/main/res/layout/item_document.xml
new file mode 100644
index 0000000000..1a4434cc43
--- /dev/null
+++ b/feature/external-credential/src/main/res/layout/item_document.xml
@@ -0,0 +1,41 @@
+<com.google.android.material.card.MaterialCardView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="@color/simprints_white"
+    android:elevation="@dimen/cardview_default_elevation"
+    app:cardUseCompatPadding="true">
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <ImageView
+            android:id="@+id/documentImage"
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:elevation="4dp"
+            android:scaleType="centerCrop"
+            tools:src="@drawable/ghana_nhis_card"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintDimensionRatio="H,16:10"
+            app:layout_constraintEnd_toStartOf="@id/documentText"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent"
+            app:layout_constraintWidth_percent="0.5" />
+
+        <TextView
+            android:id="@+id/documentText"
+            style="@style/Text.Body2"
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:gravity="center"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toEndOf="@id/documentImage"
+            app:layout_constraintTop_toTopOf="parent"
+            tools:text="Scan this document" />
+
+    </androidx.constraintlayout.widget.ConstraintLayout>
+</com.google.android.material.card.MaterialCardView>
diff --git a/feature/external-credential/src/main/res/navigation/graph_external_credential.xml b/feature/external-credential/src/main/res/navigation/graph_external_credential.xml
index 1d0865429c..4f18491e1c 100644
--- a/feature/external-credential/src/main/res/navigation/graph_external_credential.xml
+++ b/feature/external-credential/src/main/res/navigation/graph_external_credential.xml
@@ -9,8 +9,8 @@
         android:name="com.simprints.feature.externalcredential.screens.controller.ExternalCredentialControllerFragment"
         android:label="ExternalCredentialController">
         <argument
-            android:name="externalCredentialParams"
-            app:argType="com.simprints.feature.externalcredential.model.ExternalCredentialParams" />
+            android:name="params"
+            app:argType="com.simprints.core.domain.step.StepParams"/>
     </fragment>
 
     <include app:graph="@navigation/graph_exit_form" />
diff --git a/feature/external-credential/src/main/res/navigation/graph_external_credential_internal.xml b/feature/external-credential/src/main/res/navigation/graph_external_credential_internal.xml
index 0e988e1024..57d59c1522 100644
--- a/feature/external-credential/src/main/res/navigation/graph_external_credential_internal.xml
+++ b/feature/external-credential/src/main/res/navigation/graph_external_credential_internal.xml
@@ -12,19 +12,13 @@
         tools:layout="@layout/fragment_external_credential_select">
         <action
             android:id="@+id/action_externalCredentialSelectFragment_to_externalCredentialScanQr"
-            app:destination="@+id/externalCredentialScanQr"
-            app:popUpTo="@+id/graph_external_credential_internal"
-            app:popUpToInclusive="true" />
+            app:destination="@+id/externalCredentialScanQr" />
         <action
             android:id="@+id/action_externalCredentialSelectFragment_to_externalCredentialScanOcr"
-            app:destination="@+id/externalCredentialScanOcr"
-            app:popUpTo="@+id/graph_external_credential_internal"
-            app:popUpToInclusive="true" />
+            app:destination="@+id/externalCredentialScanOcr" />
         <action
             android:id="@+id/action_externalCredentialSelectFragment_to_externalCredentialSkip"
-            app:destination="@+id/externalCredentialSkip"
-            app:popUpTo="@+id/graph_external_credential_internal"
-            app:popUpToInclusive="true" />
+            app:destination="@+id/externalCredentialSkip" />
     </fragment>
 
     <fragment
@@ -32,28 +26,30 @@
         android:name="com.simprints.feature.externalcredential.screens.scanqr.ExternalCredentialScanQrFragment"
         android:label="ExternalCredentialScanQrFragment"
         tools:layout="@layout/fragment_external_credential_scan_qr">
+        <action
+            android:id="@+id/action_externalCredentialSelectScanQr_to_externalCredentialSearch"
+            app:destination="@+id/externalCredentialSearch"
+            app:popUpTo="@+id/graph_external_credential_internal"
+            app:popUpToInclusive="true" />
     </fragment>
 
     <fragment
         android:id="@+id/externalCredentialSearch"
         android:name="com.simprints.feature.externalcredential.screens.search.ExternalCredentialSearchFragment"
         android:label="ExternalCredentialSearchFragment"
-        tools:layout="@layout/fragment_external_credential_search">
-    </fragment>
+        tools:layout="@layout/fragment_external_credential_search"/>
 
     <fragment
         android:id="@+id/externalCredentialScanOcr"
         android:name="com.simprints.feature.externalcredential.screens.scanocr.ExternalCredentialScanOcrFragment"
         android:label="ExternalCredentialScanOcrFragment"
-        tools:layout="@layout/fragment_external_credential_scan_ocr">
-    </fragment>
+        tools:layout="@layout/fragment_external_credential_scan_ocr"/>
 
     <fragment
         android:id="@+id/externalCredentialSkip"
         android:name="com.simprints.feature.externalcredential.screens.skip.ExternalCredentialSkipFragment"
         android:label="ExternalCredentialSkipFragment"
-        tools:layout="@layout/fragment_external_credential_skip">
-    </fragment>
+        tools:layout="@layout/fragment_external_credential_skip"/>
 
     <action
         android:id="@+id/action_global_external_credential_select"
diff --git a/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModelTest.kt b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModelTest.kt
new file mode 100644
index 0000000000..21eb7e33d0
--- /dev/null
+++ b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/controller/ExternalCredentialViewModelTest.kt
@@ -0,0 +1,86 @@
+package com.simprints.feature.externalcredential.screens.controller
+
+import androidx.arch.core.executor.testing.InstantTaskExecutorRule
+import com.google.common.truth.Truth.assertThat
+import com.jraska.livedata.test
+import com.simprints.core.domain.common.FlowType
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+import com.simprints.feature.externalcredential.model.ExternalCredentialParams
+import com.simprints.infra.resources.R as IDR
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+
+internal class ExternalCredentialViewModelTest {
+
+    @get:Rule
+    val rule = InstantTaskExecutorRule()
+
+    private lateinit var viewModel: ExternalCredentialViewModel
+
+    @Before
+    fun setUp() {
+        viewModel = ExternalCredentialViewModel()
+    }
+
+    @Test
+    fun `initial state is EMPTY`() {
+        val observer = viewModel.stateLiveData.test()
+        assertThat(observer.value()).isEqualTo(ExternalCredentialState.EMPTY)
+    }
+
+    @Test
+    fun `setSelectedExternalCredentialType updates state`() {
+        val observer = viewModel.stateLiveData.test()
+
+        viewModel.setSelectedExternalCredentialType(ExternalCredentialType.GhanaIdCard)
+
+        assertThat(observer.value()?.selectedType).isEqualTo(ExternalCredentialType.GhanaIdCard)
+    }
+
+    @Test
+    fun `setSelectedExternalCredentialType null resets state`() {
+        val observer = viewModel.stateLiveData.test()
+
+        viewModel.setSelectedExternalCredentialType(null)
+
+        assertThat(observer.value()?.selectedType).isNull()
+    }
+
+    @Test
+    fun `mapTypeToStringResource returns correct string ids`() {
+        assertThat(viewModel.mapTypeToStringResource(ExternalCredentialType.NHISCard))
+            .isEqualTo(IDR.string.mfid_type_nhis_card)
+        assertThat(viewModel.mapTypeToStringResource(ExternalCredentialType.GhanaIdCard))
+            .isEqualTo(IDR.string.mfid_type_ghana_id_card)
+        assertThat(viewModel.mapTypeToStringResource(ExternalCredentialType.QRCode))
+            .isEqualTo(IDR.string.mfid_type_qr_code)
+    }
+
+    @Test
+    fun `setExternalCredentialValue updates state`() {
+        val observer = viewModel.stateLiveData.test()
+        val value = "value"
+        viewModel.setExternalCredentialValue(value)
+        assertThat(observer.value()?.credentialValue).isEqualTo(value)
+    }
+
+    @Test
+    fun `init sets state only once`() {
+        val observer = viewModel.stateLiveData.test()
+        val subjectId = "subjectId"
+        val flowType = FlowType.IDENTIFY
+        val params = ExternalCredentialParams(subjectId = subjectId, flowType = flowType)
+        val paramsSecond = ExternalCredentialParams(subjectId = "other", flowType = FlowType.VERIFY)
+
+        viewModel.init(params)
+        val firstState = observer.value()
+
+        viewModel.init(paramsSecond)
+
+        assertThat(observer.value()).isEqualTo(firstState)
+        assertThat(observer.value()?.subjectId).isEqualTo(subjectId)
+        assertThat(observer.value()?.flowType).isEqualTo(flowType)
+    }
+
+}
diff --git a/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModelTest.kt b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModelTest.kt
new file mode 100644
index 0000000000..84f2242b9f
--- /dev/null
+++ b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/scanqr/ExternalCredentialScanQrViewModelTest.kt
@@ -0,0 +1,86 @@
+package com.simprints.feature.externalcredential.screens.scanqr
+
+import androidx.arch.core.executor.testing.InstantTaskExecutorRule
+import com.google.common.truth.Truth.assertThat
+import com.jraska.livedata.test
+import com.simprints.core.domain.permission.PermissionStatus
+import com.simprints.feature.externalcredential.screens.scanqr.usecase.ExternalCredentialQrCodeValidatorUseCase
+import io.mockk.MockKAnnotations
+import io.mockk.every
+import io.mockk.impl.annotations.MockK
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+
+internal class ExternalCredentialScanQrViewModelTest {
+
+    @get:Rule
+    val instantExecutorRule = InstantTaskExecutorRule()
+
+    @MockK
+    private lateinit var validator: ExternalCredentialQrCodeValidatorUseCase
+
+    private lateinit var viewModel: ExternalCredentialScanQrViewModel
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+        viewModel = ExternalCredentialScanQrViewModel(validator)
+    }
+
+    @Test
+    fun `initial state is ReadyToScan`() {
+        val observer = viewModel.stateLiveData.test()
+        assertThat(observer.value()).isEqualTo(ScanQrState.ReadyToScan)
+    }
+
+    @Test
+    fun `updateCapturedValue with null sets ReadyToScan`() {
+        val observer = viewModel.stateLiveData.test()
+        viewModel.updateCapturedValue(null)
+        assertThat(observer.value()).isEqualTo(ScanQrState.ReadyToScan)
+    }
+
+    @Test
+    fun `updateCapturedValue with non-null sets QrCodeCaptured`() {
+        val observer = viewModel.stateLiveData.test()
+        viewModel.updateCapturedValue("captured-value")
+        assertThat(observer.value()).isEqualTo(ScanQrState.QrCodeCaptured("captured-value"))
+    }
+
+    @Test
+    fun `updateCameraPermissionStatus with Granted sets ReadyToScan`() {
+        val observer = viewModel.stateLiveData.test()
+        viewModel.updateCameraPermissionStatus(PermissionStatus.Granted)
+        assertThat(observer.value()).isEqualTo(ScanQrState.ReadyToScan)
+    }
+
+    @Test
+    fun `updateCameraPermissionStatus with Denied sets NoCameraPermission false`() {
+        val observer = viewModel.stateLiveData.test()
+        viewModel.updateCameraPermissionStatus(PermissionStatus.Denied)
+        assertThat(observer.value()).isEqualTo(
+            ScanQrState.NoCameraPermission(shouldOpenPhoneSettings = false)
+        )
+    }
+
+    @Test
+    fun `updateCameraPermissionStatus with DeniedNeverAskAgain sets NoCameraPermission true`() {
+        val observer = viewModel.stateLiveData.test()
+        viewModel.updateCameraPermissionStatus(PermissionStatus.DeniedNeverAskAgain)
+        assertThat(observer.value()).isEqualTo(
+            ScanQrState.NoCameraPermission(shouldOpenPhoneSettings = true)
+        )
+    }
+
+    @Test
+    fun `isValidQrCodeFormat uses validator to validate`() {
+        val validValue = "validValue"
+        val invalidValue = "invalidValue"
+        every { validator.invoke(validValue) } returns true
+        every { validator.invoke(invalidValue) } returns false
+
+        assertThat(viewModel.isValidQrCodeFormat(validValue)).isTrue()
+        assertThat(viewModel.isValidQrCodeFormat(invalidValue)).isFalse()
+    }
+}
diff --git a/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModelTest.kt b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModelTest.kt
new file mode 100644
index 0000000000..50384536b3
--- /dev/null
+++ b/feature/external-credential/src/test/java/com/simprints/feature/externalcredential/screens/select/ExternalCredentialSelectViewModelTest.kt
@@ -0,0 +1,68 @@
+package com.simprints.feature.externalcredential.screens.select
+
+import androidx.arch.core.executor.testing.InstantTaskExecutorRule
+import com.google.common.truth.Truth.assertThat
+import com.jraska.livedata.test
+import com.simprints.core.domain.externalcredential.ExternalCredentialType
+import com.simprints.infra.config.sync.ConfigManager
+import com.simprints.testtools.common.coroutines.TestCoroutineRule
+import io.mockk.MockKAnnotations
+import io.mockk.coEvery
+import io.mockk.every
+import io.mockk.impl.annotations.MockK
+import io.mockk.mockk
+import kotlinx.coroutines.test.runTest
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+
+class ExternalCredentialSelectViewModelTest {
+    @get:Rule
+    val rule = InstantTaskExecutorRule()
+
+    @get:Rule
+    val testCoroutineRule = TestCoroutineRule()
+
+    @MockK
+    private lateinit var configManager: ConfigManager
+
+    private lateinit var viewModel: ExternalCredentialSelectViewModel
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+        viewModel = ExternalCredentialSelectViewModel(configManager)
+    }
+
+    @Test
+    fun `loads allowed external credentials`() = runTest {
+        val expected = listOf(
+            ExternalCredentialType.NHISCard,
+            ExternalCredentialType.GhanaIdCard,
+        )
+        coEvery { configManager.getProjectConfiguration() } returns mockk {
+            every { multifactorId } returns mockk {
+                every { allowedExternalCredentials } returns expected
+            }
+        }
+
+        val observer = viewModel.externalCredentialTypes.test()
+        viewModel.loadExternalCredentials()
+
+        assertThat(observer.value()).isEqualTo(expected)
+    }
+
+    @Test
+    fun `sets empty list if no allowed credentials`() = runTest {
+        coEvery { configManager.getProjectConfiguration() } returns mockk {
+            every { multifactorId } returns mockk {
+                every { allowedExternalCredentials } returns emptyList()
+            }
+        }
+
+        val observer = viewModel.externalCredentialTypes.test()
+        viewModel.loadExternalCredentials()
+
+        assertThat(observer.value()).isEmpty()
+    }
+}
diff --git a/feature/login/src/main/java/com/simprints/feature/login/screens/qrscanner/QrScannerFragment.kt b/feature/login/src/main/java/com/simprints/feature/login/screens/qrscanner/QrScannerFragment.kt
index e66a14293c..c176dccb1e 100644
--- a/feature/login/src/main/java/com/simprints/feature/login/screens/qrscanner/QrScannerFragment.kt
+++ b/feature/login/src/main/java/com/simprints/feature/login/screens/qrscanner/QrScannerFragment.kt
@@ -10,12 +10,12 @@ import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
 import androidx.navigation.fragment.findNavController
-import com.google.firebase.analytics.FirebaseAnalytics.Event.LOGIN
 import com.simprints.core.tools.extentions.hasPermission
 import com.simprints.feature.login.R
 import com.simprints.feature.login.databinding.FragmentQrScannerBinding
-import com.simprints.feature.login.tools.camera.CameraHelper
-import com.simprints.feature.login.tools.camera.QrCodeAnalyzer
+import com.simprints.infra.logging.LoggingConstants
+import com.simprints.infra.uibase.camera.qrscan.CameraHelper
+import com.simprints.infra.uibase.camera.qrscan.QrCodeAnalyzer
 import com.simprints.infra.logging.Simber
 import com.simprints.infra.uibase.view.applySystemBarInsets
 import com.simprints.infra.uibase.navigation.finishWithResult
@@ -29,12 +29,18 @@ import javax.inject.Inject
 @AndroidEntryPoint
 internal class QrScannerFragment : Fragment(R.layout.fragment_qr_scanner) {
     private val binding by viewBinding(FragmentQrScannerBinding::bind)
-
+    private val crashReportTag = LoggingConstants.CrashReportTag.LOGIN
     @Inject
-    lateinit var cameraHelper: CameraHelper
-
+    lateinit var cameraHelperFactory: CameraHelper.Factory
     @Inject
-    lateinit var qrCodeAnalyzer: QrCodeAnalyzer
+    lateinit var qrCodeAnalyzerFactory: QrCodeAnalyzer.Factory
+
+    private val cameraHelper: CameraHelper by lazy {
+        cameraHelperFactory.create(crashReportTag)
+    }
+    private val qrCodeAnalyzer by lazy {
+        qrCodeAnalyzerFactory.create(cropConfig = null, crashReportTag = crashReportTag)
+    }
 
     private val launchPermissionRequest = registerForActivityResult(
         ActivityResultContracts.RequestPermission(),
@@ -57,7 +63,7 @@ internal class QrScannerFragment : Fragment(R.layout.fragment_qr_scanner) {
             viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.RESUMED) {
                 qrCodeAnalyzer.scannedCode
                     .catch { e ->
-                        Simber.e("Camera not available for QR scanning", e, tag = LOGIN)
+                        Simber.e("Camera not available for QR scanning", e, tag = crashReportTag)
                         finishWithError(QrScannerResult.QrScannerError.CameraNotAvailable)
                     }.collectLatest { qrCode ->
                         if (qrCode.isNotEmpty()) {
@@ -75,7 +81,7 @@ internal class QrScannerFragment : Fragment(R.layout.fragment_qr_scanner) {
     }
 
     private fun startCamera() {
-        binding.qrScannerAim.isVisible = true
+        binding.qrScannerArea.isVisible = true
         cameraHelper.startCamera(
             viewLifecycleOwner,
             binding.qrScannerPreview,
diff --git a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzer.kt b/feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzer.kt
deleted file mode 100644
index c1d4c1b798..0000000000
--- a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzer.kt
+++ /dev/null
@@ -1,43 +0,0 @@
-package com.simprints.feature.login.tools.camera
-
-import androidx.camera.core.ExperimentalGetImage
-import androidx.camera.core.ImageAnalysis
-import androidx.camera.core.ImageProxy
-import com.simprints.core.DispatcherBG
-import com.simprints.infra.logging.LoggingConstants.CrashReportTag.LOGIN
-import com.simprints.infra.logging.Simber
-import kotlinx.coroutines.CoroutineDispatcher
-import kotlinx.coroutines.channels.BufferOverflow
-import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.MutableStateFlow
-import kotlinx.coroutines.flow.buffer
-import kotlinx.coroutines.flow.filterNotNull
-import kotlinx.coroutines.runBlocking
-import javax.inject.Inject
-
-internal class QrCodeAnalyzer @Inject constructor(
-    private val qrCodeDetector: QrCodeDetector,
-    @DispatcherBG private val bgDispatcher: CoroutineDispatcher,
-) : ImageAnalysis.Analyzer {
-    private val _scannedCode = MutableStateFlow<String?>(null)
-    val scannedCode: Flow<String> = _scannedCode
-        .filterNotNull()
-        .buffer(1, onBufferOverflow = BufferOverflow.DROP_OLDEST)
-
-    @ExperimentalGetImage
-    override fun analyze(imageProxy: ImageProxy) {
-        imageProxy.use {
-            it.image?.let { mediaImage ->
-                runBlocking(bgDispatcher) {
-                    try {
-                        val rotationDegrees = imageProxy.imageInfo.rotationDegrees
-                        val image = RawImage(mediaImage, rotationDegrees)
-                        qrCodeDetector.detectInImage(image)?.let(_scannedCode::tryEmit)
-                    } catch (t: Throwable) {
-                        Simber.e("QR code detection failed", t, tag = LOGIN)
-                    }
-                }
-            }
-        }
-    }
-}
diff --git a/feature/login/src/main/res/layout/fragment_qr_scanner.xml b/feature/login/src/main/res/layout/fragment_qr_scanner.xml
index 3716676035..3fa0e59bb0 100644
--- a/feature/login/src/main/res/layout/fragment_qr_scanner.xml
+++ b/feature/login/src/main/res/layout/fragment_qr_scanner.xml
@@ -11,7 +11,7 @@
         android:layout_height="match_parent" />
 
     <ImageView
-        android:id="@+id/qrScannerAim"
+        android:id="@+id/qrScannerArea"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:src="@drawable/ic_camera_focus"
diff --git a/feature/login/src/test/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzerTest.kt b/feature/login/src/test/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzerTest.kt
deleted file mode 100644
index bac7e470a6..0000000000
--- a/feature/login/src/test/java/com/simprints/feature/login/tools/camera/QrCodeAnalyzerTest.kt
+++ /dev/null
@@ -1,61 +0,0 @@
-package com.simprints.feature.login.tools.camera
-
-import androidx.camera.core.ImageProxy
-import com.google.common.truth.Truth.assertThat
-import io.mockk.MockKAnnotations
-import io.mockk.coEvery
-import io.mockk.coVerify
-import io.mockk.every
-import io.mockk.impl.annotations.MockK
-import io.mockk.mockk
-import io.mockk.verify
-import kotlinx.coroutines.flow.first
-import kotlinx.coroutines.test.UnconfinedTestDispatcher
-import kotlinx.coroutines.test.runTest
-import org.junit.Before
-import org.junit.Test
-
-internal class QrCodeAnalyzerTest {
-    @MockK
-    lateinit var mockQrCodeDetector: QrCodeDetector
-
-    @MockK
-    lateinit var mockImageProxy: ImageProxy
-
-    private lateinit var qrCodeProducer: QrCodeAnalyzer
-
-    @Before
-    fun setUp() {
-        MockKAnnotations.init(this, relaxed = true)
-
-        qrCodeProducer = QrCodeAnalyzer(mockQrCodeDetector, UnconfinedTestDispatcher())
-    }
-
-    @Test
-    fun `should not trigger detector when no images obtained`() {
-        every { mockImageProxy.image } returns null
-        qrCodeProducer.analyze(mockImageProxy)
-
-        coVerify(exactly = 0) { mockQrCodeDetector.detectInImage(any()) }
-    }
-
-    @Test
-    fun `should send RQ code value to flow`() = runTest {
-        every { mockImageProxy.image } returns mockk()
-        coEvery { mockQrCodeDetector.detectInImage(any()) } returns "mock_value"
-
-        qrCodeProducer.analyze(mockImageProxy)
-        val code = qrCodeProducer.scannedCode.first()
-
-        assertThat(code).isEqualTo("mock_value")
-    }
-
-    @Test
-    fun `should close image proxy with unsuccessful scan`() {
-        coEvery { mockQrCodeDetector.detectInImage(any()) } throws Throwable()
-
-        qrCodeProducer.analyze(mockImageProxy)
-
-        verify { mockImageProxy.close() }
-    }
-}
diff --git a/feature/orchestrator/src/main/java/com/simprints/feature/orchestrator/steps/Step.kt b/feature/orchestrator/src/main/java/com/simprints/feature/orchestrator/steps/Step.kt
index f24eccd8ba..cc3add88ea 100644
--- a/feature/orchestrator/src/main/java/com/simprints/feature/orchestrator/steps/Step.kt
+++ b/feature/orchestrator/src/main/java/com/simprints/feature/orchestrator/steps/Step.kt
@@ -18,6 +18,7 @@ import com.simprints.feature.enrollast.FaceTemplateCaptureResult
 import com.simprints.feature.enrollast.FingerTemplateCaptureResult
 import com.simprints.feature.enrollast.MatchResult
 import com.simprints.feature.exitform.ExitFormResult
+import com.simprints.feature.externalcredential.model.ExternalCredentialParams
 import com.simprints.feature.fetchsubject.FetchSubjectParams
 import com.simprints.feature.fetchsubject.FetchSubjectResult
 import com.simprints.feature.login.LoginParams
@@ -112,6 +113,7 @@ abstract class StepResultMixin : StepResult
         value = EnrolLastBiometricStepResult.FaceCaptureResult::class,
         name = "EnrolLastBiometricStepResult.FaceCaptureResult",
     ),
+    JsonSubTypes.Type(value = ExternalCredentialParams::class, name = "ExternalCredentialParams"),
     JsonSubTypes.Type(value = MatchResult::class, name = "MatchResult"),
     JsonSubTypes.Type(value = FingerTemplateCaptureResult::class, name = "FingerTemplateCaptureResult"),
     JsonSubTypes.Type(value = FaceTemplateCaptureResult::class, name = "FaceTemplateCaptureResult"),
diff --git a/infra/core/src/main/java/com/simprints/core/tools/extentions/Activity.ext.kt b/infra/core/src/main/java/com/simprints/core/tools/extentions/Activity.ext.kt
index ee540d4c59..f0ec9eca95 100644
--- a/infra/core/src/main/java/com/simprints/core/tools/extentions/Activity.ext.kt
+++ b/infra/core/src/main/java/com/simprints/core/tools/extentions/Activity.ext.kt
@@ -39,3 +39,8 @@ fun Activity.permissionFromResult(
         }
     }
 }
+
+@ExcludedFromGeneratedTestCoverageReports("UI code")
+fun Activity.getCurrentPermissionStatus(
+    permission: String,
+): PermissionStatus = permissionFromResult(permission = permission, grantResult = hasPermission(permission))
diff --git a/infra/logging/src/main/java/com/simprints/infra/logging/LoggingConstants.kt b/infra/logging/src/main/java/com/simprints/infra/logging/LoggingConstants.kt
index 9039eb5c8b..852dcaf5ac 100644
--- a/infra/logging/src/main/java/com/simprints/infra/logging/LoggingConstants.kt
+++ b/infra/logging/src/main/java/com/simprints/infra/logging/LoggingConstants.kt
@@ -51,6 +51,7 @@ object LoggingConstants {
         SAMPLE_UPLOAD,
         APPLICATION,
         COMMCARE_SYNC,
+        MULTI_FACTOR_ID,
     }
 
     // Tags eligible for Firebase Analytics logging
diff --git a/infra/resources/src/main/res/values/strings.xml b/infra/resources/src/main/res/values/strings.xml
index 66b290aedb..f094958d98 100644
--- a/infra/resources/src/main/res/values/strings.xml
+++ b/infra/resources/src/main/res/values/strings.xml
@@ -481,4 +481,30 @@
         <item quantity="other">%d years</item>
     </plurals>
 
+    <!-- MultiFactor Identification -->
+    <plurals name="mfid_scan_action">
+        <item quantity="one">Scan %1$s</item>
+        <item quantity="other">Scan %1$s</item>
+    </plurals>
+
+    <string name="mfid_scanner_selection_skip">Skip document scan</string>
+    <string name="mfid_type_nhis_card">NHIS Card</string>
+    <string name="mfid_type_ghana_id_card">Ghana ID Card</string>
+    <string name="mfid_type_qr_code">QR Code</string>
+    <string name="mfid_type_any_document">a document</string>
+    <string name="mfid_dialog_skip_scan_title">Skip scanning?</string>
+
+    <plurals name="mfid_dialog_skip_scan_body">
+        <item quantity="one">Scanning %1$s is required by this project. Are you sure you want to skip this step?</item>
+        <item quantity="other">Scanning %1$s is required by this project. Are you sure you want to skip this step?</item>
+    </plurals>
+
+    <string name="mfid_dialog_skip_scan_confirm">Skip</string>
+    <string name="mfid_qr_scan_no_qr_detected">No QR code detected</string>
+    <string name="mfid_qr_scan_instructions">Place QR code in window</string>
+    <string name="mfid_continue">Continue</string>
+    <string name="mfid_dialog_wrong_qr_title">Invalid QR Code type</string>
+    <string name="mfid_dialog_wrong_qr_body_top">Wrong QR code format is scanned</string>
+    <string name="mfid_dialog_wrong_qr_body_bottom">This value cannot be used as a person document. Please make sure that correct QR code is scanned</string>
+    <string name="mfid_dialog_wrong_qr_rescan">Re-scan</string>
 </resources>
diff --git a/infra/ui-base/build.gradle.kts b/infra/ui-base/build.gradle.kts
index 7053015455..a9ccecb631 100644
--- a/infra/ui-base/build.gradle.kts
+++ b/infra/ui-base/build.gradle.kts
@@ -1,4 +1,5 @@
 plugins {
+    id("simprints.infra")
     id("simprints.android.library")
 }
 
@@ -34,5 +35,11 @@ dependencies {
 
     api(libs.androidX.navigation.fragment)
 
+    api(libs.androidX.cameraX.core)
+    api(libs.androidX.cameraX.lifecycle)
+    api(libs.androidX.cameraX.view)
+    api(libs.jackson.core)
+    api(libs.playServices.barcode)
+
     testImplementation(project(":infra:test-tools"))
 }
diff --git a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraFocusManager.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraFocusManager.kt
similarity index 86%
rename from feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraFocusManager.kt
rename to infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraFocusManager.kt
index bc669fe497..302984baaa 100644
--- a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraFocusManager.kt
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraFocusManager.kt
@@ -1,4 +1,4 @@
-package com.simprints.feature.login.tools.camera
+package com.simprints.infra.uibase.camera.qrscan
 
 import android.annotation.SuppressLint
 import android.view.MotionEvent
@@ -14,15 +14,26 @@ import androidx.camera.core.MeteringPointFactory
 import androidx.camera.core.SurfaceOrientedMeteringPointFactory
 import androidx.camera.view.PreviewView
 import com.simprints.core.ExcludedFromGeneratedTestCoverageReports
+import com.simprints.infra.logging.LoggingConstants
 import com.simprints.infra.logging.LoggingConstants.CrashReportTag.LOGIN
 import com.simprints.infra.logging.Simber
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
 import java.util.concurrent.TimeUnit
 import javax.inject.Inject
 
 @ExcludedFromGeneratedTestCoverageReports(
     reason = "These are UI utilities for focus controls in the camera preview",
 )
-internal class CameraFocusManager @Inject constructor() {
+class CameraFocusManager @AssistedInject constructor(
+    @Assisted private val crashReportTag: LoggingConstants.CrashReportTag,
+) {
+    @AssistedFactory
+    interface Factory {
+        fun create(crashReportTag: LoggingConstants.CrashReportTag): CameraFocusManager
+    }
+
     @SuppressLint("ClickableViewAccessibility")
     fun setUpFocusOnTap(
         cameraPreview: PreviewView,
@@ -52,7 +63,7 @@ internal class CameraFocusManager @Inject constructor() {
                 try {
                     cameraControl.startFocusAndMetering(focusAction)
                 } catch (e: CameraInfoUnavailableException) {
-                    Simber.e("Cannot access camera", e, tag = LOGIN)
+                    Simber.e("Cannot access camera", e, tag = crashReportTag)
                 }
                 true
             }
@@ -78,7 +89,7 @@ internal class CameraFocusManager @Inject constructor() {
             try {
                 camera.cameraControl.startFocusAndMetering(focusAction)
             } catch (e: CameraInfoUnavailableException) {
-                Simber.e("Cannot access camera", e, tag = LOGIN)
+                Simber.e("Cannot access camera", e, tag = crashReportTag)
             }
         }
     }
diff --git a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraHelper.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraHelper.kt
similarity index 82%
rename from feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraHelper.kt
rename to infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraHelper.kt
index bdc7f2430f..aeedfb8e94 100644
--- a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/CameraHelper.kt
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/CameraHelper.kt
@@ -1,4 +1,4 @@
-package com.simprints.feature.login.tools.camera
+package com.simprints.infra.uibase.camera.qrscan
 
 import android.content.Context
 import androidx.camera.core.AspectRatio
@@ -10,8 +10,11 @@ import androidx.camera.view.PreviewView
 import androidx.core.content.ContextCompat
 import androidx.lifecycle.LifecycleOwner
 import com.simprints.core.ExcludedFromGeneratedTestCoverageReports
-import com.simprints.infra.logging.LoggingConstants.CrashReportTag.LOGIN
+import com.simprints.infra.logging.LoggingConstants
 import com.simprints.infra.logging.Simber
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
 import dagger.hilt.android.qualifiers.ApplicationContext
 import java.util.concurrent.Executors
 import javax.inject.Inject
@@ -19,10 +22,18 @@ import javax.inject.Inject
 @ExcludedFromGeneratedTestCoverageReports(
     reason = "This is an injectable wrapper around cameraX and ML kit APIs. There is no business logic.",
 )
-internal class CameraHelper @Inject constructor(
+class CameraHelper @AssistedInject constructor(
     @ApplicationContext private val context: Context,
-    private val cameraFocusManager: CameraFocusManager,
+    @Assisted private val crashReportTag: LoggingConstants.CrashReportTag,
+    private val cameraFocusManagerFactory: CameraFocusManager.Factory,
 ) {
+    private val cameraFocusManager by lazy { cameraFocusManagerFactory.create(crashReportTag) }
+
+    @AssistedFactory
+    interface Factory {
+        fun create(crashReportTag: LoggingConstants.CrashReportTag): CameraHelper
+    }
+
     fun startCamera(
         lifecycleOwner: LifecycleOwner,
         cameraPreview: PreviewView,
@@ -56,7 +67,7 @@ internal class CameraHelper @Inject constructor(
                             }
                         }
                 } catch (e: Exception) {
-                    Simber.i("Camera is already in use by another process", e, tag = LOGIN)
+                    Simber.i("Camera is already in use by another process", e, tag = crashReportTag)
                     initializationErrorListener.onCameraError()
                 }
             },
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzer.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzer.kt
new file mode 100644
index 0000000000..45a20534e2
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzer.kt
@@ -0,0 +1,88 @@
+package com.simprints.infra.uibase.camera.qrscan
+
+import android.graphics.Rect
+import androidx.camera.core.ExperimentalGetImage
+import androidx.camera.core.ImageAnalysis
+import androidx.camera.core.ImageProxy
+import com.google.mlkit.vision.common.InputImage
+import com.simprints.core.DispatcherBG
+import com.simprints.infra.logging.LoggingConstants
+import com.simprints.infra.logging.Simber
+import com.simprints.infra.uibase.camera.qrscan.usecase.CropBitmapAreaForDetectionUseCase
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
+import kotlinx.coroutines.CoroutineDispatcher
+import kotlinx.coroutines.channels.BufferOverflow
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.buffer
+import kotlinx.coroutines.flow.filterNotNull
+import kotlinx.coroutines.runBlocking
+
+
+class QrCodeAnalyzer @AssistedInject constructor(
+    private val qrCodeDetectorFactory: QrCodeDetector.Factory,
+    @DispatcherBG private val bgDispatcher: CoroutineDispatcher,
+    @Assisted private val cropConfig: CropConfig?,
+    @Assisted private val crashReportTag: LoggingConstants.CrashReportTag,
+    private val cropBitmapAreaForDetectionUseCase: CropBitmapAreaForDetectionUseCase
+) : ImageAnalysis.Analyzer {
+
+
+    @AssistedFactory
+    interface Factory {
+        fun create(cropConfig: CropConfig?, crashReportTag: LoggingConstants.CrashReportTag): QrCodeAnalyzer
+    }
+
+    /**
+     * Specifies what rectangle to crop from the image. This configuration is used in the image analysis - instead of analyzing the entire
+     * image, we are limiting the detection area to [rect]. The coordinates in [rect] are relative to the full image size, whose dimensions
+     * are given by [rootViewWidth] and [rootViewHeight]. Orientation of the image should be provided from the configuration constants.
+     *
+     * @param rect area to crop and analyze relative to the full image
+     * @param orientation orientation of the parent image. Should be provided from the configuration constants
+     * @param rootViewWidth width of the parent image
+     * @param rootViewHeight height of the parent image
+     */
+    data class CropConfig(
+        val rect: Rect,
+        val orientation: Int,
+        val rootViewWidth: Int,
+        val rootViewHeight: Int,
+    )
+
+    private val qrCodeDetector by lazy { qrCodeDetectorFactory.create(crashReportTag) }
+    private val _scannedCode = MutableStateFlow<String?>(null)
+    val scannedCode: Flow<String> = _scannedCode
+        .filterNotNull()
+        .buffer(1, onBufferOverflow = BufferOverflow.DROP_OLDEST)
+
+    @ExperimentalGetImage
+    override fun analyze(imageProxy: ImageProxy) {
+        imageProxy.use {
+            it.image?.let { mediaImage ->
+                runBlocking(bgDispatcher) {
+                    try {
+                        val rotationDegrees = imageProxy.imageInfo.rotationDegrees
+                        when (cropConfig) {
+                            null -> {
+                                val image = RawImage(mediaImage, rotationDegrees)
+                                qrCodeDetector.detectInImage(image)?.let(_scannedCode::tryEmit)
+                            }
+
+                            else -> {
+                                val bitmap = cropBitmapAreaForDetectionUseCase(imageProxy.toBitmap(), cropConfig)
+                                val image = InputImage.fromBitmap(bitmap, 0)
+                                qrCodeDetector.detectInImage(image)?.let(_scannedCode::tryEmit)
+                            }
+                        }
+
+                    } catch (t: Throwable) {
+                        Simber.e("QR code detection failed", t, tag = crashReportTag)
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeDetector.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeDetector.kt
similarity index 63%
rename from feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeDetector.kt
rename to infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeDetector.kt
index d02a084f6c..1489d2fdad 100644
--- a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/QrCodeDetector.kt
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/QrCodeDetector.kt
@@ -1,4 +1,4 @@
-package com.simprints.feature.login.tools.camera
+package com.simprints.infra.uibase.camera.qrscan
 
 import com.google.android.gms.tasks.Task
 import com.google.mlkit.vision.barcode.BarcodeScannerOptions
@@ -8,15 +8,24 @@ import com.google.mlkit.vision.common.InputImage
 import com.simprints.core.ExcludedFromGeneratedTestCoverageReports
 import com.simprints.core.tools.extentions.resumeSafely
 import com.simprints.core.tools.extentions.resumeWithExceptionSafely
-import com.simprints.infra.logging.LoggingConstants.CrashReportTag.LOGIN
+import com.simprints.infra.logging.LoggingConstants
 import com.simprints.infra.logging.Simber
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
 import kotlinx.coroutines.suspendCancellableCoroutine
-import javax.inject.Inject
 
 @ExcludedFromGeneratedTestCoverageReports(
     reason = "This is just an injectable wrapper around MLKit barcode analyzer",
 )
-internal class QrCodeDetector @Inject constructor() {
+class QrCodeDetector @AssistedInject constructor(
+    @Assisted private val crashReportTag: LoggingConstants.CrashReportTag,
+) {
+    @AssistedFactory
+    interface Factory {
+        fun create(crashReportTag: LoggingConstants.CrashReportTag): QrCodeDetector
+    }
+
     private val scanner = BarcodeScanning.getClient(
         BarcodeScannerOptions
             .Builder()
@@ -24,14 +33,17 @@ internal class QrCodeDetector @Inject constructor() {
             .build(),
     )
 
-    suspend fun detectInImage(rawImage: RawImage): String? = try {
+    suspend fun detectInImage(rawImage: RawImage): String? =
+        detectInImage(InputImage.fromMediaImage(rawImage.image, rawImage.rotationDegrees))
+
+    suspend fun detectInImage(image: InputImage): String? = try {
         scanner
-            .process(InputImage.fromMediaImage(rawImage.image, rawImage.rotationDegrees))
+            .process(image)
             .awaitTask()
             ?.firstOrNull { !it.rawValue.isNullOrEmpty() }
             ?.rawValue
     } catch (t: Throwable) {
-        Simber.e("QR code processing failed", t, tag = LOGIN)
+        Simber.e("QR code processing failed", t, tag = crashReportTag)
         null
     }
 
diff --git a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/RawImage.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/RawImage.kt
similarity index 51%
rename from feature/login/src/main/java/com/simprints/feature/login/tools/camera/RawImage.kt
rename to infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/RawImage.kt
index 4e4d3dfb30..a72956ab04 100644
--- a/feature/login/src/main/java/com/simprints/feature/login/tools/camera/RawImage.kt
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/RawImage.kt
@@ -1,8 +1,8 @@
-package com.simprints.feature.login.tools.camera
+package com.simprints.infra.uibase.camera.qrscan
 
 import android.media.Image
 
-internal data class RawImage(
+data class RawImage(
     val image: Image,
     val rotationDegrees: Int,
 )
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCase.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCase.kt
new file mode 100644
index 0000000000..bc556b6604
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCase.kt
@@ -0,0 +1,37 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.graphics.Bitmap
+import android.graphics.Rect
+import com.simprints.infra.uibase.camera.qrscan.QrCodeAnalyzer
+import javax.inject.Inject
+
+class CropBitmapAreaForDetectionUseCase @Inject constructor(
+    private val rotateToPortraitIfNeededUseCase: RotateToPortraitIfNeededUseCase,
+    private val mapCropRectToImageSpaceUseCase: MapCropRectToImageSpaceUseCase,
+    private val cropBitmapToRectUseCase: CropBitmapToRectUseCase
+) {
+    /**
+     * Takes a [bitmap] image, and crops it to the area specified in [cropConfig]
+     */
+    operator fun invoke(bitmap: Bitmap, cropConfig: QrCodeAnalyzer.CropConfig): Bitmap {
+        val rotatedBitmap: Bitmap = rotateToPortraitIfNeededUseCase(bitmap, cropConfig.orientation)
+        val crop: Rect = mapCropRectToImageSpaceUseCase(
+            cropRectInRoot = cropConfig.rect,
+            rootWidth = cropConfig.rootViewWidth,
+            rootHeight = cropConfig.rootViewHeight,
+            imageWidth = rotatedBitmap.width,
+            imageHeight = rotatedBitmap.height
+        )
+        val isLeftOutOfBounds = crop.left < 0
+        val isTopOutOfBounds = crop.top < 0
+        val isRightOutOfBounds = crop.right > rotatedBitmap.width
+        val isBottomOutOfBounds = crop.bottom > rotatedBitmap.height
+
+        // a safety check to ensure that crop area is fully inside the rotated bitmap bounds
+        return if (isLeftOutOfBounds || isTopOutOfBounds || isRightOutOfBounds || isBottomOutOfBounds) {
+            bitmap
+        } else {
+            cropBitmapToRectUseCase(rotatedBitmap, crop)
+        }
+    }
+}
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCase.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCase.kt
new file mode 100644
index 0000000000..56a51a17a7
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCase.kt
@@ -0,0 +1,23 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.graphics.Bitmap
+import android.graphics.Rect
+import javax.inject.Inject
+
+class CropBitmapToRectUseCase @Inject constructor() {
+    /**
+     * Crops given [source] bitmap to the specified [cropRect]
+     *
+     * @param source bitmap to crop
+     * @param cropRect target crop rectangle
+     * @return a new [Bitmap] representing the cropped region
+     */
+    operator fun invoke(source: Bitmap, cropRect: Rect): Bitmap {
+        val left = cropRect.left.coerceIn(0, source.width)
+        val top = cropRect.top.coerceIn(0, source.height)
+        val width = cropRect.width().coerceAtMost(source.width - left)
+        val height = cropRect.height().coerceAtMost(source.height - top)
+
+        return Bitmap.createBitmap(source, left, top, width, height)
+    }
+}
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/MapCropRectToImageSpaceUseCase.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/MapCropRectToImageSpaceUseCase.kt
new file mode 100644
index 0000000000..7180118613
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/MapCropRectToImageSpaceUseCase.kt
@@ -0,0 +1,35 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.graphics.Rect
+import javax.inject.Inject
+
+class MapCropRectToImageSpaceUseCase @Inject constructor() {
+    /**
+     * Maps a crop rectangle defined in the root view's coordinate space into the corresponding rectangle in the image's coordinate space.
+     * This is required when the crop area is selected on a view (UI) with different dimensions than the underlying image being processed.
+     *
+     * @param cropRectInRoot the crop rectangle coordinates in the root view space
+     * @param rootWidth the width of the root view
+     * @param rootHeight the height of the root view
+     * @param imageWidth the width of the image
+     * @param imageHeight the height of the image
+     * @return a [Rect] representing the crop area in the image's coordinate space
+     */
+    operator fun invoke(
+        cropRectInRoot: Rect,
+        rootWidth: Int,
+        rootHeight: Int,
+        imageWidth: Int,
+        imageHeight: Int,
+    ): Rect {
+        val scaleX = imageWidth.toFloat() / rootWidth
+        val scaleY = imageHeight.toFloat() / rootHeight
+
+        return Rect(
+            (cropRectInRoot.left * scaleX).toInt(),
+            (cropRectInRoot.top * scaleY).toInt(),
+            (cropRectInRoot.right * scaleX).toInt(),
+            (cropRectInRoot.bottom * scaleY).toInt()
+        )
+    }
+}
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCase.kt b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCase.kt
new file mode 100644
index 0000000000..88c5605179
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCase.kt
@@ -0,0 +1,29 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.content.res.Configuration
+import android.graphics.Bitmap
+import android.graphics.Matrix
+import javax.inject.Inject
+
+class RotateToPortraitIfNeededUseCase @Inject constructor() {
+    /**
+     * Rotates given [bitmap] by 90 degrees if it is in landscape mode. Otherwise, returns the original [bitmap] without modification.
+     * Images from video feed are usually in landscape mode, and we want to be sure that the calculation are always happening in the same
+     * space.
+     *
+     * @param bitmap image to potentially rotate
+     * @param orientation the current device orientation from [Configuration] (portrait/landscape)
+     * @return a rotated bitmap if rotation was needed, otherwise the original bitmap
+     */
+    operator fun invoke(bitmap: Bitmap, orientation: Int): Bitmap {
+        val isLandscape = bitmap.width > bitmap.height
+        val isPortraitOrientation = orientation == Configuration.ORIENTATION_PORTRAIT
+
+        return if (isLandscape && isPortraitOrientation) {
+            val matrix = Matrix().apply { postRotate(90f) }
+            Bitmap.createBitmap(bitmap, 0, 0, bitmap.width, bitmap.height, matrix, true)
+        } else {
+            bitmap
+        }
+    }
+}
diff --git a/infra/ui-base/src/main/java/com/simprints/infra/view/PermissionRequestView.kt b/infra/ui-base/src/main/java/com/simprints/infra/view/PermissionRequestView.kt
new file mode 100644
index 0000000000..9e8c8d77e7
--- /dev/null
+++ b/infra/ui-base/src/main/java/com/simprints/infra/view/PermissionRequestView.kt
@@ -0,0 +1,46 @@
+package com.simprints.infra.view
+
+import android.content.Context
+import android.util.AttributeSet
+import android.view.LayoutInflater
+import android.widget.Button
+import android.widget.LinearLayout
+import android.widget.TextView
+import androidx.annotation.StringRes
+import com.simprints.infra.uibase.R
+import com.simprints.infra.uibase.annotations.ExcludedFromGeneratedTestCoverageReports
+
+@ExcludedFromGeneratedTestCoverageReports("UI Code")
+class PermissionRequestView @JvmOverloads constructor(
+    context: Context,
+    attrs: AttributeSet? = null,
+    defStyle: Int = 0
+) : LinearLayout(context, attrs, defStyle) {
+
+    private val title: TextView
+    private val body: TextView
+    private val actionButton: Button
+
+    init {
+        orientation = VERTICAL
+        LayoutInflater.from(context).inflate(R.layout.view_camera_permission_request, this, true)
+
+        title = findViewById(R.id.permissionTitle)
+        body = findViewById(R.id.permissionBody)
+        actionButton = findViewById(R.id.permissionAction)
+    }
+
+    fun init(title: String, body: String, buttonText: String, onClickListener: OnClickListener) {
+        this.title.text = title
+        this.body.text = body
+        this.actionButton.text = buttonText
+        this.actionButton.setOnClickListener(onClickListener)
+    }
+
+    fun init(@StringRes title: Int, @StringRes body: Int, @StringRes buttonText: Int, onClickListener: OnClickListener) {
+        this.title.setText(title)
+        this.body.setText(body)
+        this.actionButton.setText(buttonText)
+        this.actionButton.setOnClickListener(onClickListener)
+    }
+}
diff --git a/infra/ui-base/src/main/res/layout/view_camera_permission_request.xml b/infra/ui-base/src/main/res/layout/view_camera_permission_request.xml
new file mode 100644
index 0000000000..f0fda4a5e6
--- /dev/null
+++ b/infra/ui-base/src/main/res/layout/view_camera_permission_request.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merge xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <com.google.android.material.card.MaterialCardView
+        android:id="@+id/permissionCard"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:padding="@dimen/margin_large"
+        app:cardElevation="2dp"
+        app:cardUseCompatPadding="true">
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:padding="@dimen/padding_large">
+
+            <TextView
+                android:id="@+id/permissionTitle"
+                style="@style/Text.Headline5"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                tools:text="Camera Permission Required" />
+
+            <View
+                android:layout_width="match_parent"
+                android:layout_height="1dp"
+                android:layout_marginVertical="@dimen/margin_large"
+                android:background="@color/simprints_grey_light" />
+
+            <TextView
+                android:id="@+id/permissionBody"
+                style="@style/Text.Body1"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                tools:text="This app requires access to your camera to scan documents." />
+
+            <Button
+                android:id="@+id/permissionAction"
+                style="@style/Widget.Simprints.Button"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="@dimen/margin_large"
+                tools:text="Grant Permission" />
+
+        </LinearLayout>
+    </com.google.android.material.card.MaterialCardView>
+</merge>
diff --git a/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzerTest.kt b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzerTest.kt
new file mode 100644
index 0000000000..051659bfc9
--- /dev/null
+++ b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/QrCodeAnalyzerTest.kt
@@ -0,0 +1,100 @@
+package com.simprints.infra.uibase.camera.qrscan
+
+import android.graphics.Bitmap
+import androidx.camera.core.ImageProxy
+import com.google.common.truth.*
+import com.google.mlkit.vision.common.InputImage
+import com.simprints.infra.logging.LoggingConstants
+import com.simprints.infra.uibase.camera.qrscan.usecase.CropBitmapAreaForDetectionUseCase
+import com.simprints.testtools.common.coroutines.TestCoroutineRule
+import io.mockk.*
+import io.mockk.impl.annotations.MockK
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.test.runTest
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+
+internal class QrCodeAnalyzerTest {
+    @get:Rule
+    val testCoroutineRule = TestCoroutineRule()
+
+    @MockK
+    lateinit var qrCodeDetector: QrCodeDetector
+
+    @MockK
+    lateinit var imageProxy: ImageProxy
+
+    private lateinit var qrCodeProducer: QrCodeAnalyzer
+    private lateinit var cropUseCase: CropBitmapAreaForDetectionUseCase
+    private lateinit var bitmap: Bitmap
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+        bitmap = mockk<Bitmap>()
+        cropUseCase = mockk<CropBitmapAreaForDetectionUseCase>(relaxed = true)
+    }
+
+    private fun initQrCodeProducer(cropConfig: QrCodeAnalyzer.CropConfig?) {
+        qrCodeProducer = QrCodeAnalyzer(
+            qrCodeDetectorFactory = mockk<QrCodeDetector.Factory> {
+                every { create(any()) } returns qrCodeDetector
+            },
+            bgDispatcher = testCoroutineRule.testCoroutineDispatcher,
+            cropConfig = cropConfig,
+            crashReportTag = LoggingConstants.CrashReportTag.LOGIN,
+            cropBitmapAreaForDetectionUseCase = cropUseCase
+        )
+    }
+
+    @Test
+    fun `should not trigger detector when no images obtained`() {
+        initQrCodeProducer(cropConfig = null)
+        every { imageProxy.image } returns null
+        qrCodeProducer.analyze(imageProxy)
+
+        coVerify(exactly = 0) { qrCodeDetector.detectInImage(any<RawImage>()) }
+    }
+
+    @Test
+    fun `should send RQ code value to flow`() = runTest {
+        initQrCodeProducer(cropConfig = null)
+        every { imageProxy.image } returns mockk()
+        coEvery { qrCodeDetector.detectInImage(any<RawImage>()) } returns "mock_value"
+
+        qrCodeProducer.analyze(imageProxy)
+        val code = qrCodeProducer.scannedCode.first()
+
+        Truth.assertThat(code).isEqualTo("mock_value")
+    }
+
+    @Test
+    fun `should close image proxy with unsuccessful scan`() {
+        initQrCodeProducer(cropConfig = null)
+        coEvery { qrCodeDetector.detectInImage(any<RawImage>()) } throws Throwable()
+
+        qrCodeProducer.analyze(imageProxy)
+
+        verify { imageProxy.close() }
+    }
+
+    @Test
+    fun `should emit code when cropConfig is provided`() = runTest {
+        val cropConfig = mockk<QrCodeAnalyzer.CropConfig>()
+        val expectedQrValue = "expectedQrValue"
+        initQrCodeProducer(cropConfig)
+
+        mockkStatic(InputImage::class)
+        every { InputImage.fromBitmap(any(), any()) } returns mockk(relaxed = true)
+        every { imageProxy.image } returns mockk(relaxed = true)
+        every { imageProxy.toBitmap() } returns bitmap
+        every { cropUseCase.invoke(bitmap, cropConfig) } returns bitmap
+        coEvery { qrCodeDetector.detectInImage(any<InputImage>()) } returns expectedQrValue
+
+        qrCodeProducer.analyze(imageProxy)
+        val scannedCode = qrCodeProducer.scannedCode.first()
+        Truth.assertThat(scannedCode).isEqualTo(expectedQrValue)
+    }
+
+}
diff --git a/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCaseTest.kt b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCaseTest.kt
new file mode 100644
index 0000000000..c7e8168bb9
--- /dev/null
+++ b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapAreaForDetectionUseCaseTest.kt
@@ -0,0 +1,104 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.graphics.Bitmap
+import android.graphics.Rect
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import com.google.common.truth.Truth.*
+import com.simprints.infra.uibase.camera.qrscan.QrCodeAnalyzer
+import io.mockk.*
+import io.mockk.impl.annotations.MockK
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+internal class CropBitmapAreaForDetectionUseCaseTest {
+
+    @MockK
+    lateinit var rotateIfNeeded: RotateToPortraitIfNeededUseCase
+
+    @MockK
+    lateinit var mapCropRectToImageSpace: MapCropRectToImageSpaceUseCase
+
+    @MockK
+    lateinit var cropBitmapToRect: CropBitmapToRectUseCase
+
+    @MockK
+    lateinit var originalBitmap: Bitmap
+
+    @MockK
+    lateinit var rotatedBitmap: Bitmap
+
+    @MockK
+    lateinit var croppedBitmap: Bitmap
+
+    private lateinit var useCase: CropBitmapAreaForDetectionUseCase
+
+    private val cropConfig = QrCodeAnalyzer.CropConfig(
+        rect = Rect(0, 0, 10, 10),
+        orientation = 0,
+        rootViewWidth = 100,
+        rootViewHeight = 100
+    )
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+
+        every { rotatedBitmap.width } returns 50
+        every { rotatedBitmap.height } returns 50
+
+        useCase = CropBitmapAreaForDetectionUseCase(
+            rotateIfNeeded,
+            mapCropRectToImageSpace,
+            cropBitmapToRect
+        )
+    }
+
+    @Test
+    fun `returns cropped bitmap when rect is inside bounds`() {
+        val mappedRect = Rect(5, 5, 15, 15)
+
+        every { rotateIfNeeded(originalBitmap, 0) } returns rotatedBitmap
+        every { mapCropRectToImageSpace(any(), any(), any(), any(), any()) } returns mappedRect
+        every { cropBitmapToRect(rotatedBitmap, mappedRect) } returns croppedBitmap
+
+        val result = useCase(originalBitmap, cropConfig)
+
+        assertThat(result).isEqualTo(croppedBitmap)
+        verify { rotateIfNeeded(bitmap = originalBitmap, orientation = 0) }
+        verify {
+            mapCropRectToImageSpace(
+                cropRectInRoot = cropConfig.rect,
+                rootWidth = 100,
+                rootHeight = 100,
+                imageWidth = 50,
+                imageHeight = 50
+            )
+        }
+        verify { cropBitmapToRect(source = rotatedBitmap, cropRect = mappedRect) }
+    }
+
+    @Test
+    fun `returns original bitmap when rect is out of bounds`() {
+        val mappedRect = Rect(-5, 5, 15, 15)
+
+        every { rotateIfNeeded(originalBitmap, 0) } returns rotatedBitmap
+        every { mapCropRectToImageSpace(any(), any(), any(), any(), any()) } returns mappedRect
+
+        val result = useCase(originalBitmap, cropConfig)
+
+        assertThat(result).isEqualTo(originalBitmap)
+        verify { rotateIfNeeded(bitmap = originalBitmap, orientation = 0) }
+        verify {
+            mapCropRectToImageSpace(
+                cropRectInRoot = cropConfig.rect,
+                rootWidth = 100,
+                rootHeight = 100,
+                imageWidth = 50,
+                imageHeight = 50
+            )
+        }
+        verify(exactly = 0) { cropBitmapToRect(any(), any()) }
+    }
+}
diff --git a/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCaseTest.kt b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCaseTest.kt
new file mode 100644
index 0000000000..b731e61304
--- /dev/null
+++ b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/CropBitmapToRectUseCaseTest.kt
@@ -0,0 +1,140 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.graphics.Bitmap
+import android.graphics.Rect
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import com.google.common.truth.Truth.*
+import io.mockk.*
+import io.mockk.impl.annotations.MockK
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+internal class CropBitmapToRectUseCaseTest {
+
+    @MockK
+    lateinit var sourceBitmap: Bitmap
+
+    @MockK
+    lateinit var croppedBitmap: Bitmap
+
+    private lateinit var useCase: CropBitmapToRectUseCase
+
+    private val w800 = 800
+    private val h600 = 600
+    private val x100 = 100
+    private val y100 = 100
+    private val w200 = 200
+    private val h150 = 150
+    private val x0 = 0
+    private val y0 = 0
+    private val x50 = 50
+    private val y50 = 50
+    private val w100 = 100
+    private val h100 = 100
+    private val x900 = 900
+    private val y700 = 700
+    private val x750 = 750
+    private val y550 = 550
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+
+        every { sourceBitmap.width } returns w800
+        every { sourceBitmap.height } returns h600
+
+        useCase = CropBitmapToRectUseCase()
+    }
+
+    @Test
+    fun `crops bitmap with rect inside bounds`() {
+        val cropRect = Rect(x100, y100, x100 + w200, y100 + h150)
+        runUseCaseTest(cropRect, x100, y100, w200, h150)
+    }
+
+    @Test
+    fun `crops bitmap with rect at origin`() {
+        val cropRect = Rect(x0, y0, w100, h100)
+        runUseCaseTest(cropRect, x0, y0, w100, h100)
+    }
+
+    @Test
+    fun `coerces negative left coordinate to zero`() {
+        val cropRect = Rect(-x50, y100, -x50 + w100, y100 + h100)
+        runUseCaseTest(cropRect, x0, y100, w100, h100)
+    }
+
+    @Test
+    fun `coerces negative top coordinate to zero`() {
+        val cropRect = Rect(x100, -y50, x100 + w100, -y50 + h100)
+        runUseCaseTest(cropRect, x100, x0, w100, h100)
+    }
+
+    @Test
+    fun `coerces left coordinate exceeding bitmap width`() {
+        val cropRect = Rect(x900, y100, x900 + w100, y100 + h100)
+        runUseCaseTest(cropRect, w800, y100, x0, h100)
+    }
+
+    @Test
+    fun `coerces top coordinate exceeding bitmap height`() {
+        val cropRect = Rect(x100, y700, x100 + w100, y700 + h100)
+        runUseCaseTest(cropRect, x100, h600, w100, x0)
+    }
+
+    @Test
+    fun `limits width when crop extends beyond bitmap width`() {
+        val cropRect = Rect(x750, y100, x750 + w200, y100 + h100)
+        val expectedWidth = w800 - x750
+        runUseCaseTest(cropRect, x750, y100, expectedWidth, h100)
+    }
+
+    @Test
+    fun `limits height when crop extends beyond bitmap height`() {
+        val cropRect = Rect(x100, y550, x100 + w100, y550 + h150)
+        val expectedHeight = h600 - y550
+        runUseCaseTest(cropRect, x100, y550, w100, expectedHeight)
+    }
+
+    @Test
+    fun `handles rect completely outside bounds with adjusted coordinates`() {
+        val cropRect = Rect(x900, y700, x900 + w100, y700 + h100)
+        runUseCaseTest(cropRect, w800, h600, x0, x0)
+    }
+
+    private fun runUseCaseTest(
+        cropRect: Rect,
+        expectedLeft: Int,
+        expectedTop: Int,
+        expectedWidth: Int,
+        expectedHeight: Int
+    ) {
+        mockkStatic(Bitmap::class)
+
+        every {
+            Bitmap.createBitmap(
+                sourceBitmap,
+                expectedLeft,
+                expectedTop,
+                expectedWidth,
+                expectedHeight
+            )
+        } returns croppedBitmap
+
+        val result = useCase(sourceBitmap, cropRect)
+
+        assertThat(result).isEqualTo(croppedBitmap)
+        verify {
+            Bitmap.createBitmap(
+                sourceBitmap,
+                expectedLeft,
+                expectedTop,
+                expectedWidth,
+                expectedHeight
+            )
+        }
+        unmockkStatic(Bitmap::class)
+    }
+}
diff --git a/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCaseTest.kt b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCaseTest.kt
new file mode 100644
index 0000000000..8a73f0c77c
--- /dev/null
+++ b/infra/ui-base/src/test/java/com/simprints/infra/uibase/camera/qrscan/usecase/RotateToPortraitIfNeededUseCaseTest.kt
@@ -0,0 +1,110 @@
+package com.simprints.infra.uibase.camera.qrscan.usecase
+
+import android.content.res.Configuration
+import android.graphics.Bitmap
+import android.graphics.Matrix
+import androidx.test.ext.junit.runners.*
+import com.google.common.truth.Truth.*
+import io.mockk.*
+import io.mockk.impl.annotations.MockK
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+internal class RotateToPortraitIfNeededUseCaseTest {
+
+    @MockK
+    lateinit var landscapeBitmap: Bitmap
+
+    @MockK
+    lateinit var portraitBitmap: Bitmap
+
+    @MockK
+    lateinit var rotatedBitmap: Bitmap
+
+    private lateinit var useCase: RotateToPortraitIfNeededUseCase
+
+    private val w800 = 800
+    private val h600 = 600
+    private val w600 = 600
+    private val h800 = 800
+
+    @Before
+    fun setUp() {
+        MockKAnnotations.init(this, relaxed = true)
+
+        every { landscapeBitmap.width } returns w800
+        every { landscapeBitmap.height } returns h600
+        every { portraitBitmap.width } returns w600
+        every { portraitBitmap.height } returns h800
+
+        useCase = RotateToPortraitIfNeededUseCase()
+    }
+
+    @Test
+    fun `rotates landscape bitmap when device is in portrait orientation`() {
+        mockkStatic(Bitmap::class)
+        every {
+            Bitmap.createBitmap(
+                landscapeBitmap,
+                0,
+                0,
+                w800,
+                h600,
+                any<Matrix>(),
+                true
+            )
+        } returns rotatedBitmap
+
+        val result = useCase(landscapeBitmap, Configuration.ORIENTATION_PORTRAIT)
+
+        assertThat(result).isEqualTo(rotatedBitmap)
+        verify {
+            Bitmap.createBitmap(
+                landscapeBitmap,
+                0,
+                0,
+                w800,
+                h600,
+                any<Matrix>(),
+                true
+            )
+        }
+        unmockkStatic(Bitmap::class)
+    }
+
+    @Test
+    fun `returns original bitmap when landscape bitmap and device is in landscape orientation`() {
+        runUseCaseTest(source = landscapeBitmap, orientation = Configuration.ORIENTATION_LANDSCAPE, expected = landscapeBitmap)
+    }
+
+    @Test
+    fun `returns original bitmap when portrait bitmap and device is in portrait orientation`() {
+        runUseCaseTest(source = portraitBitmap, orientation = Configuration.ORIENTATION_PORTRAIT, expected = portraitBitmap)
+    }
+
+    @Test
+    fun `returns original bitmap when portrait bitmap and device is in landscape orientation`() {
+        runUseCaseTest(source = portraitBitmap, orientation = Configuration.ORIENTATION_LANDSCAPE, expected = portraitBitmap)
+    }
+
+    @Test
+    fun `returns original bitmap when device orientation is undefined`() {
+        runUseCaseTest(source = landscapeBitmap, orientation = Configuration.ORIENTATION_UNDEFINED, expected = landscapeBitmap)
+    }
+
+    @Test
+    fun `returns original bitmap when bitmap is square and device is in portrait orientation`() {
+        val squareBitmap = mockk<Bitmap>()
+        every { squareBitmap.width } returns w600
+        every { squareBitmap.height } returns w600
+
+        runUseCaseTest(source = squareBitmap, orientation = Configuration.ORIENTATION_PORTRAIT, expected = squareBitmap)
+    }
+
+    private fun runUseCaseTest(source: Bitmap, orientation: Int, expected: Bitmap) {
+        val result = useCase(source, orientation)
+        assertThat(result).isEqualTo(expected)
+    }
+}