Common Ui Freezes in E-Commerce Apps: Causes and Fixes

E‑commerce apps are especially vulnerable because they constantly load media, process user actions (add to cart, apply coupon, checkout), and integrate many third‑party services. The result is a high

1. What Causes UI Freezes in E‑Commerce Apps

E‑commerce apps are especially vulnerable because they constantly load media, process user actions (add to cart, apply coupon, checkout), and integrate many third‑party services. The result is a high probability that a single blocking operation can freeze the UI for one or two seconds, which feels like a crash to the user.

---

2. Real‑World Impact

A single freeze that happens at checkout can cost a business thousands of dollars in lost conversions, while a freeze during product browsing may result in a negative app store review that takes weeks to recover from.

---

3. 5–7 Specific Manifestations in E‑Commerce Apps

1. Add‑to‑Cart button stalls

• The button becomes unresponsive for 2–3 s after tapping.
• Usually caused by synchronous network request or heavy local DB update.

1. Product image carousel stutters

• Swiping between images freezes the UI for 1–2 s.
• Happens when each image is decoded on the main thread.

1. Checkout progress indicator hangs

• The spinner stops spinning after the first step, UI blocks.
• Often due to an API call that blocks on the main thread.

1. Search suggestions lag

• Suggestions appear after a delay of >1 s, UI freezes during typing.
• Caused by synchronous DB search or network request for each keystroke.

1. Dynamic price updates freeze

• When a promo code is applied, the UI stops for 1.5 s while recalculating totals.
• Heavy computation or JSON deserialization on the UI thread.

1. Cross‑session tracking freeze

• Navigation back from a product page to the home screen stalls.
• Persisting large user data asynchronously but incorrectly on the main thread.

1. Ad or analytics SDK freeze during product page load

• The entire page becomes unresponsive for a second.
• SDK performs blocking I/O while rendering the product details.

---

4. How to Detect UI Freezes

What to look for:

• Long frame times (≥ 16 ms per frame on 60 Hz, ≥ 33 ms on 30 Hz).
• Main thread blocked for > 500 ms.
• GC pause > 200 ms.
• Sync network call trace in the main thread.

---

5. Fixing Each Example

5.1 Add‑to‑Cart Button Freezes

Root cause: Synchronous network or DB write.

// Bad: synchronous on main thread
fun addToCart(product: Product) {
    val cart = db.query("SELECT * FROM cart WHERE user = ?", userId) // blocking
    cart.add(product)
    db.update(cart) // blocking
}

Fix: Run on IO dispatcher

suspend fun addToCart(product: Product) = withContext(Dispatchers.IO) {
    val cart = db.query("SELECT * FROM cart WHERE user = ?", userId)
    cart.add(product)
    db.update(cart)
}

UI side

lifecycleScope.launch {
    button.isEnabled = false
    try {
        addToCart(product)
        showToast("Added to cart")
    } finally {
        button.isEnabled = true
    }
}

5.2 Product Image Carousel Stutters

Root cause: Image decoding on the main thread.

// Bad: decoding inside RecyclerView onBind
override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    val bitmap = BitmapFactory.decodeFile(path)
    holder.imageView.setImageBitmap(bitmap)
}

Fix: Use Glide or Coil

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    Glide.with(holder.imageView)
        .load(product.imageUrl)
        .placeholder(R.drawable.loading)
        .into(holder.imageView)
}

5.3 Checkout Progress Indicator Hangs

Root cause: Blocking API call on UI thread.

// Bad
val response = apiClient.submitOrder(order) // blocking

Fix: Suspend function

suspend fun submitOrder(order: Order): OrderResponse = apiClient.submitOrder(order)

UI side

lifecycleScope.launch {
    progressBar.isVisible = true
    try {
        val response = submitOrder(order)
        if (response.success) navigateToThankYou()
    } catch (e: IOException) {
        showError("Network error")
    } finally {
        progressBar.isVisible = false
    }
}

5.4 Search Suggestions Lag

Root cause: Synchronous database search for each keystroke.

searchField.addTextChangedListener { text ->
    val results = db.search(text) // blocking
    adapter.submitList(results)
}

Fix: Debounce and run on IO dispatcher

searchField.textChanges()
    .debounce(300, TimeUnit.MILLISECONDS)
    .switchMapLatest { text ->
        flow {
            val results = withContext(Dispatchers.IO) { db.search(text) }
            emit(results)
        }
    }
    .flowOn(Dispatchers.Main)
    .onEach { adapter.submitList(it) }
    .launchIn(lifecycleScope)

5.5 Dynamic Price Updates Freeze

Root cause: Heavy JSON deserialization and math on UI thread.

val totals = Gson().fromJson(json, Totals::class.java) // blocking

Fix: Deserialize on IO dispatcher

val totals = withContext(Dispatchers.IO) { Gson().fromJson(json, Totals::class.java) }

5.6 Cross‑Session Tracking Freeze

Root cause: Large data persisted on main thread during navigation.

fun onNavigateBack() {
    sharedPrefs.edit().putString("userData", largeJson).apply()
}

Fix: Use WorkManager or coroutine

fun persistUserData() {
    WorkManager.getInstance(context)
        .enqueueUniqueWork("PersistUserData", ExistingWorkPolicy.REPLACE,
            OneTimeWorkRequestBuilder<SaveUserDataWorker>().build())
}

5.7 Ad / Analytics SDK Freeze

Root cause: SDK performs HTTP call on main thread.

Fix: Check SDK docs; if no async API, wrap in coroutine:

lifecycleScope.launch {
    withContext(Dispatchers.IO) {
        adSdk.loadBanner()
    }
}

---

6. Prevention: Catch UI Freezes Before Release

Sample GitHub Actions Workflow

name: CI – UI Freeze Detection

on: pull_request

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up Java
        uses: actions/setup-java@v3
        with:
          distribution: temurin
          java-version: 17
      - name: Install SUSA Agent
        run: pip install susatest-agent
      - name: Run SUSA
        run: susatest-agent run --url https://app.susatest.com --apk path/to/app.apk
      - name: Publish results
        if: always()
        uses: actions/upload-artifact@v3
        with:
          name: susa-report
          path: susa-report.json

If the report shows any freeze > 500 ms, the CI job fails, preventing a merge.

---

7. Closing Thought

UI freezes in e‑commerce apps are not just a usability nuisance—they translate directly into revenue loss, negative reviews, and support overhead. By understanding the common technical roots, detecting them early with tools like SUSA, fixing each scenario with targeted code changes, and embedding freeze detection into the CI pipeline, teams can deliver a buttery‑smooth shopping experience that keeps customers coming back.