PostHog feature flags for Android

Reference files

• references/android.md

  - Android feature flags installation - docs

• references/adding-feature-flag-code.md

  - Adding feature flag code - docs

• references/best-practices.md

  - Feature flag best practices - docs

Key principles

• Environment variables: Always use environment variables for PostHog keys. Never hardcode them.
• Minimal changes: Add feature flag code alongside existing logic. Don't replace or restructure existing code.
• Boolean flags first: Default to boolean flag checks unless the user specifically asks for multivariate flags.
• Server-side when possible: Prefer server-side flag evaluation to avoid UI flicker.

PostHog MCP tools

Framework guidelines

• Adapt dependency configuration to the appropriate build.gradle(.kts) file according to the project gradle version
• Call

  PostHogAndroid.setup()

  only once in the Application class's

  onCreate()

  method, so it's initialized as early as possible and only once.
• Initialize PostHog in the Application class's

  onCreate()

  method
• Ensure every activity has a

  android:label

  to accurately track screen views.