Kotlin Multiplatform SDK for recording gestures, screen views, breadcrumbs,
and crashes — then replaying them as a timeline on Android and iOS.
| 👆 Gesture recording | Captures clicks, scrolls, swipes, long presses, and pinches with zero instrumentation |
| 🗺️ Screen views | Tracks every navigation event automatically via tracey-navigation or manually |
| 🍞 Breadcrumbs | Log arbitrary events from anywhere — cart updates, API errors, feature flags |
| 💥 Crash replay | Snapshots the event ring-buffer on crash and replays it on next launch |
| 🔒 Privacy masking | Mark sensitive composables — they render normally but are blacked out in captures |
| 🔌 Custom reporters | Route captured sessions to Logcat, Crashlytics, Sentry, Slack, or your own backend |
1773644484947374.mp4
// 1. Add the dependency
commonMain.dependencies {
implementation("com.himanshoe:tracey:<version>")
}
// 2. Install once in Application.onCreate() or iOS entry point
Tracey.install(TraceyConfig(reporters = listOf(LogcatReporter())))
// 3. Wrap your root composable
setContent {
TraceyHost(traceyConfig = rememberTraceyConfig(reporters = listOf(LogcatReporter()))) {
MyApp()
}
}- Installation — all artifact variants and dependency setup
- Setup —
TraceyConfig,TraceyHost,rememberTraceyConfig - Screen tracking — automatic (Compose Nav, Nav 3) and manual
- Breadcrumbs & capture —
Tracey.log, export methods - Privacy masking —
Modifier.traceyMask()and redacted tags - Reporters — built-in reporters, log output format, custom reporters
- Platform support — Android vs iOS capabilities
Copyright 2026 Himanshu Singh
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Made with ❤️ by Himanshu Singh
