vybekiit 0.7.26 → 0.7.27

package/dist/global-skills/instrument-product-analytics/references/angular.md

@@ -1,10 +1,6 @@
 > AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
 
-# Angular - Docs
-
-Copy page
-
-# Angular - Docs
+# Angular
 
 PostHog makes it easy to get data about traffic and usage of your [Angular](https://angular.dev/) app. Integrating PostHog into your site enables analytics about user behavior, custom events capture, session recordings, feature flags, and more.
 
@@ -14,8 +10,6 @@ This guide walks you through integrating PostHog into your Angular app using the
 
 Install `posthog-js` using your package manager:
 
-PostHog AI
-
 ### npm
 
 ```bash
@@ -42,8 +36,6 @@ bun add posthog-js
 
 > **If your site sets a Content-Security-Policy**, it needs to allow PostHog. This applies to the snippet and to package installs alike: the SDK lazy-loads extra bundles (session replay, surveys) from PostHog's CDN, and sends events to the ingestion host. PostHog serves from subdomains of `posthog.com` that change over time, so allow the wildcard:
 >
-> PostHog AI
->
 > ```
 > script-src 'self' https://*.posthog.com;
 > connect-src 'self' https://*.posthog.com;
@@ -67,13 +59,12 @@ Create a service by running `ng g service services/posthog`. The service should
 
 posthog.service.ts
 
-PostHog AI
-
 ```typescript
 // src/app/services/posthog.service.ts
 import { Injectable, NgZone } from "@angular/core";
 import posthog from "posthog-js";
 import { environment } from "../../environments/environment";
+
 @Injectable({ providedIn: "root" })
 export class PosthogService {
   constructor(
@@ -98,13 +89,12 @@ Then, inject the service in your app's root component `app.component.ts`. This w
 
 app.component.ts
 
-PostHog AI
-
 ```typescript
 // src/app/app.component.ts
 import { Component } from "@angular/core";
 import { RouterOutlet } from "@angular/router";
 import { PosthogService } from "./services/posthog.service";
+
 @Component({
   selector: "app-root",
   styleUrls: ["./app.component.scss"],
@@ -114,6 +104,7 @@ import { PosthogService } from "./services/posthog.service";
 })
 export class AppComponent {
   title = "angular-app";
+
   constructor(posthogService: PosthogService) {}
 }
 ```
@@ -124,8 +115,6 @@ In your `src/main.ts`, initialize PostHog using your project token and instance
 
 main.ts
 
-PostHog AI
-
 ```typescript
 // src/main.ts
 import { bootstrapApplication } from '@angular/platform-browser';
@@ -133,10 +122,12 @@ import { appConfig } from './app/app.config';
 import { AppComponent } from './app/app.component';
 import { environment } from "./environments/environment";
 import posthog from 'posthog-js'
+
 posthog.init(environment.posthogKey, {
   api_host: environment.posthogHost,
   defaults: '2026-05-30'
 })
+
 bootstrapApplication(AppComponent, appConfig)
   .catch((err) => console.error(err));
 ```
@@ -155,8 +146,6 @@ If your app calls your own backend, `tracing_headers` adds `X-POSTHOG-DISTINCT-I
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 posthog.init('<ph_project_token>', {
   api_host: 'https://us.i.posthog.com',
@@ -197,7 +186,11 @@ For certain features like [heatmaps](/docs/toolbar/heatmaps.md), your Web Applic
 
 **US**: `44.205.89.55`, `52.4.194.122`, `44.208.188.173`
 
-These are public, stable IPs used by PostHog services (e.g., Celery tasks for snapshots).
+These are public, stable IPs used by PostHog services.
+
+PostHog captures heatmap screenshots using [Browserless](https://www.browserless.io), which has its own IP addresses. Browserless [publishes the current list here](https://docs.browserless.io/baas/troubleshooting/whitelisting-ips).
+
+An allowlist does not help when your app has a private address. For apps on an internal network, see [internal and intranet applications](/docs/session-replay/troubleshooting.md#internal-and-intranet-applications).
 
 ## Tracking pageviews
 
@@ -209,14 +202,14 @@ To [capture custom events](/docs/product-analytics/capture-events.md), import `p
 
 app.component.ts
 
-PostHog AI
-
 ```typescript
 import { Component } from '@angular/core';
 import posthog from 'posthog-js'
+
 @Component({
  // existing component code
 })
+
 export class AppComponent {
   handleClick() {
     posthog.capture(
@@ -237,11 +230,10 @@ The recorder tool attempts to detect when an Angular zone is present and avoid t
 
 posthog.service.ts
 
-PostHog AI
-
 ```typescript
 import { Injectable } from '@angular/core';
 import posthog from 'posthog-js'
+
 @Injectable({ providedIn: 'root' })
 export class PostHogSessionRecordingService {
   constructor(private ngZone: NgZone) {}
@@ -268,10 +260,9 @@ Update your `posthog.service.ts` to restrict the initialization of the PostHog w
 
 posthog.service.ts
 
-PostHog AI
-
 ```typescript
 import { PLATFORM_ID } from "@angular/core";
+
 @Injectable({ providedIn: "root" })
 export class PosthogService {
   constructor(
@@ -283,6 +274,7 @@ export class PosthogService {
       this.initPostHog(); //+
     }
   }
+
   private initPostHog() {
     this.ngZone.runOutsideAngular(() => {
       posthog.init(environment.posthogKey, {
@@ -294,8 +286,6 @@ Angular SSR uses a `server.ts` file to handle requests. We can add any server-si
 
 First, install the `posthog-node` package to run on the server side.
 
-PostHog AI
-
 ### npm
 
 ```bash
@@ -324,17 +314,18 @@ Then, add the following code to the `server.ts` file:
 
 server.ts
 
-PostHog AI
-
 ```typescript
 // src/server.ts
+
 import { environment } from './environments/environment';
 import { PostHog } from 'posthog-node'
+
 /**
  * Extract distinct ID from PostHog cookie
  */
 function getDistinctIdFromCookie(cookieHeader: string | undefined): string | null {
   if (!cookieHeader) return null;
+
   const cookieMatch = cookieHeader.match(`ph_${environment.posthogKey}_posthog=([^;]+)`);
   if (cookieMatch) {
     try {
@@ -347,17 +338,21 @@ function getDistinctIdFromCookie(cookieHeader: string | undefined): string | nul
   }
   return null;
 }
+
 /**
  * Handle all other requests by rendering the Angular application.
  */
 app.get('**', async (req, res, next) => {
   const { protocol, originalUrl, baseUrl, headers } = req;
+
   const distinctId = getDistinctIdFromCookie(headers.cookie);
   let isFeatureEnabled = false;
+
   const client = new PostHog(
       environment.posthogKey,
       { host: environment.posthogHost }
   );
+
   if (distinctId) {
     client.capture({
       distinctId: distinctId,
@@ -366,9 +361,11 @@ app.get('**', async (req, res, next) => {
         message: 'Hello from Angular SSR!'
       }
     })
+
     isFeatureEnabled = await client.isFeatureEnabled(
       'your_feature_flag_key', distinctId) || false;
   }
+
   commonEngine
     .render({
       bootstrap,
@@ -382,6 +379,7 @@ app.get('**', async (req, res, next) => {
     })
     .then((html) => res.send(html))
     .catch((err) => next(err));
+
   await client.shutdown()
 });
 ```

package/dist/global-skills/instrument-product-analytics/references/astro.md

@@ -1,10 +1,6 @@
 > AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
 
-# Astro - Docs
-
-Copy page
-
-# Astro - Docs
+# Astro
 
 PostHog makes it easy to get data about traffic and usage of your [Astro](https://astro.build/) app. Integrating PostHog into your site enables analytics about user behavior, custom events capture, session recordings, feature flags, and more.
 
@@ -26,8 +22,6 @@ In your `src/components` folder, create a `posthog.astro` file:
 
 Terminal
 
-PostHog AI
-
 ```bash
 cd ./src/components
 # or 'cd ./src && mkdir components && cd ./components' if your components folder doesnt exist
@@ -38,11 +32,12 @@ In this file, add your `Web snippet` which you can find in [your project setting
 
 posthog.astro
 
-PostHog AI
-
 ```javascript
+---
+// src/components/posthog.astro
+---
 <script is:inline>
-  !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagResult reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep onSessionId".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+  !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],Object.defineProperty(u,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e}}),Object.defineProperty(u.people,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(){return u.toString(1)+".people (stub)"}}),o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagResult reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep onSessionId".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
   posthog.init('<ph_project_token>', {
     api_host:'https://us.i.posthog.com',
     defaults: '2026-05-30'
@@ -52,8 +47,6 @@ PostHog AI
 
 > **If your site sets a Content-Security-Policy**, it needs to allow PostHog. This applies to the snippet and to package installs alike: the SDK lazy-loads extra bundles (session replay, surveys) from PostHog's CDN, and sends events to the ingestion host. PostHog serves from subdomains of `posthog.com` that change over time, so allow the wildcard:
 >
-> PostHog AI
->
 > ```
 > script-src 'self' https://*.posthog.com;
 > connect-src 'self' https://*.posthog.com;
@@ -70,8 +63,6 @@ Update your `posthog.astro` file to wrap the snippet with a check:
 
 posthog.astro
 
-PostHog AI
-
 ```javascript
 ---
 // src/components/posthog.astro
@@ -79,7 +70,9 @@ PostHog AI
 <script is:inline>
   if (!window.__posthog_initialized) {
     window.__posthog_initialized = true;
-    !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagResult reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep onSessionId".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+
+    !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],Object.defineProperty(u,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e}}),Object.defineProperty(u.people,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(){return u.toString(1)+".people (stub)"}}),o="capture identify alias people.set people.set_once set_config register register_once unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled onFeatureFlags getFeatureFlag getFeatureFlagResult reloadFeatureFlags group updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures getActiveMatchingSurveys getSurveys getNextSurveyStep onSessionId".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+
     posthog.init('<ph_project_token>', {
       api_host: 'https://us.i.posthog.com',
       defaults: '2026-05-30',
@@ -95,8 +88,6 @@ The next step is to a create a [Layout](https://docs.astro.build/en/core-concept
 
 Terminal
 
-PostHog AI
-
 ```bash
 cd .. && cd .. # move back to your base directory if you're still in src/components/posthog.astro
 cd ./src/layouts
@@ -108,8 +99,6 @@ Add the following code to `PostHogLayout.astro`:
 
 PostHogLayout.astro
 
-PostHog AI
-
 ```javascript
 ---
 import PostHog from '../components/posthog.astro'
@@ -123,8 +112,6 @@ Lastly, update `index.astro` to wrap your existing app components with the new L
 
 index.astro
 
-PostHog AI
-
 ```javascript
 ---
 import PostHogLayout from '../layouts/PostHogLayout.astro';
@@ -148,8 +135,6 @@ If your app calls your own backend, `tracing_headers` adds `X-POSTHOG-DISTINCT-I
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 posthog.init('<ph_project_token>', {
   api_host: 'https://us.i.posthog.com',
@@ -184,7 +169,11 @@ For certain features like [heatmaps](/docs/toolbar/heatmaps.md), your Web Applic
 
 **US**: `44.205.89.55`, `52.4.194.122`, `44.208.188.173`
 
-These are public, stable IPs used by PostHog services (e.g., Celery tasks for snapshots).
+These are public, stable IPs used by PostHog services.
+
+PostHog captures heatmap screenshots using [Browserless](https://www.browserless.io), which has its own IP addresses. Browserless [publishes the current list here](https://docs.browserless.io/baas/troubleshooting/whitelisting-ips).
+
+An allowlist does not help when your app has a private address. For apps on an internal network, see [internal and intranet applications](/docs/session-replay/troubleshooting.md#internal-and-intranet-applications).
 
 ## Next steps
 

package/dist/global-skills/instrument-product-analytics/references/configuration.md

@@ -1,10 +1,6 @@
 > AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
 
-# iOS SDK configuration - Docs
-
-Copy page
-
-# iOS SDK configuration - Docs
+# iOS SDK configuration
 
 ## Autocapture configuration
 
@@ -16,8 +12,6 @@ Use `tracingHeaders` to connect iOS network requests to backend events, errors,
 
 Swift
 
-PostHog AI
-
 ```swift
 let configuration = PostHogConfig(projectToken: "<ph_project_token>", host: "https://us.i.posthog.com")
 configuration.tracingHeaders = ["api.example.com"]
@@ -38,8 +32,6 @@ You can also configure the flush interval with `flushIntervalSeconds` (default `
 
 Swift
 
-PostHog AI
-
 ```swift
 configuration.flushAt = 1
 configuration.flushIntervalSeconds = 30
@@ -49,8 +41,6 @@ You can also manually flush the queue to start sending events immediately instea
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.capture("logged_out")
 PostHogSDK.shared.flush()
@@ -74,10 +64,9 @@ Redact URLs in event properties
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 config.setBeforeSend { event in
     // Redact URLs
     if let url = event.properties["url"] as? String {
@@ -91,15 +80,15 @@ Redact sensitive information from event properties
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 config.setBeforeSend { event in
     // Redact sensitive information
     if let email = event.properties["email"] as? String {
         event.properties["email"] = email.map { _ in "*" }.joined()
     }
+
     return event
 }
 ```
@@ -108,10 +97,9 @@ Drop events by event name
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 config.setBeforeSend { event in
     // Drop all events named "Stale Event"
     if event.event == "Stale Event" {
@@ -129,11 +117,11 @@ Because it's just a function, you can filter however you like – an **ignorelis
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 let ignoredScreens: Set<String> = ["Splash", "Debug"]
+
 config.setBeforeSend { event in
     if event.event == "$screen",
        let screenName = event.properties["$screen_name"] as? String,
@@ -152,10 +140,9 @@ Sample events by event name
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 config.setBeforeSend { event in
     // Sample 10% of Sampled Event events
     if event.event == "Sampled Event" {
@@ -177,10 +164,9 @@ You can provide an array of `BeforeSendBlock` functions to be called one after t
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
+
 config.setBeforeSend(
     // First block: Drop all events named "Stale Event"
     { event in
@@ -208,8 +194,6 @@ config.setBeforeSend(
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
 config.appGroupIdentifier = "group.com.yourcompany.yourapp"
@@ -224,11 +208,11 @@ Method swizzling is enabled by default, but can be disabled by setting the relev
 
 | Feature | Description | Config option |
 | --- | --- | --- |
-| Screen view tracking | Automatically captures when view controllers are presented | config.captureScreenViews |
-| Element interactions | Automatically tracks user interactions with UI elements | config.captureElementInteractions |
-| Rage clicks | Automatically captures $rageclick events for rapid repeated taps in the same area (iOS/macCatalyst, UIKit) | config.rageClickConfig.enabled |
-| Session replay | Records user sessions | config.sessionReplay |
-| Surveys | Displays surveys at appropriate times | config.surveys |
+| Screen view tracking | Automatically captures when view controllers are presented | `config.captureScreenViews` |
+| Element interactions | Automatically tracks user interactions with UI elements | `config.captureElementInteractions` |
+| Rage clicks | Automatically captures `$rageclick` events for rapid repeated taps in the same area (iOS/macCatalyst, UIKit) | `config.rageClickConfig.enabled` |
+| Session replay | Records user sessions | `config.sessionReplay` |
+| Surveys | Displays surveys at appropriate times | `config.surveys` |
 | Advanced metrics tracking | Provides more precise session ID calculation and rotation by detecting user activity and idleness | N/A |
 
 ### Disabling all method swizzling
@@ -237,8 +221,6 @@ Since version 3.34.0, you can opt out of all swizzling using the `enableSwizzlin
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "<ph_api_client_host>")
 config.enableSwizzling = false
@@ -265,37 +247,37 @@ The [`PostHogConfig` object](https://github.com/PostHog/posthog-ios/blob/main/Po
 
 | Attribute | Description |
 | --- | --- |
-| flushAtType: IntegerDefault: 20 (5 on tvOS) | The number of queued events that the posthog client should flush at. Setting this to 1 will not queue any events and will use more battery. |
-| flushIntervalSecondsType: TimeIntervalDefault: 30 | The amount of time to wait before each tick of the flush timer, in seconds. Smaller values will make events delivered in a more real-time manner and also use more battery. A value smaller than 10 seconds will seriously degrade overall performance. |
-| maxQueueSizeType: IntegerDefault: 1000 (100 on tvOS) | The maximum number of items to queue before starting to drop old ones. This should be a value greater than zero, the behavior is undefined otherwise. |
-| maxBatchSizeType: IntegerDefault: 50 | Number of maximum events in a batch call. |
-| maxRetriesType: IntegerDefault: 3 | Maximum number of consecutive flush attempts before the entire queue is dropped to avoid infinite retries against a permanently-broken backend (e.g. wrong API key, exhausted quota, deterministic 5xx). Increments on every retriable failure including HTTP 413 cap halving; resets on a successful 2xx response. |
-| captureApplicationLifecycleEventsType: BooleanDefault: true | Whether the posthog client should automatically make a capture call for application lifecycle events, such as "Application Installed", "Application Updated" and "Application Opened". |
-| captureScreenViewsType: BooleanDefault: true | Whether the posthog client should automatically make a screen call when a view controller is added to a view hierarchy. Because the underlying implementation uses method swizzling, we recommend initializing the posthog client as early as possible (before any screens are displayed), ideally during the Application delegate's applicationDidFinishLaunching method. |
-| enableSwizzlingType: BooleanDefault: true | Enable method swizzling for SDK functionality that depends on it. When disabled, functionality that requires swizzling (like autocapture, screen views, session replay, surveys) will not be installed. |
-| captureElementInteractionsType: BooleanDefault: false | (UIKit only) Whether the posthog client should automatically make a capture call when the user interacts with an element in a screen. |
-| rageClickConfigType: ObjectDefault: .init() | (iOS/macCatalyst, UIKit) Rage click detection configuration. Includes enabled (default true), minimumTapCount (default 3), thresholdPoints (default 30), and timeoutInterval (default 1.0). Works independently of captureElementInteractions. Available in version 3.51.0+. |
-| sendFeatureFlagEventType: BooleanDefault: true | Send a $feature_flag_called event when a feature flag is used automatically. |
-| preloadFeatureFlagsType: BooleanDefault: true | Preload feature flags automatically. |
-| evaluationContextsType: Array of StringsDefault: undefined | Evaluation context tags that constrain which feature flags are evaluated. When set, only flags with matching evaluation context tags (or no evaluation context tags) will be returned. See [evaluation contexts documentation](/docs/feature-flags/evaluation-contexts.md) for more details. Available in version 3.38.0+. The legacy parameter evaluationEnvironments (version 3.33.0+) is also supported for backward compatibility. |
-| debugType: BooleanDefault: false | Logs the SDK messages to the Xcode console. |
-| optOutType: BooleanDefault: false | Prevents capturing any data if enabled. |
-| getAnonymousIdType: FunctionDefault: undefined | Hook that allows for modification of the default mechanism for generating anonymous id (which as of now is just random UUID v7). |
-| dataModeType: EnumDefault: .any | Controls when queued data is flushed. Use .wifi to flush only on Wi-Fi; .cellular is a legacy value and behaves like .any. |
-| personProfilesType: EnumDefault: .identifiedOnly | Determines the behavior for processing user profiles. |
-| setDefaultPersonPropertiesType: BooleanDefault: true | Automatically set common device and app properties (such as $app_version, $os_name, and $device_type) as person properties for feature flag evaluation. See [property overrides](/docs/feature-flags/property-overrides.md) for more details. |
-| sessionReplayType: BooleanDefault: false | Enable Recording of Session Replays. |
-| sessionReplayConfigType: ObjectDefault: .init() | Session Replay configuration. See [Session Replay installation](/docs/session-replay/installation/ios.md) for more details. |
-| tracingHeadersType: Array of StringsDefault: nil | Exact hostnames that should receive PostHog tracing headers when the SDK instruments URLSession requests. |
-| errorTrackingConfigType: ObjectDefault: .init() | Error Tracking configuration. See the [error tracking docs](/docs/error-tracking.md) for more details. |
-| logsType: ObjectDefault: .init() | Structured Logs configuration. See [Logs installation](/docs/logs/installation/ios.md) for more details. |
-| surveysConfigType: ObjectDefault: .init() | Surveys configuration, including custom survey delegates and display language overrides. |
-| urlSessionConfigurationType: URLSessionConfigurationDefault: .default | Custom URLSessionConfiguration used by the SDK for PostHog API requests. |
-| appGroupIdentifierType: StringDefault: nil | The identifier of the App Group that should be used to store shared analytics data. PostHog will try to get the physical location of the App Group's shared container, otherwise fallback to the default location. |
-| reuseAnonymousIdType: BooleanDefault: false | Whether the SDK should reuse the anonymous Id between user changes. When enabled, a single Id will be used for all anonymous users on this device. |
-| surveysType: BooleanDefault: true | Enable Surveys. |
-| setBeforeSendType: FunctionDefault: undefined | Hook that allows for amending, sampling, or dropping events before they are sent to PostHog. |
-| bootstrapType: PostHogBootstrapConfigDefault: nil | Seeds identity (distinctId, isIdentifiedId) and feature-flag state (featureFlags, featureFlagPayloads) before the first /flags response. Bootstrapped identity applies to the first session; only enabled flags are served, until the first /flags response replaces them. See [SDK bootstrapping](/docs/libraries/bootstrapping.md#behavior-on-mobile-sdks). |
+| `flushAt` **Type:** Integer **Default:** `20` (`5` on tvOS) | The number of queued events that the posthog client should flush at. Setting this to `1` will not queue any events and will use more battery. |
+| `flushIntervalSeconds` **Type:** TimeInterval **Default:** `30` | The amount of time to wait before each tick of the flush timer, in seconds. Smaller values will make events delivered in a more real-time manner and also use more battery. A value smaller than 10 seconds will seriously degrade overall performance. |
+| `maxQueueSize` **Type:** Integer **Default:** `1000` (`100` on tvOS) | The maximum number of items to queue before starting to drop old ones. This should be a value greater than zero, the behavior is undefined otherwise. |
+| `maxBatchSize` **Type:** Integer **Default:** `50` | Number of maximum events in a batch call. |
+| `maxRetries` **Type:** Integer **Default:** `3` | Maximum number of consecutive flush attempts before the entire queue is dropped to avoid infinite retries against a permanently-broken backend (e.g. wrong API key, exhausted quota, deterministic 5xx). Increments on every retriable failure including HTTP 413 cap halving; resets on a successful 2xx response. |
+| `captureApplicationLifecycleEvents` **Type:** Boolean **Default:** `true` | Whether the posthog client should automatically make a capture call for application lifecycle events, such as "Application Installed", "Application Updated" and "Application Opened". |
+| `captureScreenViews` **Type:** Boolean **Default:** `true` | Whether the posthog client should automatically make a screen call when a view controller is added to a view hierarchy. Because the underlying implementation uses method swizzling, we recommend initializing the posthog client as early as possible (before any screens are displayed), ideally during the Application delegate's applicationDidFinishLaunching method. |
+| `enableSwizzling` **Type:** Boolean **Default:** `true` | Enable method swizzling for SDK functionality that depends on it. When disabled, functionality that requires swizzling (like autocapture, screen views, session replay, surveys) will not be installed. |
+| `captureElementInteractions` **Type:** Boolean **Default:** `false` | (UIKit only) Whether the posthog client should automatically make a capture call when the user interacts with an element in a screen. |
+| `rageClickConfig` **Type:** Object **Default:** `.init()` | (iOS/macCatalyst, UIKit) Rage click detection configuration. Includes `enabled` (default `true`), `minimumTapCount` (default `3`), `thresholdPoints` (default `30`), and `timeoutInterval` (default `1.0`). Works independently of `captureElementInteractions`. Available in version 3.51.0+. |
+| `sendFeatureFlagEvent` **Type:** Boolean **Default:** `true` | Send a `$feature_flag_called` event when a feature flag is used automatically. |
+| `preloadFeatureFlags` **Type:** Boolean **Default:** `true` | Preload feature flags automatically. |
+| `evaluationContexts` **Type:** Array of Strings **Default:** `undefined` | Evaluation context tags that constrain which feature flags are evaluated. When set, only flags with matching evaluation context tags (or no evaluation context tags) will be returned. See [evaluation contexts documentation](/docs/feature-flags/evaluation-contexts.md) for more details. Available in version 3.38.0+. The legacy parameter `evaluationEnvironments` (version 3.33.0+) is also supported for backward compatibility. |
+| `debug` **Type:** Boolean **Default:** `false` | Logs the SDK messages to the Xcode console. |
+| `optOut` **Type:** Boolean **Default:** `false` | Prevents capturing any data if enabled. |
+| `getAnonymousId` **Type:** Function **Default:** `undefined` | Hook that allows for modification of the default mechanism for generating anonymous id (which as of now is just random UUID v7). |
+| `dataMode` **Type:** Enum **Default:** `.any` | Controls when queued data is flushed. Use `.wifi` to flush only on Wi-Fi; `.cellular` is a legacy value and behaves like `.any`. |
+| `personProfiles` **Type:** Enum **Default:** `.identifiedOnly` | Determines the behavior for processing user profiles. |
+| `setDefaultPersonProperties` **Type:** Boolean **Default:** `true` | Automatically set common device and app properties (such as `$app_version`, `$os_name`, and `$device_type`) as person properties for feature flag evaluation. See [property overrides](/docs/feature-flags/property-overrides.md) for more details. |
+| `sessionReplay` **Type:** Boolean **Default:** `false` | Enable Recording of Session Replays. |
+| `sessionReplayConfig` **Type:** Object **Default:** `.init()` | Session Replay configuration. See [Session Replay installation](/docs/session-replay/installation/ios.md) for more details. |
+| `tracingHeaders` **Type:** Array of Strings **Default:** `nil` | Exact hostnames that should receive PostHog tracing headers when the SDK instruments `URLSession` requests. |
+| `errorTrackingConfig` **Type:** Object **Default:** `.init()` | Error Tracking configuration. See the [error tracking docs](/docs/error-tracking.md) for more details. |
+| `logs` **Type:** Object **Default:** `.init()` | Structured Logs configuration. See [Logs installation](/docs/logs/installation/ios.md) for more details. |
+| `surveysConfig` **Type:** Object **Default:** `.init()` | Surveys configuration, including custom survey delegates and display language overrides. |
+| `urlSessionConfiguration` **Type:** URLSessionConfiguration **Default:** `.default` | Custom `URLSessionConfiguration` used by the SDK for PostHog API requests. |
+| `appGroupIdentifier` **Type:** String **Default:** `nil` | The identifier of the App Group that should be used to store shared analytics data. PostHog will try to get the physical location of the App Group's shared container, otherwise fallback to the default location. |
+| `reuseAnonymousId` **Type:** Boolean **Default:** `false` | Whether the SDK should reuse the anonymous Id between user changes. When enabled, a single Id will be used for all anonymous users on this device. |
+| `surveys` **Type:** Boolean **Default:** `true` | Enable Surveys. |
+| `setBeforeSend` **Type:** Function **Default:** `undefined` | Hook that allows for amending, sampling, or dropping events before they are sent to PostHog. |
+| `bootstrap` **Type:** `PostHogBootstrapConfig` **Default:** `nil` | Seeds identity (`distinctId`, `isIdentifiedId`) and feature-flag state (`featureFlags`, `featureFlagPayloads`) before the first `/flags` response. Bootstrapped identity applies to the first session; only enabled flags are served, until the first `/flags` response replaces them. See [SDK bootstrapping](/docs/libraries/bootstrapping.md#behavior-on-mobile-sdks). |
 
 ### Still have questions?