Skip to content

Analytics Module

A Kotlin Multiplatform library for capturing and visualising analytics events in real time, providing a developer-friendly interface for monitoring and debugging analytics integration in your application.

Overview

Analytics enables real-time monitoring of analytics events (screen views, custom events, etc.) with a built-in Compose UI for debugging and QA.

Features

  • Multi-type event tracking (screen, event, custom)
  • Real-time monitoring and tabular display
  • Detailed event info: tags, screen classes, timestamps
  • Built-in Compose UI
  • Type-safe API
  • Multiplatform support (Android/iOS)

Installation

Add to your build.gradle.kts: 

dependencies {
    implementation(projects.devviewAnalytics)
}

Integration Example

Add Analytics to your DevView modules list: 

val modules = rememberModules {
    module(Analytics()) // optional: pass highlightedLogType1/2/3 to customize summary chips
    // ...other modules...
}

Quick Start

Logging Analytics Events

AnalyticsLogger.log(
    AnalyticsLog(
        tag = "home_screen_view",
        screenClass = "com.example.ui.HomeScreen",
        timestamp = System.currentTimeMillis(),
        type = AnalyticsLogCategory.Screen.View
    )
)

Using the UI

// AnalyticsScreen is rendered automatically by DevView when Analytics() is registered.
// To use it standalone, provide LocalAnalytics above it:
CompositionLocalProvider(LocalAnalytics provides AnalyticsLogger.logs) {
    AnalyticsScreen(
        highlightedAnalyticsLogTypes = persistentListOf(
            AnalyticsLogCategory.Action.Click,
            AnalyticsLogCategory.Performance.Error
        )
    )
}

Usage

  • Use AnalyticsLogger.log() to record events.
  • Use AnalyticsScreen to view logs in real time.
  • Integrate with your analytics backend for dual logging.

Best Practices

  1. Use descriptive tags and include screen context.
  2. Use SCREEN for navigation, EVENT for interactions, CUSTOM for business events.
  3. Log to DevView only in debug builds for best performance.
  4. Clear logs periodically during long sessions.

Troubleshooting / FAQ

  • Why aren't my events showing up?
  • Ensure you use AnalyticsLogger.log() and provide the correct event type.
  • Confirm Compose state is correctly updated and the UI is observing the logs.
  • How do I clear logs?
  • Use AnalyticsLogger.clear() (for debug/testing only).
  • Can I use this on iOS?
  • Yes, Compose Multiplatform is supported. Ensure platform-specific initialisation is correct.
  • Integration issues?
  • Verify module is included in your DevView modules list and dependencies are present.

API Reference

Dokka API Reference