vybekiit 0.7.26 → 0.7.28

package/dist/global-skills/instrument-product-analytics/references/tanstack-start.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
 
-# TanStack Start - Docs
-
-Copy page
-
-# TanStack Start - Docs
+# TanStack Start
 
 This tutorial shows how to integrate PostHog with a [TanStack Start](https://tanstack.com/start) app for both client-side and server-side analytics.
 
@@ -14,8 +10,6 @@ Install the required packages:
 
 Terminal
 
-PostHog AI
-
 ```bash
 npm install @posthog/react posthog-node
 ```
@@ -37,8 +31,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',
@@ -55,14 +47,14 @@ Tracing headers help you attribute events across front and backend consistently.
 
 Wrap your app with `PostHogProvider` in your root route with your project token, host, and other options.
 
-PostHog AI
-
 ```
 import CspAllowancesCallout from "../_snippets/csp-allowances-callout.mdx"
+
 <CspAllowancesCallout />tsx file=src/routes/__root.tsx
 // src/routes/__root.tsx
 import { HeadContent, Scripts, createRootRoute } from '@tanstack/react-router'
 import { PostHogProvider } from '@posthog/react'
+
 export const Route = createRootRoute({
   head: () => ({
     meta: [
@@ -72,6 +64,7 @@ export const Route = createRootRoute({
   }),
   shellComponent: RootDocument,
 })
+
 function RootDocument({ children }: { children: React.ReactNode }) {
   return (
     <html lang="en">
@@ -104,18 +97,19 @@ Use the `usePostHog` hook from `@posthog/react` in any component to capture cust
 
 src/routes/checkout.tsx
 
-PostHog AI
-
 ```jsx
 import { usePostHog } from '@posthog/react'
+
 function CheckoutButton({ orderId, total }: { orderId: string; total: number }) {
   const posthog = usePostHog()
+
   const handleClick = () => {
     posthog.capture('checkout_started', {
       order_id: orderId,
       total: total,
     })
   }
+
   return <button onClick={handleClick}>Checkout</button>
 }
 ```
@@ -126,17 +120,19 @@ Call `posthog.identify()` when a user logs in to link their events to a user ID:
 
 TSX
 
-PostHog AI
-
 ```jsx
 import { usePostHog } from '@posthog/react'
+
 function LoginForm() {
   const posthog = usePostHog()
+
   const handleLogin = async (userId: string, email: string) => {
     // ... your login logic
+
     posthog.identify(userId, {
       email: email,
     })
+
     posthog.capture('user_logged_in')
   }
 }
@@ -150,12 +146,12 @@ Create a server-side PostHog client using `posthog-node`. Use a singleton patter
 
 src/utils/posthog-server.ts
 
-PostHog AI
-
 ```typescript
 // src/utils/posthog-server.ts
 import { PostHog } from 'posthog-node'
+
 let posthogClient: PostHog | null = null
+
 export function getPostHogClient() {
   if (!posthogClient) {
     posthogClient = new PostHog(
@@ -177,19 +173,20 @@ Use the server client in TanStack Start API routes to capture events server-side
 
 src/routes/api/checkout.ts
 
-PostHog AI
-
 ```typescript
 // src/routes/api/checkout.ts
 import { createFileRoute } from '@tanstack/react-router'
 import { json } from '@tanstack/react-start'
 import { getPostHogClient } from '../../utils/posthog-server'
+
 export const Route = createFileRoute('/api/checkout')({
   server: {
     handlers: {
       POST: async ({ request }) => {
         const body = await request.json()
+
         const posthog = getPostHogClient()
+
         posthog.capture({
           distinctId: body.userId,
           event: 'item_purchased',
@@ -199,6 +196,7 @@ export const Route = createFileRoute('/api/checkout')({
             source: 'api',
           },
         })
+
         return json({ success: true })
       },
     },

package/dist/global-skills/instrument-product-analytics/references/usage.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 usage - Docs
-
-Copy page
-
-# iOS SDK usage - Docs
+# iOS SDK usage
 
 ## Capturing events
 
@@ -12,8 +8,6 @@ You can send custom events using `capture`:
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.capture("user_signed_up")
 ```
@@ -26,8 +20,6 @@ Optionally, you can include additional information with the event by including a
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.capture("user_signed_up", properties: ["login_type": "email"], userProperties: ["is_free_trial": true])
 ```
@@ -54,8 +46,6 @@ If you want to manually send a new screen capture event, use the `screen` functi
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.screen("Dashboard", properties: ["fromIcon": "bottom"])
 ```
@@ -70,8 +60,6 @@ To track a screen view in `SwiftUI`, apply the `postHogScreenView` modifier to y
 
 HomeView.swift
 
-PostHog AI
-
 ```swift
 // This will trigger a screen view event with $screen_name: "HomeViewContent"
 struct HomeView: View {
@@ -80,6 +68,7 @@ struct HomeView: View {
             .postHogScreenView()
     }
 }
+
 // This will trigger a screen view event with $screen_name: "My Home View" and an additional event property from_button: "start"
 struct HomeView: View {
     var body: some View {
@@ -103,8 +92,6 @@ To assign a custom label to a UIView, use the `postHogLabel` property:
 
 Swift
 
-PostHog AI
-
 ```swift
 let view = UIView()
 view.postHogLabel = "usernameTextField"
@@ -118,8 +105,6 @@ In SwiftUI, use the `.postHogLabel(_:)` modifier instead:
 
 Swift
 
-PostHog AI
-
 ```swift
 var body: some View {
     ...
@@ -136,8 +121,6 @@ The generated analytics element in the examples above will have the following fo
 
 Swift
 
-PostHog AI
-
 ```swift
 <UITextField id="usernameTextField">text value</UITextField>
 ```
@@ -163,8 +146,6 @@ Interaction autocapture is **not enabled by default**. You can enable it by sett
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "https://us.i.posthog.com")
 config.captureElementInteractions = true // Disabled by default
@@ -183,8 +164,6 @@ It is enabled by default (`rageClickConfig.enabled = true`).
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "https://us.i.posthog.com")
 config.rageClickConfig.enabled = true // Enabled by default
@@ -217,8 +196,6 @@ An `identify` call has the following arguments:
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.identify("user_id_from_your_database",
                             userProperties: ["name": "Peter Griffin", "email": "peter@familyguy.com"],
@@ -243,13 +220,11 @@ In this case, you can use `alias` to assign another distinct ID to the same user
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.alias("alias_id")
 ```
 
-We strongly recommend reading our docs on [alias](/docs/data/identify.md#alias-assigning-multiple-distinct-ids-to-the-same-user) to best understand how to correctly use this method.
+We strongly recommend reading our docs on [alias](/docs/product-analytics/identify.md#alias-assigning-multiple-distinct-ids-to-the-same-user) to best understand how to correctly use this method.
 
 ## Anonymous vs identified events
 
@@ -289,8 +264,6 @@ For example:
 
 iOS
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(
     projectToken: POSTHOG_PROJECT_TOKEN,
@@ -314,14 +287,12 @@ Alternatively, you can set `personProfiles` to `.always` to capture identified e
 
 ## Setting person properties
 
-To set [properties](/docs/data/user-properties.md) on your users via an event, you can leverage the event properties `userProperties` and `userPropertiesSetOnce`.
+To set [properties](/docs/product-analytics/person-properties.md) on your users via an event, you can leverage the event properties `userProperties` and `userPropertiesSetOnce`.
 
 When capturing an event, you can pass a property called `$set` as an event property, and specify its value to be an object with properties to be set on the user that will be associated with the user who triggered the event.
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.capture("signed_up", properties: ["plan": "Pro++"], userProperties: ["user_property_name": "your_value"])
 ```
@@ -330,8 +301,6 @@ PostHogSDK.shared.capture("signed_up", properties: ["plan": "Pro++"], userProper
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.capture("signed_up", properties: ["plan": "Pro++"], userPropertiesSetOnce: ["user_property_name": "your_value"])
 ```
@@ -340,10 +309,9 @@ Use `setPersonProperties` when you want to update the current person's profile w
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.setPersonProperties(userPropertiesToSet: ["plan": "Pro++"])
+
 PostHogSDK.shared.setPersonProperties(
     userPropertiesToSet: ["plan": "Pro++"],
     userPropertiesToSetOnce: ["first_seen_source": "ios"]
@@ -360,8 +328,6 @@ For example, take a look at the following call:
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.register(["team_id": 22])
 ```
@@ -376,8 +342,6 @@ Super properties persist across sessions so you have to explicitly remove them i
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.unregister("team_id")
 ```
@@ -408,11 +372,10 @@ PostHog's [feature flags](/docs/feature-flags.md) enable you to safely deploy an
 
 Swift
 
-PostHog AI
-
 ```swift
 if let result = PostHogSDK.shared.getFeatureFlagResult("flag-key"), result.enabled {
     // Do something differently for this user
+
     // Optional: fetch the payload from the same evaluation result
     let matchedFlagPayload = result.payload
 }
@@ -422,11 +385,10 @@ if let result = PostHogSDK.shared.getFeatureFlagResult("flag-key"), result.enabl
 
 Swift
 
-PostHog AI
-
 ```swift
 if let result = PostHogSDK.shared.getFeatureFlagResult("flag-key"), result.variant == "variant-key" { // replace "variant-key" with the key of your variant
     // Do something differently for this user
+
     // Optional: fetch the payload from the same evaluation result
     let matchedFlagPayload = result.payload
 }
@@ -438,12 +400,11 @@ If your payload is a JSON object, you can decode it into a `Decodable` type:
 
 Swift
 
-PostHog AI
-
 ```swift
 struct FlagPayload: Decodable {
     let title: String
 }
+
 if let result = PostHogSDK.shared.getFeatureFlagResult("flag-key"),
    let payload = result.payloadAs(FlagPayload.self) {
     // Use payload.title
@@ -456,8 +417,6 @@ You can inspect all currently loaded feature flags with `getAllFeatureFlags()`.
 
 Swift
 
-PostHog AI
-
 ```swift
 for flag in PostHogSDK.shared.getAllFeatureFlags() ?? [] {
     print(flag.key, flag.enabled, flag.variant as Any, flag.payload as Any)
@@ -470,8 +429,6 @@ Feature flag values are cached. If something has changed with your user and you'
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.reloadFeatureFlags()
 ```
@@ -486,8 +443,6 @@ To handle this, you can use the `didReceiveFeatureFlags` notification to wait fo
 
 Swift
 
-PostHog AI
-
 ```swift
 class AppDelegate: NSObject, UIApplicationDelegate {
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
@@ -498,13 +453,18 @@ class AppDelegate: NSObject, UIApplicationDelegate {
             name: PostHogSDK.didReceiveFeatureFlags,
             object: nil
         )
+
         let POSTHOG_PROJECT_TOKEN = "<ph_project_token>"
         // usually 'https://us.i.posthog.com' or 'https://eu.i.posthog.com'
         let POSTHOG_HOST = "https://us.i.posthog.com"
+
         let config = PostHogConfig(projectToken: POSTHOG_PROJECT_TOKEN, host: POSTHOG_HOST)
+
         PostHogSDK.shared.setup(config)
+
         return true
     }
+
     // The "receiveFeatureFlags" method will be called when the SDK receives the feature flags from the server.
     @objc func receiveFeatureFlags() {
         print("receiveFeatureFlags called")
@@ -516,8 +476,6 @@ Alternatively, you can use the completion block of the `reloadFeatureFlags(_:)`
 
 Swift
 
-PostHog AI
-
 ```swift
 // Reload feature flags and check if a specific feature is enabled
 PostHogSDK.shared.reloadFeatureFlags {
@@ -533,8 +491,6 @@ To track when someone sees or interacts with a feature, use `captureFeatureView`
 
 Swift
 
-PostHog AI
-
 ```swift
 PostHogSDK.shared.captureFeatureView(flag: "flag-key", flagVariant: "variant-key")
 PostHogSDK.shared.captureFeatureInteraction(flag: "flag-key", flagVariant: "variant-key")
@@ -550,8 +506,6 @@ Set `config.bootstrap` before calling `setup()` to seed identity and flag values
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "https://us.i.posthog.com")
 config.bootstrap = PostHogBootstrapConfig(
@@ -609,8 +563,6 @@ You can enable debug mode by setting the `debug` option to `true` in the `PostHo
 
 Swift
 
-PostHog AI
-
 ```swift
 let config = PostHogConfig(projectToken: "<ph_project_token>", host: "https://us.i.posthog.com")
 config.debug = true
@@ -623,11 +575,10 @@ You can also toggle debug by calling the `PostHogSDK.shared.debug()` method in y
 
 Swift
 
-PostHog AI
-
 ```swift
 // Enable debug mode
 PostHogSDK.shared.debug(true)
+
 // Disable debug mode
 PostHogSDK.shared.debug(false)
 ```

package/dist/global-skills/instrument-product-analytics/references/vue-js.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
 
-# Vue.js - Docs
-
-Copy page
-
-# Vue.js - Docs
+# Vue.js
 
 PostHog makes it easy to get data about usage of your [Vue.js](https://vuejs.org/) app. Integrating PostHog into your app enables analytics about user behavior, custom events capture, session replays, feature flags, and more.
 
@@ -23,8 +19,6 @@ To follow this guide along, you need:
 
 Start by installing `posthog-js` using your package manager:
 
-PostHog AI
-
 ### npm
 
 ```bash
@@ -51,8 +45,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;
@@ -71,25 +63,29 @@ PostHog initializes as a singleton, so you can initialize it in your `main.ts` f
 
 src/main.ts
 
-PostHog AI
-
 ```typescript
 // src/main.ts
 import { createApp } from 'vue'
 import { createPinia } from 'pinia'
+
 import App from './App.vue'
 import router from './router'
 import posthog from "posthog-js";
+
 const app = createApp(App);
+
 posthog.init(import.meta.env.VITE_POSTHOG_PROJECT_TOKEN || '<ph_project_token>', {
   api_host: import.meta.env.VITE_POSTHOG_HOST || 'https://us.i.posthog.com',
   defaults: '2026-05-30',
 });
+
 app.use(createPinia())
 app.use(router)
+
 app.config.errorHandler = (err, instance, info) => {
   posthog.captureException(err)
 }
+
 app.mount('#app')
 ```
 
@@ -97,12 +93,11 @@ Then, you can access PostHog throughout your app just by importing it from `post
 
 TypeScript
 
-PostHog AI
-
 ```typescript
 // src/App.vue
 <script setup>
 import posthog from 'posthog-js'
+
 const handleClick = () => {
   posthog.capture('button_clicked')
 }
@@ -117,17 +112,17 @@ Start by creating a `plugins` folder and adding a `posthog.js` file to that fold
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/plugins/posthog.js
 import posthog from 'posthog-js'
+
 export default {
   install(Vue) {
     posthog.init('<ph_project_token>', {
       api_host: 'https://us.i.posthog.com',
       defaults: '2026-05-30'
     })
+
     Vue.prototype.$posthog = posthog
   }
 }
@@ -137,15 +132,15 @@ Next, in `main.js`, import and use the plugin.
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/main.js
 import Vue from 'vue'
 import App from './App.vue'
 import PosthogPlugin from './plugins/posthog'
+
 Vue.config.productionTip = false
 Vue.use(PosthogPlugin)
+
 new Vue({
   render: h => h(App),
 }).$mount('#app')
@@ -167,8 +162,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',
@@ -191,22 +184,24 @@ To capture custom events, evaluate feature flags, and use any of the other PostH
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/App.vue
 <script setup>
 import { RouterView } from 'vue-router'
 import { usePostHog } from './composables/usePostHog'
+
 const { posthog } = usePostHog()
+
 const handleClick = () => {
   posthog.capture('button_clicked', { location: 'homepage' })
 }
 </script>
+
 <template>
   <div>
     <button @click="handleClick">Click me!</button>
   </div>
+
   <RouterView />
 </template>
 ```
@@ -217,20 +212,21 @@ When using feature flags on pages that users navigate to directly, the flags may
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/composables/usePostHogFeatureFlag.ts
 import { ref, type Ref } from 'vue'
 import { usePostHog } from './usePostHog'
+
 export function usePostHogFeatureFlag(
   feature: string,
 ): Ref<string | boolean | undefined> {
   const { posthog } = usePostHog()
   const flag = ref(posthog.getFeatureFlag(feature))
+
   posthog.onFeatureFlags(() => {
     flag.value = posthog.getFeatureFlag(feature)
   })
+
   return flag
 }
 ```
@@ -239,25 +235,27 @@ Then use it in your components:
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/App.vue
 <script setup>
 import { RouterView } from 'vue-router'
 import { usePostHog } from './composables/usePostHog'
 import { usePostHogFeatureFlag } from './composables/usePostHogFeatureFlag'
+
 const { posthog } = usePostHog()
 const isFeatureEnabled = usePostHogFeatureFlag('test-flag')
+
 const handleClick = () => {
   posthog.capture('button_clicked', { location: 'homepage' })
 }
 </script>
+
 <template>
   <div>
     <button @click="handleClick">Click me!</button>
     <p>Is feature flag enabled? {{ isFeatureEnabled ? 'Yes' : 'No' }}</p>
   </div>
+
   <RouterView />
 </template>
 ```
@@ -270,8 +268,6 @@ To capture custom events, evaluate feature flags, and use any of the other PostH
 
 JavaScript
 
-PostHog AI
-
 ```javascript
 // src/components/AboutPage.vue
 <template>
@@ -282,6 +278,7 @@ PostHog AI
     <p>Feature enabled? {{ isFeatureEnabled ? 'Yes' : 'No' }}</p>
   </div>
 </template>
+
 <script>
 export default {
   name: 'AboutPage',
@@ -324,7 +321,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