Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grantiva.io/llms.txt

Use this file to discover all available pages before exploring further.

By default, Grantiva identifies devices anonymously. You can optionally associate a user identity for:
  • Feature flags targeted by user properties
  • Feedback that persists across devices for the same user
  • Analytics grouped by user rather than device

​
Identify a user

await grantiva.identify(UserContext(
    userId: "user_123",
    properties: [
        "plan": "premium",
        "country": "US",
        "beta_tester": "true"
    ]
))
Or with just a user ID: 
await grantiva.identify("user_123")
All services (feedback, flags) automatically use this context after identification. Caches are cleared on identity change so services re-fetch with the new context.

​
UserContext

UserContext(
    userId: String,
    properties: [String: String] = [:]
)
FieldTypeDescription
userIdStringStable unique identifier for the user
properties[String: String]Custom key-value pairs for targeting
Properties are used for feature flag targeting and segmentation. Common examples:
  • "plan": "free", "pro", "business"
  • "country": "US", "DE", "JP"
  • "beta_tester": "true"
  • "company_size": "50"

​
Device context (automatic)

The SDK automatically collects device context — you don’t need to set this: 
grantiva.currentUserContext?.device.appBundleId    // "com.yourapp"
grantiva.currentUserContext?.device.appVersion      // "2.1.0"
grantiva.currentUserContext?.device.deviceModel     // "iPhone15,2"
grantiva.currentUserContext?.device.osVersion       // "18.0"
grantiva.currentUserContext?.device.locale          // "en_US"
grantiva.currentUserContext?.device.environment     // "device" or "simulator"

​
Clear identity

Call on user logout: 
await grantiva.clearIdentity()
Services fall back to device-based identity. Feedback submitted before logout remains associated with the user.

​
Read current identity

grantiva.currentUserId       // String? — current user ID
grantiva.currentUserContext   // UserContext? — full context