Skip to main content

Analytics Events

FocusFlow analytics event names use result-style names such as Started, Completed, Viewed, Created, Copied, and Tapped. Add or update rows here in the same change that adds or renames an AnalyticsEvent constant.

Desktop Events

Source: apps/desktop/src/renderer/core/analytics/events.ts

EventTriggerProperties
Accessibility Permission CompletedAccessibility permission request resolves or fails during onboarding.permissionStatus
Calendar Sign In CompletedGoogle Calendar connection completes and the calendar link state is confirmed as linked.None
Document CreatedA workspace document is created.None
HabitatZero Desktop App OpenedThe desktop app opens with active cross-promo attribution still inside the activation window.placement, ref, source, trialDays, optional UTM properties
HabitatZero First Note CreatedA user's first desktop note is created with active cross-promo attribution still inside the activation window.placement, ref, source, trialDays, optional UTM properties
Meeting Note CreatedA meeting note is created from the tray, deeplink, or note creation flow.None
Meeting Recording StartedRecording starts for a note.source
Meeting Summary CompletedA transcript summary websocket event completes for a note.None
Meeting TranscribedA recording session first receives transcript content.None
Microphone Permission CompletedMicrophone permission request resolves during onboarding.permissionStatus
Onboarding CompletedThe permission screen marks onboarding complete.None
Onboarding Question AnsweredA user answers one onboarding question.questionId, optionId, optionLabel, step
Onboarding Questions CompletedThe onboarding questions flow completes.Onboarding answer user-property payload
Onboarding Questions StartedThe onboarding questions flow first mounts.source
Onboarding StartedA signed-in user begins onboarding for the first tracked app session.source
Permission Screen ViewedThe permission screen is shown during onboarding.None
Quarter Goal CreatedA quarterly planning goal is created.None
Share Link CopiedA share URL is copied from sharing UI.entityType, source
Share Link TappedThe share toggle/action is tapped from the sharing popover.entityType, source
System Audio Permission CompletedSystem audio permission request resolves, fails, or times out during onboarding.permissionStatus
Todo CreatedA non-goal todo is created.None
Top Goal CreatedA daily top goal is created or promoted.goalPosition, source
Weekly Goal CreatedA weekly planning card is created.source
Weekly Goal PlannedAn unplanned weekly card is scheduled into a day or next week.placement

Frontend Public Share Events

Source: apps/frontend/src/lib/analytics/events.ts

EventTriggerProperties
HabitatZero Download Page VisitedA visitor views the Habitat Zero download page.platform, optional placement, ref, source, trialDays, and UTM properties
Open With Habitat Zero TappedA visitor taps an "Open with Habitat Zero" call to action on a public share page.placement
Public Share ViewedA public share page is viewed.entityType