On mobile?

Email yourself the setup link so you can finish when you're at your computer.

BREADCRUMBS

Crash Debugging with Application Breadcrumbs

Automatically capture application breadcrumbs and user session events before crashes and errors. Reconstruct user behavior, understand root causes, and debug production issues with full context in a session timeline.

See a real timeline

A crash tells you where your app broke.
Breadcrumbs tell you how the user got there.

THE PROBLEM

Why Crashes Are Hard to Debug Without Context

You get a crash report. The stack trace shows a NullReferenceException. Great. But why did it happen?

Without breadcrumbs, you're flying blind. You're left asking:

Traditional crash reporting gives you the error location but not the user journey. You're forced to reproduce the issue manually, ask support for steps to reproduce, or just guess based on incomplete data.

"I can't reproduce it" is developer-speak for "I don't know what the user did before it crashed."

THE SOLUTION

What Are Breadcrumbs?

Breadcrumbs are lightweight navigation markers that record meaningful user actions as they move through your app. They're like a trail of footprints showing exactly where the user went and what they did.

Unlike generic analytics events, breadcrumbs are specifically designed to give context to crashes, errors, and sessions. They answer the question: "What did the user do before this happened?"

AppAmbit captures many breadcrumbs automatically—such as app lifecycle and screen navigation events—while also allowing you to add custom breadcrumbs for important user actions and business logic.

🧭

Navigation Events (Automatic)

Automatically captures screen and page views as users move through your app

👆

User Actions (Manual)

Record button clicks, form submissions, and other meaningful interactions

Key Moments (Manual)

Mark critical business events like checkout started or payment initiated

🎯

State Changes (Manual)

Capture changes like toggles, filters, modes, or settings updates

All breadcrumbs—automatic and manual—are linked to the session timeline to create a complete picture of what happened before an issue occurred.

HOW IT WORKS

Breadcrumbs in the Session Timeline

AppAmbit automatically captures app and page lifecycle events — like app start, screen views, and foreground or background transitions. On top of that, you can send your own custom breadcrumbs. Both appear together in a single, chronological session timeline. — See a real timeline

14:22:01 - App Started (automatic)
14:22:03 - Screen: Home (automatic)
14:22:08 - Breadcrumb: Clicked "Shop Now"
14:22:09 - Screen: Product List (automatic)
14:22:15 - Breadcrumb: Selected filter "Price: Low to High"
14:22:18 - Breadcrumb: Added item to cart
14:22:19 - Screen: Cart (automatic)
14:22:23 - Breadcrumb: Clicked "Checkout"
14:22:24 - Screen: Checkout (automatic)
14:22:28 - Breadcrumb: Entered shipping address
14:22:30 - Event: validate_address
14:22:31 - Breadcrumb: Clicked "Continue to Payment"
14:22:32 - Network: POST /api/validate-cart timeout
14:22:32 - CRASH: NullReferenceException at CheckoutViewModel.cs:156

Automatic signals and manual breadcrumbs — side by side, exactly as they happened.

Automatic lifecycle events provide context. Manual breadcrumbs explain intent. Together, they reveal precisely what the user did and how the app responded in the moments leading up to a crash.

Full Context, Zero Guessing

You don’t just see that something failed. You see the user journey, the system behavior, and the exact action that triggered the issue — all in one timeline.

Debugging With vs Without Breadcrumbs

Scenario Without Breadcrumbs With Breadcrumbs
User reports crash "It just crashes sometimes" See exact sequence of actions
Reproduction Try for hours, can't reproduce No reproduction needed
Context Stack trace only Full user journey visible
Edge cases Discovered through user complaints Identified immediately in timeline
Time to fix Hours to days Minutes
User experience Repeated crashes, slow fixes Fast hotfixes, happy users
POSSIBLE SCENARIOS

When Breadcrumbs Save You Hours

Scenario 1: The Mystery Crash

Problem: Users report app crashes "randomly" when using the profile screen.

Without Breadcrumbs: You spend hours trying different combinations. Can't reproduce it. Ask support for more details. Users say "it just crashes."

With Breadcrumbs: Timeline shows users went Home → Settings → Profile → Edit → Save. But crashes only happen when users toggle "Private Profile" ON before saving. Edge case found in 2 minutes.

Scenario 2: The Payment Bug

Problem: Some users can't complete checkout. Payment fails silently.

Without Breadcrumbs: Payment logs show "validation error" but don't explain why. You check Stripe logs, database records, try reproducing with test cards.

With Breadcrumbs: Timeline reveals affected users all clicked "Apply Promo Code" before payment. The promo code flow doesn't update the payment amount properly. Bug isolated immediately.

Scenario 3: The Offline Issue

Problem: App crashes when users go offline and come back online.

Without Breadcrumbs: Stack trace shows a threading exception. No idea what the user was doing or how they triggered offline mode.

With Breadcrumbs: Timeline shows: User opened app → Started upload → Network disconnected → User switched to another app → Came back 5 minutes later → Crash. The upload recovery logic doesn't handle stale sessions. Fixed.

BEST PRACTICES

How to Use Breadcrumbs Effectively

📝

Use Clear, Action-Oriented Names

Good: "Clicked Save Button", "Opened Settings Screen", "Applied Discount Code"

Bad: "Action", "Event123", "User did something"

🎯

Focus on User Journey

Track actions that help you understand how users move through your app. Navigation, key interactions, and state changes matter most.

⚖️

Don't Over-Track

You don't need a breadcrumb for every mouse movement. Track meaningful actions. If it wouldn't help debug a crash, skip it.

APPAMBIT FEATURES

How AppAmbit Makes Breadcrumbs Work

Built-In Features:

  • Automatic lifecycle breadcrumbs: App start, screen/page views, and foreground/background transitions are captured automatically
  • Auto-linked to crashes: Every crash automatically shows its full breadcrumb trail
  • Chronological timeline: Breadcrumbs appear inline with logs, events, and network calls
  • Custom breadcrumbs: Add manual breadcrumbs for key user actions and business logic
  • Lightweight: Simple API, minimal overhead, maximum insight

AppAmbit gives you automatic context out of the box, with the flexibility to add deeper insights where they matter most.

See Breadcrumbs in Real Sessions

Start free and explore a live demo with breadcrumbs fully integrated into session timelines and crash reports. See how breadcrumbs transform debugging—no credit card required.

See a real timeline