NutriSport: Skill for Claude Code

Sentry Setup for KMP (Android + iOS)

A field-tested recipe for wiring Sentry into a Kotlin Multiplatform + Compose Multiplatform project with one shared init path, PII scrubbing, symbol upload, and a crash smoke test. The unified sentry-kotlin-multiplatform SDK means you write Sentry.init { } once in commonMain and both platforms use it.

Step 0 — Decide the crash-reporting posture

Sentry can either replace Firebase Crashlytics or run alongside it. Pick deliberately and record it in an ADR, because the choice changes what you remove.

• Exclusive (migrate off Crashlytics). Sentry becomes the only crash/error backend. Remove the Crashlytics Gradle plugin, its init/Strategy, and any ComponentRegistrar keep rule. One backend, one dashboard, simplest mental model.
• Coexist (dual). Keep Crashlytics and add Sentry. Justify why in the ADR so it reads as intentional, not indecisive — e.g. Sentry for unified cross-platform errors + release health + PII-scrubbed events + performance, Crashlytics for the Firebase-native crash channel and Google ecosystem integration. Both initialize independently; no dedup is required because they ship to different backends.

Everything below is identical for both postures except the "remove Crashlytics" step (exclusive only).

Step 1 — Add the SDK and Gradle plugins

Two Gradle plugins do different jobs. The KMP plugin installs the SDK into commonMain; the Android plugin only uploads the R8 mapping.

In gradle/libs.versions.toml:

[versions]
sentryKmp = "0.26.0"            # check latest before pinning
sentryAndroidGradle = "6.8.1"   # check latest before pinning

[plugins]
sentry-kmp = { id = "io.sentry.kotlin.multiplatform.gradle", version.ref = "sentryKmp" }
sentry-android = { id = "io.sentry.android.gradle", version.ref = "sentryAndroidGradle" }

Apply sentry-kmp in :composeApp (the module that owns the shared Sentry.init), and sentry-android in :androidApp. For iOS, add the sentry-cocoa SPM package (≥ 8.36.0) to the Xcode project — the KMP plugin links against it.