# Crash Analytics

When the user wants to monitor, triage, or reduce their app's crash rate, including...

- Repository: https://github.com/appeeky/aso-skills (2243 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-10-06
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add appeeky/aso-skills --skill crash-analytics -g -a claude-code -y`
Codex: `npx skills add appeeky/aso-skills --skill crash-analytics -g -a codex -y`
Cursor: `npx skills add appeeky/aso-skills --skill crash-analytics -g -a cursor -y`
Gemini CLI: `npx skills add appeeky/aso-skills --skill crash-analytics -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add appeeky/aso-skills`

## Description

When the user wants to monitor, triage, or reduce their app's crash rate, including setting up Crashlytics, prioritizing which crashes to fix first, interpreting crash data, and understanding how crashes affect App Store ranking. Use when the user mentions "crash", "crashlytics", "crash rate", "ANR", "app not responding", "crash-free sessions", "crash-free users", "symbolication", "stability", "firebase crashes", "app crashing", or "crash report". For overall analytics setup, see app-analytics.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Crash Analytics

You help triage, prioritize, and reduce app crashes, and understand how crash rate affects App Store discoverability and ratings.

## Why Crash Rate Is an ASO Signal

- **App Store ranking**, Apple's algorithm penalizes apps with high crash rates
- **App Store featuring**, High crash rate disqualifies editorial consideration
- **Ratings**, Crashes are the #1 cause of 1-star reviews
- **Retention**, A crash in the first session destroys Day 1 retention

**Target:** crash-free sessions > 99.5% | crash-free users > 99%

## Tools

| Tool | What it provides | Setup |
|------|-----------------|-------|
| **Firebase Crashlytics** | Real-time crashes, ANRs, symbolicated stack traces | Add `FirebaseCrashlytics` pod/SPM package |
| **App Store Connect** | Crash rate trend, crashes per session | Built-in, no code needed |
| **Xcode Organizer** | Aggregated crash logs from TestFlight + App Store | Xcode → Window → Organizer → Crashes |
| **MetricKit** | On-device diagnostics, hang rate, launch time | iOS 13+, automatic |

**Recommended:** Crashlytics (real-time alerts + search) + App Store Connect (trend validation)

## Crashlytics Setup

### iOS (Swift)

```swift
// AppDelegate or @main App struct
import FirebaseCore
import FirebaseCrashlytics

@main
struct MyApp: App {
    init() {
        FirebaseApp.configure()
        // Crashlytics is auto-initialized
    }
}
```

### Non-fatal errors (track without crashing)

```swift
// Log a non-fatal error
Crashlytics.crashlytics().record(error: error)

// Log a custom key for debugging context
Crashlytics.crashlytics().setCustomValue(userId, forKey: "user_id")
Crashlytics.crashlytics().setCustomValue(screenName, forKey: "current_screen")
```

### Android (Kotlin)

```kotlin
// build.gradle (app)
implementation("com.google.firebase:firebase-crashlytics:18.x.x")

// No additional code needed, auto-captures unhandled exceptions
// For non-fatal:
FirebaseCrashlytics.getInstance().recordException(throwable)
```

The rest: https://github.com/appeeky/aso-skills/blob/HEAD/skills/crash-analytics/SKILL.md