admin/honeyDueKMP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add PostHog analytics integration for Android and iOS

Browse Source 
Implement comprehensive analytics tracking across both platforms:

Android (Kotlin):
- Add PostHog SDK dependency and initialization in MainActivity
- Create expect/actual pattern for cross-platform analytics (commonMain/androidMain/iosMain/jvmMain/jsMain/wasmJsMain)
- Track screen views: registration, login, residences, tasks, contractors, documents, notifications, profile
- Track key events: user_registered, user_signed_in, residence_created, task_created, contractor_created, document_created
- Track paywall events: contractor_paywall_shown, documents_paywall_shown
- Track sharing events: residence_shared, contractor_shared
- Track theme_changed event

iOS (Swift):
- Add PostHog iOS SDK via SPM
- Create PostHogAnalytics wrapper and AnalyticsEvents constants
- Initialize SDK in iOSApp with session replay support
- Track same screen views and events as Android
- Track user identification after login/registration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Trey t
2025-12-07 23:53:00 -06:00
parent 6cbcff116f
commit c334ce0bd0
44 changed files with 623 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
composeApp/build.gradle.kts
View File

@@ -53,6 +53,9 @@ kotlin {
// implementation(libs.ktor.client.logging)
implementation(libs.kotlinx.coroutines.android)
implementation(libs.google.billing)
// PostHog Analytics
implementation("com.posthog:posthog-android:3.8.2")
}
iosMain.dependencies {
implementation(libs.ktor.client.darwin)

4
composeApp/src/androidMain/kotlin/com/example/casera/MainActivity.kt
View File

@@ -37,6 +37,7 @@ import com.example.casera.data.DataManager
import com.example.casera.data.PersistenceManager
import com.example.casera.models.CaseraPackageType
import com.example.casera.models.detectCaseraPackageType
import com.example.casera.analytics.PostHogAnalytics
import kotlinx.coroutines.launch
class MainActivity : ComponentActivity(), SingletonImageLoader.Factory {
@@ -71,6 +72,9 @@ class MainActivity : ComponentActivity(), SingletonImageLoader.Factory {
// Initialize BillingManager for subscription management
billingManager = BillingManager.getInstance(applicationContext)
// Initialize PostHog Analytics
PostHogAnalytics.initialize(application, debug = true) // Set debug=false for release
// Handle deep link, notification navigation, and file import from intent
handleDeepLink(intent)
handleNotificationNavigation(intent)

74
composeApp/src/androidMain/kotlin/com/example/casera/analytics/PostHogAnalytics.android.kt Normal file
View File

@@ -0,0 +1,74 @@
package com.example.casera.analytics
import android.app.Application
import com.posthog.PostHog
import com.posthog.android.PostHogAndroid
import com.posthog.android.PostHogAndroidConfig
/**
* Android implementation of PostHog Analytics.
*/
actual object PostHogAnalytics {
// TODO: Replace with your actual PostHog API key
private const val API_KEY = "YOUR_POSTHOG_API_KEY"
private const val HOST = "https://us.i.posthog.com"
private var isInitialized = false
private var application: Application? = null
/**
* Initialize PostHog SDK with Application context.
* Call this in MainActivity.onCreate() before using other methods.
*/
fun initialize(application: Application, debug: Boolean = false) {
if (isInitialized) return
this.application = application
val config = PostHogAndroidConfig(API_KEY, HOST).apply {
captureScreenViews = false // We'll track screens manually
captureApplicationLifecycleEvents = true
captureDeepLinks = true
this.debug = debug
// Session Replay
sessionReplay = true
sessionReplayConfig.maskAllTextInputs = true
sessionReplayConfig.maskAllImages = false
}
PostHogAndroid.setup(application, config)
isInitialized = true
}
/**
* Initialize from common code (no-op on Android, use initialize(Application) instead)
*/
actual fun initialize() {
// No-op - Android requires Application context, use initialize(Application) instead
}
actual fun identify(userId: String, properties: Map<String, Any>?) {
if (!isInitialized) return
PostHog.identify(userId, userProperties = properties)
}
actual fun capture(event: String, properties: Map<String, Any>?) {
if (!isInitialized) return
PostHog.capture(event, properties = properties)
}
actual fun screen(screenName: String, properties: Map<String, Any>?) {
if (!isInitialized) return
PostHog.screen(screenName, properties = properties)
}
actual fun reset() {
if (!isInitialized) return
PostHog.reset()
}
actual fun flush() {
if (!isInitialized) return
PostHog.flush()
}
}

4
composeApp/src/androidMain/kotlin/com/example/casera/platform/ContractorSharing.android.kt
View File

@@ -5,6 +5,8 @@ import androidx.compose.runtime.Composable
import androidx.compose.ui.platform.LocalContext
import com.example.casera.models.Contractor
import com.example.casera.sharing.ContractorSharingManager
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
@Composable
actual fun rememberShareContractor(): (Contractor) -> Unit {
@@ -13,6 +15,8 @@ actual fun rememberShareContractor(): (Contractor) -> Unit {
return { contractor: Contractor ->
val intent = ContractorSharingManager.createShareIntent(context, contractor)
if (intent != null) {
// Track contractor shared event
PostHogAnalytics.capture(AnalyticsEvents.CONTRACTOR_SHARED)
context.startActivity(Intent.createChooser(intent, "Share Contractor"))
}
}

7
composeApp/src/androidMain/kotlin/com/example/casera/platform/ResidenceSharing.android.kt
View File

@@ -10,6 +10,8 @@ import androidx.compose.runtime.setValue
import androidx.compose.ui.platform.LocalContext
import com.example.casera.models.Residence
import com.example.casera.sharing.ResidenceSharingManager
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import kotlinx.coroutines.launch
@Composable
@@ -25,6 +27,11 @@ actual fun rememberShareResidence(): Pair<ResidenceSharingState, (Residence) ->
val intent = ResidenceSharingManager.createShareIntent(context, residence)
if (intent != null) {
state = ResidenceSharingState(isLoading = false)
// Track residence shared event
PostHogAnalytics.capture(
AnalyticsEvents.RESIDENCE_SHARED,
mapOf("method" to "file")
)
context.startActivity(Intent.createChooser(intent, "Share Residence"))
} else {
state = ResidenceSharingState(

61
composeApp/src/commonMain/kotlin/com/example/casera/analytics/Analytics.kt Normal file
View File

@@ -0,0 +1,61 @@
package com.example.casera.analytics
/**
* Common analytics interface for cross-platform event tracking.
* Platform-specific implementations use PostHog SDKs.
*/
expect object PostHogAnalytics {
fun initialize()
fun identify(userId: String, properties: Map<String, Any>? = null)
fun capture(event: String, properties: Map<String, Any>? = null)
fun screen(screenName: String, properties: Map<String, Any>? = null)
fun reset()
fun flush()
}
/**
* Analytics event names - use these constants for consistency across the app
*/
object AnalyticsEvents {
// Authentication
const val REGISTRATION_SCREEN_SHOWN = "registration_screen_shown"
const val USER_REGISTERED = "user_registered"
const val USER_SIGNED_IN = "user_signed_in"
const val USER_SIGNED_IN_APPLE = "user_signed_in_apple"
// Residence
const val RESIDENCE_SCREEN_SHOWN = "residence_screen_shown"
const val NEW_RESIDENCE_SCREEN_SHOWN = "new_residence_screen_shown"
const val RESIDENCE_CREATED = "residence_created"
const val RESIDENCE_LIMIT_REACHED = "residence_limit_reached"
// Task
const val TASK_SCREEN_SHOWN = "task_screen_shown"
const val NEW_TASK_SCREEN_SHOWN = "new_task_screen_shown"
const val TASK_CREATED = "task_created"
// Contractor
const val CONTRACTOR_SCREEN_SHOWN = "contractor_screen_shown"
const val NEW_CONTRACTOR_SCREEN_SHOWN = "new_contractor_screen_shown"
const val CONTRACTOR_CREATED = "contractor_created"
const val CONTRACTOR_PAYWALL_SHOWN = "contractor_paywall_shown"
// Documents
const val DOCUMENTS_SCREEN_SHOWN = "documents_screen_shown"
const val NEW_DOCUMENT_SCREEN_SHOWN = "new_document_screen_shown"
const val DOCUMENT_CREATED = "document_created"
const val DOCUMENTS_PAYWALL_SHOWN = "documents_paywall_shown"
// Sharing
const val SHARE_RESIDENCE_SCREEN_SHOWN = "share_residence_screen_shown"
const val RESIDENCE_SHARED = "residence_shared"
const val SHARE_RESIDENCE_PAYWALL_SHOWN = "share_residence_paywall_shown"
const val SHARE_CONTRACTOR_SCREEN_SHOWN = "share_contractor_screen_shown"
const val CONTRACTOR_SHARED = "contractor_shared"
const val SHARE_CONTRACTOR_PAYWALL_SHOWN = "share_contractor_paywall_shown"
// Settings
const val NOTIFICATION_SETTINGS_SCREEN_SHOWN = "notification_settings_screen_shown"
const val SETTINGS_SCREEN_SHOWN = "settings_screen_shown"
const val THEME_CHANGED = "theme_changed"
}

8
composeApp/src/commonMain/kotlin/com/example/casera/ui/components/AddContractorDialog.kt
View File

@@ -20,6 +20,8 @@ import com.example.casera.models.ContractorUpdateRequest
import com.example.casera.models.Residence
import com.example.casera.network.ApiResult
import com.example.casera.repository.LookupsRepository
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
@OptIn(ExperimentalMaterial3Api::class)
@Composable
@@ -53,8 +55,11 @@ fun AddContractorDialog(
var expandedResidenceMenu by remember { mutableStateOf(false) }
val contractorSpecialties by LookupsRepository.contractorSpecialties.collectAsState()
// Load residences for picker
// Track screen view and load residences for picker
LaunchedEffect(Unit) {
if (contractorId == null) {
PostHogAnalytics.screen(AnalyticsEvents.NEW_CONTRACTOR_SCREEN_SHOWN)
}
residenceViewModel.loadResidences()
}
@@ -91,6 +96,7 @@ fun AddContractorDialog(
LaunchedEffect(createState) {
if (createState is ApiResult.Success) {
PostHogAnalytics.capture(AnalyticsEvents.CONTRACTOR_CREATED)
onContractorSaved()
viewModel.resetCreateState()
}

7
composeApp/src/commonMain/kotlin/com/example/casera/ui/components/AddTaskDialog.kt
View File

@@ -22,6 +22,8 @@ import com.example.casera.models.TaskCategory
import com.example.casera.models.TaskCreateRequest
import com.example.casera.models.TaskFrequency
import com.example.casera.models.TaskPriority
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
@OptIn(ExperimentalMaterial3Api::class)
@Composable
@@ -110,6 +112,11 @@ fun AddTaskDialog(
showSuggestions = false
}
// Track screen view
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.NEW_TASK_SCREEN_SHOWN)
}
// Set defaults when data loads
LaunchedEffect(frequencies) {
if (frequencies.isNotEmpty()) {

7
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/ContractorsScreen.kt
View File

@@ -29,6 +29,8 @@ import com.example.casera.network.ApiResult
import com.example.casera.repository.LookupsRepository
import com.example.casera.ui.subscription.UpgradeFeatureScreen
import com.example.casera.utils.SubscriptionHelper
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -58,6 +60,7 @@ fun ContractorsScreen(
var isRefreshing by remember { mutableStateOf(false) }
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.CONTRACTOR_SCREEN_SHOWN)
viewModel.loadContractors()
}
@@ -182,6 +185,10 @@ fun ContractorsScreen(
if (canAdd.allowed) {
showAddDialog = true
} else {
PostHogAnalytics.capture(
AnalyticsEvents.CONTRACTOR_PAYWALL_SHOWN,
mapOf("current_count" to currentCount)
)
showUpgradeDialog = true
}
},

21
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/DocumentFormScreen.kt
View File

@@ -26,6 +26,8 @@ import com.example.casera.network.ApiResult
import com.example.casera.platform.ImageData
import com.example.casera.platform.rememberImagePicker
import com.example.casera.platform.rememberCameraPicker
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
@OptIn(ExperimentalMaterial3Api::class)
@Composable
@@ -103,6 +105,17 @@ fun DocumentFormScreen(
}
}
// Track screen view
LaunchedEffect(Unit) {
if (!isEditMode) {
val type = if (initialDocumentType == "warranty") "warranty" else "document"
PostHogAnalytics.screen(
AnalyticsEvents.NEW_DOCUMENT_SCREEN_SHOWN,
mapOf("type" to type)
)
}
}
// Load residences if needed
LaunchedEffect(needsResidenceSelection) {
if (needsResidenceSelection) {
@@ -148,6 +161,14 @@ fun DocumentFormScreen(
// Handle success
LaunchedEffect(operationState) {
if (operationState is ApiResult.Success) {
if (!isEditMode) {
// Track document creation
val type = if (selectedDocumentType == "warranty") "warranty" else "document"
PostHogAnalytics.capture(
AnalyticsEvents.DOCUMENT_CREATED,
mapOf("type" to type)
)
}
if (isEditMode) {
documentViewModel.resetUpdateState()
} else {

8
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/DocumentsScreen.kt
View File

@@ -16,6 +16,8 @@ import com.example.casera.ui.subscription.UpgradeFeatureScreen
import com.example.casera.utils.SubscriptionHelper
import com.example.casera.viewmodel.DocumentViewModel
import com.example.casera.models.*
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -47,6 +49,8 @@ fun DocumentsScreen(
var showUpgradeDialog by remember { mutableStateOf(false) }
LaunchedEffect(Unit) {
// Track screen view
PostHogAnalytics.screen(AnalyticsEvents.DOCUMENTS_SCREEN_SHOWN)
// Load warranties by default (documentType="warranty")
documentViewModel.loadDocuments(
residenceId = residenceId,
@@ -180,6 +184,10 @@ fun DocumentsScreen(
// Pass residenceId even if null - AddDocumentScreen will handle it
onNavigateToAddDocument(residenceId ?: -1, documentType)
} else {
PostHogAnalytics.capture(
AnalyticsEvents.DOCUMENTS_PAYWALL_SHOWN,
mapOf("current_count" to currentCount)
)
showUpgradeDialog = true
}
},

5
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/LoginScreen.kt
View File

@@ -26,6 +26,8 @@ import com.example.casera.ui.components.auth.AuthHeader
import com.example.casera.ui.components.common.ErrorCard
import com.example.casera.viewmodel.AuthViewModel
import com.example.casera.network.ApiResult
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -52,6 +54,9 @@ fun LoginScreen(
when (loginState) {
is ApiResult.Success -> {
val user = (loginState as ApiResult.Success).data.user
// Track successful login
PostHogAnalytics.capture(AnalyticsEvents.USER_SIGNED_IN, mapOf("method" to "email"))
PostHogAnalytics.identify(user.id.toString(), mapOf("email" to (user.email ?: ""), "username" to (user.username ?: "")))
onLoginSuccess(user)
}
else -> {}

5
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/NotificationPreferencesScreen.kt
View File

@@ -19,6 +19,8 @@ import com.example.casera.ui.theme.AppRadius
import com.example.casera.ui.theme.AppSpacing
import com.example.casera.util.DateUtils
import com.example.casera.viewmodel.NotificationPreferencesViewModel
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -56,8 +58,9 @@ fun NotificationPreferencesScreen(
val defaultTaskOverdueLocalHour = 9 // 9 AM local
val defaultDailyDigestLocalHour = 8 // 8 AM local
// Load preferences on first render
// Track screen view and load preferences on first render
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.NOTIFICATION_SETTINGS_SCREEN_SHOWN)
viewModel.loadPreferences()
}

10
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/ProfileScreen.kt
View File

@@ -29,6 +29,8 @@ import com.example.casera.storage.TokenStorage
import com.example.casera.cache.SubscriptionCache
import com.example.casera.ui.subscription.UpgradePromptDialog
import androidx.compose.runtime.getValue
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -66,8 +68,9 @@ fun ProfileScreen(
errorTitle = stringResource(Res.string.profile_update_failed)
)
// Load current user data
// Track screen view and load current user data
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.SETTINGS_SCREEN_SHOWN)
val token = TokenStorage.getToken()
if (token != null) {
val authApi = com.example.casera.network.AuthApi()
@@ -528,6 +531,11 @@ fun ProfileScreen(
currentTheme = currentTheme,
onThemeSelected = { theme ->
ThemeManager.setTheme(theme)
// Track theme change
PostHogAnalytics.capture(
AnalyticsEvents.THEME_CHANGED,
mapOf("theme" to theme.id)
)
showThemePicker = false
},
onDismiss = { showThemePicker = false }

11
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/RegisterScreen.kt
View File

@@ -19,6 +19,8 @@ import com.example.casera.ui.components.auth.AuthHeader
import com.example.casera.ui.components.common.ErrorCard
import com.example.casera.viewmodel.AuthViewModel
import com.example.casera.network.ApiResult
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -44,9 +46,18 @@ fun RegisterScreen(
errorTitle = stringResource(Res.string.error_generic)
)
// Track screen view
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.REGISTRATION_SCREEN_SHOWN)
}
LaunchedEffect(createState) {
when (createState) {
is ApiResult.Success -> {
// Track successful registration
val user = (createState as ApiResult.Success).data.user
PostHogAnalytics.capture(AnalyticsEvents.USER_REGISTERED, mapOf("method" to "email"))
PostHogAnalytics.identify(user.id.toString(), mapOf("email" to (user.email ?: ""), "username" to (user.username ?: "")))
viewModel.resetRegisterState()
onRegisterSuccess()
}

7
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/ResidenceDetailScreen.kt
View File

@@ -37,6 +37,8 @@ import com.example.casera.cache.SubscriptionCache
import com.example.casera.data.DataManager
import com.example.casera.util.DateUtils
import com.example.casera.platform.rememberShareResidence
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -126,6 +128,11 @@ fun ResidenceDetailScreen(
LaunchedEffect(taskAddNewTaskState) {
when (taskAddNewTaskState) {
is ApiResult.Success -> {
// Track task creation
PostHogAnalytics.capture(
AnalyticsEvents.TASK_CREATED,
mapOf("residence_id" to residenceId)
)
showNewTaskDialog = false
taskViewModel.resetAddTaskState()
residenceViewModel.loadResidenceTasks(residenceId)

13
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/ResidenceFormScreen.kt
View File

@@ -24,6 +24,8 @@ import com.example.casera.models.ResidenceUser
import com.example.casera.network.ApiResult
import com.example.casera.network.ResidenceApi
import com.example.casera.storage.TokenStorage
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import kotlinx.coroutines.launch
import org.jetbrains.compose.resources.stringResource
@@ -102,6 +104,13 @@ fun ResidenceFormScreen(
// Validation errors
var nameError by remember { mutableStateOf("") }
// Track screen view
LaunchedEffect(Unit) {
if (!isEditMode) {
PostHogAnalytics.screen(AnalyticsEvents.NEW_RESIDENCE_SCREEN_SHOWN)
}
}
// Handle operation state changes
LaunchedEffect(operationState) {
when (operationState) {
@@ -109,6 +118,10 @@ fun ResidenceFormScreen(
if (isEditMode) {
viewModel.resetUpdateState()
} else {
// Track residence created
PostHogAnalytics.capture(AnalyticsEvents.RESIDENCE_CREATED, mapOf(
"residence_type" to (propertyType?.name ?: "unknown")
))
viewModel.resetCreateState()
}
onSuccess()

4
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/ResidencesScreen.kt
View File

@@ -29,6 +29,8 @@ import com.example.casera.network.ApiResult
import com.example.casera.utils.SubscriptionHelper
import com.example.casera.ui.subscription.UpgradePromptDialog
import com.example.casera.cache.SubscriptionCache
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -59,7 +61,9 @@ fun ResidencesScreen(
return Pair(check.allowed, check.triggerKey)
}
// Track screen view
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.RESIDENCE_SCREEN_SHOWN)
viewModel.loadMyResidences()
}

3
composeApp/src/commonMain/kotlin/com/example/casera/ui/screens/TasksScreen.kt
View File

@@ -19,6 +19,8 @@ import com.example.casera.ui.utils.hexToColor
import com.example.casera.viewmodel.TaskCompletionViewModel
import com.example.casera.viewmodel.TaskViewModel
import com.example.casera.network.ApiResult
import com.example.casera.analytics.PostHogAnalytics
import com.example.casera.analytics.AnalyticsEvents
import casera.composeapp.generated.resources.*
import org.jetbrains.compose.resources.stringResource
@@ -47,6 +49,7 @@ fun TasksScreen(
}
LaunchedEffect(Unit) {
PostHogAnalytics.screen(AnalyticsEvents.TASK_SCREEN_SHOWN)
viewModel.loadTasks()
}

32
composeApp/src/iosMain/kotlin/com/example/casera/analytics/PostHogAnalytics.ios.kt Normal file
View File

@@ -0,0 +1,32 @@
package com.example.casera.analytics
/**
* iOS implementation of PostHog Analytics.
* Note: The actual PostHog SDK calls are made from Swift code.
* This is a stub that does nothing - iOS uses the native Swift wrapper directly.
*/
actual object PostHogAnalytics {
actual fun initialize() {
// iOS initialization is done in Swift via PostHogAnalytics.swift
}
actual fun identify(userId: String, properties: Map<String, Any>?) {
// iOS uses Swift PostHogAnalytics.shared.identify() directly
}
actual fun capture(event: String, properties: Map<String, Any>?) {
// iOS uses Swift PostHogAnalytics.shared.capture() directly
}
actual fun screen(screenName: String, properties: Map<String, Any>?) {
// iOS uses Swift PostHogAnalytics.shared.screen() directly
}
actual fun reset() {
// iOS uses Swift PostHogAnalytics.shared.reset() directly
}
actual fun flush() {
// iOS uses Swift PostHogAnalytics.shared.flush() directly
}
}

31
composeApp/src/jsMain/kotlin/com/example/casera/analytics/PostHogAnalytics.js.kt Normal file
View File

@@ -0,0 +1,31 @@
package com.example.casera.analytics
/**
* JS/Web implementation of PostHog Analytics.
* Currently a no-op stub - could be implemented with PostHog JS SDK.
*/
actual object PostHogAnalytics {
actual fun initialize() {
// No-op for web
}
actual fun identify(userId: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun capture(event: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun screen(screenName: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun reset() {
// No-op for web
}
actual fun flush() {
// No-op for web
}
}

31
composeApp/src/jvmMain/kotlin/com/example/casera/analytics/PostHogAnalytics.jvm.kt Normal file
View File

@@ -0,0 +1,31 @@
package com.example.casera.analytics
/**
* JVM/Desktop implementation of PostHog Analytics.
* Currently a no-op stub - PostHog doesn't have a native JVM SDK.
*/
actual object PostHogAnalytics {
actual fun initialize() {
// No-op for desktop
}
actual fun identify(userId: String, properties: Map<String, Any>?) {
// No-op for desktop
}
actual fun capture(event: String, properties: Map<String, Any>?) {
// No-op for desktop
}
actual fun screen(screenName: String, properties: Map<String, Any>?) {
// No-op for desktop
}
actual fun reset() {
// No-op for desktop
}
actual fun flush() {
// No-op for desktop
}
}

31
composeApp/src/wasmJsMain/kotlin/com/example/casera/analytics/PostHogAnalytics.wasmJs.kt Normal file
View File

@@ -0,0 +1,31 @@
package com.example.casera.analytics
/**
* WasmJS/Web implementation of PostHog Analytics.
* Currently a no-op stub - could be implemented with PostHog JS SDK.
*/
actual object PostHogAnalytics {
actual fun initialize() {
// No-op for web
}
actual fun identify(userId: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun capture(event: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun screen(screenName: String, properties: Map<String, Any>?) {
// No-op for web
}
actual fun reset() {
// No-op for web
}
actual fun flush() {
// No-op for web
}
}

25
iosApp/iosApp.xcodeproj/project.pbxproj
View File

@@ -14,6 +14,7 @@
1C81F2772EE416EF000739EA /* CaseraQLPreview.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 1C81F2692EE416EE000739EA /* CaseraQLPreview.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; };
1C81F2822EE41BB6000739EA /* QuickLookThumbnailing.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1C81F2812EE41BB6000739EA /* QuickLookThumbnailing.framework */; };
1C81F2892EE41BB6000739EA /* CaseraQLThumbnail.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 1C81F2802EE41BB6000739EA /* CaseraQLThumbnail.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; };
1C81F3902EE69AF1000739EA /* PostHog in Frameworks */ = {isa = PBXBuildFile; productRef = 1C81F38F2EE69AF1000739EA /* PostHog */; };
/* End PBXBuildFile section */
/* Begin PBXContainerItemProxy section */
@@ -256,6 +257,7 @@
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
1C81F3902EE69AF1000739EA /* PostHog in Frameworks */,
);
runOnlyForDeploymentPostprocessing = 0;
};
@@ -450,6 +452,7 @@
);
name = Casera;
packageProductDependencies = (
1C81F38F2EE69AF1000739EA /* PostHog */,
);
productName = iosApp;
productReference = 96A3DDC05E14B3F83E56282F /* Casera.app */;
@@ -496,6 +499,9 @@
);
mainGroup = 86BC7E88090398B44B7DB0E4;
minimizedProjectReferenceProxies = 1;
packageReferences = (
1C81F38E2EE69698000739EA /* XCRemoteSwiftPackageReference "posthog-ios" */,
);
preferredProjectObjectVersion = 77;
productRefGroup = FA6022B7B844191C54E57EB4 /* Products */;
projectDirPath = "";
@@ -1198,6 +1204,25 @@
defaultConfigurationName = Release;
};
/* End XCConfigurationList section */
/* Begin XCRemoteSwiftPackageReference section */
1C81F38E2EE69698000739EA /* XCRemoteSwiftPackageReference "posthog-ios" */ = {
isa = XCRemoteSwiftPackageReference;
repositoryURL = "https://github.com/PostHog/posthog-ios.git";
requirement = {
kind = upToNextMajorVersion;
minimumVersion = 3.35.1;
};
};
/* End XCRemoteSwiftPackageReference section */
/* Begin XCSwiftPackageProductDependency section */
1C81F38F2EE69AF1000739EA /* PostHog */ = {
isa = XCSwiftPackageProductDependency;
package = 1C81F38E2EE69698000739EA /* XCRemoteSwiftPackageReference "posthog-ios" */;
productName = PostHog;
};
/* End XCSwiftPackageProductDependency section */
};
rootObject = 6A3E1D84F9F1A2FD92A75A6C /* Project object */;
}

15
iosApp/iosApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved Normal file
View File

@@ -0,0 +1,15 @@
{
"originHash" : "47cbe4ef2adc7155b834c1fb5ae451e260f9ef6ba19f0658c4fcafd3565fad48",
"pins" : [
{
"identity" : "posthog-ios",
"kind" : "remoteSourceControl",
"location" : "https://github.com/PostHog/posthog-ios.git",
"state" : {
"revision" : "fac9fc77380d2a38c3389f3cf4505a534921ee41",
"version" : "3.35.1"
}
}
],
"version" : 3
}

116
iosApp/iosApp/Analytics/PostHogAnalytics.swift Normal file
View File

@@ -0,0 +1,116 @@
import Foundation
import PostHog
/// PostHog Analytics wrapper for iOS.
/// Provides a simple interface for tracking events, screens, and user identification.
final class PostHogAnalytics {
static let shared = PostHogAnalytics()
// TODO: Replace with your actual PostHog API key
private let apiKey = "phc_zAf8ZEwHtr4zB6UgheP1epStBTNKP8mDBMtwzQ0BzfU"
private let host = "https://us.i.posthog.com"
private var isInitialized = false
private init() {}
/// Initialize PostHog SDK. Call this in App.init()
func initialize() {
guard !isInitialized else { return }
let config = PostHogConfig(apiKey: apiKey, host: host)
config.captureScreenViews = false // We'll track screens manually for SwiftUI
config.captureApplicationLifecycleEvents = true
#if DEBUG
config.debug = true
#endif
// Session Replay (required for SwiftUI: use screenshot mode)
config.sessionReplay = true
config.sessionReplayConfig.screenshotMode = true // Required for SwiftUI
config.sessionReplayConfig.maskAllTextInputs = true // Privacy: mask text inputs
config.sessionReplayConfig.maskAllImages = false
PostHogSDK.shared.setup(config)
isInitialized = true
}
/// Identify a user. Call this after successful login/registration.
/// This links all future events to this user ID.
func identify(_ userId: String, properties: [String: Any]? = nil) {
guard isInitialized else { return }
PostHogSDK.shared.identify(userId, userProperties: properties)
}
/// Capture a custom event with optional properties.
/// Use format: "object_action" (e.g., "residence_created", "task_completed")
func capture(_ event: String, properties: [String: Any]? = nil) {
guard isInitialized else { return }
PostHogSDK.shared.capture(event, properties: properties)
}
/// Track a screen view. Call this when a screen appears.
func screen(_ screenName: String, properties: [String: Any]? = nil) {
guard isInitialized else { return }
PostHogSDK.shared.screen(screenName, properties: properties)
}
/// Reset the user identity. Call this on logout.
/// This starts a new anonymous session.
func reset() {
guard isInitialized else { return }
PostHogSDK.shared.reset()
}
/// Flush any queued events immediately.
func flush() {
guard isInitialized else { return }
PostHogSDK.shared.flush()
}
}
/// Analytics event names - use these constants for consistency across the app
enum AnalyticsEvents {
// Authentication
static let registrationScreenShown = "registration_screen_shown"
static let userRegistered = "user_registered"
static let userSignedIn = "user_signed_in"
static let userSignedInApple = "user_signed_in_apple"
// Residence
static let residenceScreenShown = "residence_screen_shown"
static let newResidenceScreenShown = "new_residence_screen_shown"
static let residenceCreated = "residence_created"
static let residenceLimitReached = "residence_limit_reached"
// Task
static let taskScreenShown = "task_screen_shown"
static let newTaskScreenShown = "new_task_screen_shown"
static let taskCreated = "task_created"
// Contractor
static let contractorScreenShown = "contractor_screen_shown"
static let newContractorScreenShown = "new_contractor_screen_shown"
static let contractorCreated = "contractor_created"
static let contractorPaywallShown = "contractor_paywall_shown"
// Documents
static let documentsScreenShown = "documents_screen_shown"
static let newDocumentScreenShown = "new_document_screen_shown"
static let documentCreated = "document_created"
static let documentsPaywallShown = "documents_paywall_shown"
// Sharing
static let shareResidenceScreenShown = "share_residence_screen_shown"
static let residenceShared = "residence_shared"
static let shareResidencePaywallShown = "share_residence_paywall_shown"
static let shareContractorScreenShown = "share_contractor_screen_shown"
static let contractorShared = "contractor_shared"
static let shareContractorPaywallShown = "share_contractor_paywall_shown"
// Settings
static let notificationSettingsScreenShown = "notification_settings_screen_shown"
static let settingsScreenShown = "settings_screen_shown"
static let themeChanged = "theme_changed"
}

6
iosApp/iosApp/Contractor/ContractorFormSheet.swift
View File

@@ -284,6 +284,10 @@ struct ContractorFormSheet: View {
specialtyPickerSheet
}
.onAppear {
// Track screen view for new contractors
if contractor == nil {
PostHogAnalytics.shared.screen(AnalyticsEvents.newContractorScreenShown)
}
residenceViewModel.loadMyResidences()
loadContractorData()
}
@@ -493,6 +497,8 @@ struct ContractorFormSheet: View {
viewModel.createContractor(request: request) { success in
if success {
// Track contractor creation
PostHogAnalytics.shared.capture(AnalyticsEvents.contractorCreated)
onSave()
dismiss()
}

2
iosApp/iosApp/Contractor/ContractorSharingManager.swift
View File

@@ -59,6 +59,8 @@ class ContractorSharingManager: ObservableObject {
do {
try jsonData.write(to: tempURL)
// Track contractor shared event
PostHogAnalytics.shared.capture(AnalyticsEvents.contractorShared)
return tempURL
} catch {
print("ContractorSharingManager: Failed to write .casera file: \(error)")

6
iosApp/iosApp/Contractor/ContractorsListView.swift
View File

@@ -144,7 +144,10 @@ struct ContractorsListView: View {
// Add Button (disabled when showing upgrade screen)
Button(action: {
if subscriptionCache.shouldShowUpgradePrompt(currentCount: viewModel.contractors.count, limitKey: "contractors") {
let currentCount = viewModel.contractors.count
if subscriptionCache.shouldShowUpgradePrompt(currentCount: currentCount, limitKey: "contractors") {
// Track paywall shown
PostHogAnalytics.shared.capture(AnalyticsEvents.contractorPaywallShown, properties: ["current_count": currentCount])
showingUpgradePrompt = true
} else {
showingAddSheet = true
@@ -171,6 +174,7 @@ struct ContractorsListView: View {
UpgradePromptView(triggerKey: "view_contractors", isPresented: $showingUpgradePrompt)
}
.onAppear {
PostHogAnalytics.shared.screen(AnalyticsEvents.contractorScreenShown)
loadContractors()
}
// No need for onChange on searchText - filtering is client-side

8
iosApp/iosApp/Documents/DocumentFormView.swift
View File

@@ -243,6 +243,11 @@ struct DocumentFormView: View {
}
}
.onAppear {
// Track screen view for new documents
if !isEditMode {
let docType = isWarranty ? "warranty" : "document"
PostHogAnalytics.shared.screen(AnalyticsEvents.newDocumentScreenShown, properties: ["type": docType])
}
if needsResidenceSelection {
residenceViewModel.loadMyResidences()
}
@@ -491,6 +496,9 @@ struct DocumentFormView: View {
) { success, error in
isProcessing = false
if success {
// Track document creation
let docType = isWarranty ? "warranty" : "document"
PostHogAnalytics.shared.capture(AnalyticsEvents.documentCreated, properties: ["type": docType])
// Reload documents to show new item
documentViewModel.loadDocuments(residenceId: actualResidenceId)
isPresented = false

4
iosApp/iosApp/Documents/DocumentsWarrantiesView.swift
View File

@@ -179,6 +179,8 @@ struct DocumentsWarrantiesView: View {
// Check LIVE document count before adding
let currentCount = documentViewModel.documents.count
if subscriptionCache.shouldShowUpgradePrompt(currentCount: currentCount, limitKey: "documents") {
// Track paywall shown
PostHogAnalytics.shared.capture(AnalyticsEvents.documentsPaywallShown, properties: ["current_count": currentCount])
showingUpgradePrompt = true
} else {
showAddSheet = true
@@ -192,6 +194,8 @@ struct DocumentsWarrantiesView: View {
}
}
.onAppear {
// Track screen view
PostHogAnalytics.shared.screen(AnalyticsEvents.documentsScreenShown)
// Load all documents once - filtering is client-side
loadAllDocuments()
}

9
iosApp/iosApp/Login/AppleSignInViewModel.swift
View File

@@ -85,6 +85,15 @@ class AppleSignInViewModel: ObservableObject {
// - Initializes lookups
// - Prefetches all data
// Track Apple Sign In
PostHogAnalytics.shared.capture(AnalyticsEvents.userSignedInApple, properties: [
"is_new_user": isNewUser
])
PostHogAnalytics.shared.identify(
String(user.id),
properties: ["email": user.email ?? "", "username": user.username]
)
print("Apple Sign In successful! User: \(user.username), New user: \(isNewUser)")
// Call success callback with verification status

10
iosApp/iosApp/Login/LoginViewModel.swift
View File

@@ -73,6 +73,13 @@ class LoginViewModel: ObservableObject {
print("Login successful!")
print("User: \(response.user.username ?? "unknown"), Verified: \(self.isVerified)")
// Track successful login
PostHogAnalytics.shared.capture(AnalyticsEvents.userSignedIn, properties: ["method": "email"])
PostHogAnalytics.shared.identify(
String(response.user.id),
properties: ["email": response.user.email ?? "", "username": response.user.username ?? ""]
)
// Initialize lookups via APILayer
Task {
_ = try? await APILayer.shared.initializeLookups()
@@ -117,6 +124,9 @@ class LoginViewModel: ObservableObject {
// APILayer.logout clears DataManager
try? await APILayer.shared.logout()
// Reset PostHog user identity
PostHogAnalytics.shared.reset()
// Clear widget task data
WidgetDataManager.shared.clearCache()

2
iosApp/iosApp/Profile/NotificationPreferencesView.swift
View File

@@ -297,6 +297,8 @@ struct NotificationPreferencesView: View {
}
}
.onAppear {
// Track screen view
PostHogAnalytics.shared.screen(AnalyticsEvents.notificationSettingsScreenShown)
viewModel.loadPreferences()
}
}

3
iosApp/iosApp/Profile/ProfileTabView.swift
View File

@@ -208,6 +208,9 @@ struct ProfileTabView: View {
} message: {
Text(L10n.Profile.purchasesRestoredMessage)
}
.onAppear {
PostHogAnalytics.shared.screen(AnalyticsEvents.settingsScreenShown)
}
}
private func sendSupportEmail() {

3
iosApp/iosApp/Profile/ThemeSelectionView.swift
View File

@@ -39,6 +39,9 @@ struct ThemeSelectionView: View {
let generator = UIImpactFeedbackGenerator(style: .medium)
generator.impactOccurred()
// Track theme change
PostHogAnalytics.shared.capture(AnalyticsEvents.themeChanged, properties: ["theme": theme.rawValue])
// Update theme with animation
themeManager.setTheme(theme)
}

3
iosApp/iosApp/Register/RegisterView.swift
View File

@@ -152,6 +152,9 @@ struct RegisterView: View {
error: viewModel.errorMessage,
onRetry: { viewModel.register() }
)
.onAppear {
PostHogAnalytics.shared.screen(AnalyticsEvents.registrationScreenShown)
}
}
}
}

9
iosApp/iosApp/Register/RegisterViewModel.swift
View File

@@ -49,12 +49,19 @@ class RegisterViewModel: ObservableObject {
let request = RegisterRequest(username: username, email: email, password: password, firstName: nil, lastName: nil)
let result = try await APILayer.shared.register(request: request)
if let success = result as? ApiResultSuccess<AuthResponse>, let _ = success.data {
if let success = result as? ApiResultSuccess<AuthResponse>, let response = success.data {
// APILayer.register() now handles:
// - Setting auth token in DataManager
// - Storing token in TokenManager
// - Initializing lookups
// Track successful registration
PostHogAnalytics.shared.capture(AnalyticsEvents.userRegistered, properties: ["method": "email"])
PostHogAnalytics.shared.identify(
String(response.user.id),
properties: ["email": response.user.email ?? "", "username": response.user.username ?? ""]
)
// Update AuthenticationManager - user is authenticated but NOT verified
AuthenticationManager.shared.login(verified: false)

2
iosApp/iosApp/Residence/ResidenceSharingManager.swift
View File

@@ -89,6 +89,8 @@ class ResidenceSharingManager: ObservableObject {
do {
try jsonData.write(to: tempURL)
// Track residence shared event
PostHogAnalytics.shared.capture(AnalyticsEvents.residenceShared, properties: ["method": "file"])
return tempURL
} catch {
print("ResidenceSharingManager: Failed to write .casera file: \(error)")

1
iosApp/iosApp/Residence/ResidencesListView.swift
View File

@@ -111,6 +111,7 @@ struct ResidencesListView: View {
}
}
.onAppear {
PostHogAnalytics.shared.screen(AnalyticsEvents.residenceScreenShown)
if authManager.isAuthenticated {
viewModel.loadMyResidences()
}

7
iosApp/iosApp/ResidenceFormView.swift
View File

@@ -230,6 +230,9 @@ struct ResidenceFormView: View {
}
}
.onAppear {
if !isEditMode {
PostHogAnalytics.shared.screen(AnalyticsEvents.newResidenceScreenShown)
}
loadResidenceTypes()
initializeForm()
if isEditMode && isCurrentUserOwner {
@@ -368,6 +371,10 @@ struct ResidenceFormView: View {
// Add mode
viewModel.createResidence(request: request) { success in
if success {
// Track residence created
PostHogAnalytics.shared.capture(AnalyticsEvents.residenceCreated, properties: [
"residence_type": selectedPropertyType?.name ?? "unknown"
])
onSuccess?()
isPresented = false
}

1
iosApp/iosApp/Task/AllTasksView.swift
View File

@@ -97,6 +97,7 @@ struct AllTasksView: View {
}
}
.onAppear {
PostHogAnalytics.shared.screen(AnalyticsEvents.taskScreenShown)
loadAllTasks()
residenceViewModel.loadMyResidences()
}

6
iosApp/iosApp/Task/TaskFormView.swift
View File

@@ -312,6 +312,10 @@ struct TaskFormView: View {
}
}
.onAppear {
// Track screen view for new tasks
if !isEditMode {
PostHogAnalytics.shared.screen(AnalyticsEvents.newTaskScreenShown)
}
// Set defaults when lookups are available
if dataManager.lookupsInitialized {
setDefaults()
@@ -520,6 +524,8 @@ struct TaskFormView: View {
viewModel.createTask(request: request) { success in
if success {
// Track task creation
PostHogAnalytics.shared.capture(AnalyticsEvents.taskCreated, properties: ["residence_id": actualResidenceId])
// View will dismiss automatically via onChange
}
}

3
iosApp/iosApp/iOSApp.swift
View File

@@ -32,6 +32,9 @@ struct iOSApp: App {
// Initialize TokenStorage once at app startup (legacy support)
TokenStorage.shared.initialize(manager: TokenManager.Companion.shared.getInstance())
// Initialize PostHog Analytics
PostHogAnalytics.shared.initialize()
// Initialize lookups at app start (public endpoints, no auth required)
// This fetches /static_data/ and /upgrade-triggers/ immediately
Task {