vybekiit 0.4.0 → 0.6.0

package/dist/global-skills/instrument-feature-flags/references/elixir.md

@@ -0,0 +1,47 @@
+# Elixir Feature Flags installation - Docs
+
+> This library was built by the community but it's being maintained by the PostHog core team since v1.0.0. Thank you to [Nick Kezhaya](https://github.com/nkezhaya) for building it originally. Thank you to [Alex Martsinovich](https://github.com/martosaur) for contributing v2.0.0.
+
+The package can be installed by adding `posthog` to your list of dependencies in `mix.exs`:
+
+Elixir
+
+PostHog AI
+
+```elixir
+def deps do
+  [
+    {:posthog, "~> 2.0"}
+  ]
+end
+```
+
+### Configuration
+
+config/config.exs
+
+PostHog AI
+
+```elixir
+config :posthog,
+  enable: true,
+  api_host: "https://us.i.posthog.com",
+  api_key: "<ph_project_token>",
+  in_app_otp_apps: [:my_app]
+```
+
+You can see all the available configuration options in the [PostHog.Config](https://hexdocs.pm/posthog/PostHog.Config.html) module.
+
+Optionally, you might want to enable the [Plug integration](https://hexdocs.pm/posthog/PostHog.Integrations.Plug.html) to attach request metadata and tracing context in Plug-based applications including Phoenix. You still need to capture events explicitly with `PostHog.capture/2` or `PostHog.capture/3`.
+
+#### Development/Test mode
+
+For a test environment, you can pass in `test_mode: true` value to the config. This causes events to be dropped instead of sent to PostHog.
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better

package/dist/global-skills/instrument-feature-flags/references/flask.md

@@ -0,0 +1,131 @@
+# Flask - Docs
+
+PostHog makes it easy to get data about traffic and usage of your Flask app. Integrating PostHog enables analytics, custom events capture, feature flags, error tracking, and more.
+
+This guide walks you through integrating PostHog into your Flask app using the [Python SDK](/docs/libraries/python.md).
+
+## Installation
+
+To start, run `pip install posthog` to install PostHog’s Python SDK.
+
+> **Note:** Version `7.x` of the PostHog Python SDK requires Python 3.10 or higher.
+
+Then, initialize PostHog where you'd like to use it. For example, here's how to capture an event in a simple route:
+
+app.py
+
+PostHog AI
+
+```python
+from flask import Flask
+from posthog import Posthog
+app = Flask(__name__)
+posthog = Posthog(
+    '<ph_project_token>',
+    host='https://us.i.posthog.com',
+)
+@app.route('/api/dashboard', methods=['POST'])
+def api_dashboard():
+    posthog.capture(
+        'dashboard_api_called',
+        distinct_id='distinct_id_of_your_user',
+    )
+    return '', 204
+```
+
+You can find your project token and instance address in [your project settings](https://app.posthog.com/project/settings).
+
+## Identifying users
+
+> **Identifying users is required.** Backend events need a `distinct_id` to associate events with the correct user.
+>
+> In Python, you can do this through a context. All event captures in the same context will be tagged automatically with the correct `distinct_id`. Typically, you would set a fresh context and identify at the top of each route.
+>
+> Python
+>
+> PostHog AI
+>
+> ```python
+> from posthog import new_context, identify_context, capture
+> @app.get("/foo")
+> def foo(current_user: User = Depends(get_current_user)):
+>     with new_context(): # Set context at the top of a route
+>         identify_context(current_user.id)
+>         capture("foo_viewed")
+>     return {"status": "ok"}
+> ```
+
+## Request contexts
+
+Use [contexts](/docs/libraries/python.md#contexts) to share identity, session IDs, and tags across multiple captures during a request.
+
+If you're using [PostHog JS](/docs/libraries/js.md) on the frontend, configure [`tracing_headers`](/docs/libraries/js/config.md#tracing-headers) for your Flask backend hostname so browser requests include the session and distinct ID headers.
+
+Then read the incoming headers in your Flask request handler. Tracing headers are client-controlled analytics context, not authentication or authorization, so prefer your authenticated user ID when one is available:
+
+Python
+
+PostHog AI
+
+```python
+from flask import request, session
+from posthog import identify_context, set_context_session, tag
+@app.route('/api/dashboard', methods=['POST'])
+def api_dashboard():
+    with posthog.new_context(fresh=True):
+        distinct_id = session.get('user_id') or request.headers.get('X-POSTHOG-DISTINCT-ID')
+        if distinct_id:
+            identify_context(str(distinct_id))
+        session_id = request.headers.get('X-POSTHOG-SESSION-ID')
+        if session_id:
+            set_context_session(session_id)
+        tag('$current_url', request.url)
+        tag('$request_method', request.method)
+        tag('$request_path', request.path)
+        posthog.capture('dashboard_api_called')
+    return '', 204
+```
+
+Events captured without a context or explicit `distinct_id` are sent as [anonymous events](/docs/data/anonymous-vs-identified-events.md) with an auto-generated `distinct_id`. See the [Python SDK docs](/docs/libraries/python.md#person-profiles-and-properties) for more details.
+
+## Error tracking
+
+Flask has built-in error handlers. This means PostHog’s default exception autocapture won’t work and we need to manually capture errors instead using `capture_exception()`:
+
+Python
+
+PostHog AI
+
+```python
+from flask import Flask, jsonify
+from posthog import Posthog
+app = Flask(__name__)
+posthog = Posthog('<ph_project_token>', host='https://us.i.posthog.com')
+@app.errorhandler(Exception)
+def handle_exception(e):
+    # Capture methods, including capture_exception, return the UUID of the captured event,
+    # which you can use to find specific errors users encountered
+    event_id = posthog.capture_exception(e)
+    # You can show the event ID to your user, and ask them to include it in bug reports
+    response = jsonify({'message': str(e), 'error_id': event_id})
+    response.status_code = 500
+    return response
+```
+
+## Next steps
+
+For any technical questions for how to integrate specific PostHog features into Flask (such as analytics, feature flags, A/B testing, etc.), have a look at our [Python SDK docs](/docs/libraries/python.md).
+
+Alternatively, the following tutorials can help you get started:
+
+-   [How to set up analytics in Python and Flask](/tutorials/python-analytics.md)
+-   [How to set up feature flags in Python and Flask](/tutorials/python-feature-flags.md)
+-   [How to set up A/B tests in Python and Flask](/tutorials/python-ab-testing.md)
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better

package/dist/global-skills/instrument-feature-flags/references/flutter.md

@@ -0,0 +1,212 @@
+# Flutter Feature Flags installation - Docs
+
+1.  1
+
+    ## Install the package
+
+    Required
+
+    Add the PostHog Flutter SDK to your `pubspec.yaml`:
+
+    pubspec.yaml
+
+    PostHog AI
+
+    ```yaml
+    posthog_flutter: ^5.24.0
+    ```
+
+2.  2
+
+    ## Platform setup
+
+    Required
+
+    ## Tab
+
+    Add these values to your `AndroidManifest.xml`:
+
+    android/app/src/main/AndroidManifest.xml
+
+    PostHog AI
+
+    ```xml
+    <application>
+      <activity>
+        [...]
+      </activity>
+      <meta-data android:name="com.posthog.posthog.PROJECT_TOKEN" android:value="<ph_project_token>" />
+      <meta-data android:name="com.posthog.posthog.POSTHOG_HOST" android:value="https://us.i.posthog.com" />
+      <meta-data android:name="com.posthog.posthog.TRACK_APPLICATION_LIFECYCLE_EVENTS" android:value="true" />
+      <meta-data android:name="com.posthog.posthog.DEBUG" android:value="true" />
+    </application>
+    ```
+
+    Update the minimum Android SDK version to **21** in `android/app/build.gradle`:
+
+    android/app/build.gradle
+
+    PostHog AI
+
+    ```groovy
+    defaultConfig {
+      minSdkVersion 23
+      // rest of your config
+    }
+    ```
+
+    ## Tab
+
+    Add these values to your `Info.plist`:
+
+    ios/Runner/Info.plist
+
+    PostHog AI
+
+    ```xml
+    <dict>
+      [...]
+      <key>com.posthog.posthog.PROJECT_TOKEN</key>
+      <string><ph_project_token></string>
+      <key>com.posthog.posthog.POSTHOG_HOST</key>
+      <string>https://us.i.posthog.com</string>
+      <key>com.posthog.posthog.CAPTURE_APPLICATION_LIFECYCLE_EVENTS</key>
+      <true/>
+      <key>com.posthog.posthog.DEBUG</key>
+      <true/>
+    </dict>
+    ```
+
+    Update the minimum platform version to iOS 13.0 in your `Podfile`:
+
+    Podfile
+
+    PostHog AI
+
+    ```ruby
+    platform :ios, '13.0'
+    # rest of your config
+    ```
+
+    ## Tab
+
+    Add these values in `index.html`:
+
+    web/index.html
+
+    PostHog AI
+
+    ```html
+    <!DOCTYPE html>
+    <html>
+      <head>
+        ...
+        <script>
+          !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.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/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="init capture register register_once register_for_session unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group identify setPersonProperties setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags resetGroups onFeatureFlags addFeatureFlagsHandler onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep".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',
+          })
+        </script>
+      </head>
+      <body>
+        ...
+      </body>
+    </html>
+    ```
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:
+
+    Dart
+
+    PostHog AI
+
+    ```dart
+    import 'package:posthog_flutter/posthog_flutter.dart';
+    await Posthog().capture(
+        eventName: 'button_clicked',
+        properties: {
+          'button_name': 'signup'
+        }
+    );
+    ```
+
+4.  4
+
+    ## Evaluate boolean feature flags
+
+    Required
+
+    Check if a feature flag is enabled:
+
+    Dart
+
+    PostHog AI
+
+    ```dart
+    final isMyFlagEnabled = await Posthog().isFeatureEnabled('flag-key');
+    if (isMyFlagEnabled) {
+        // Do something differently for this user
+        // Optional: fetch the payload
+        final matchedFlagPayload = (await Posthog().getFeatureFlagResult('flag-key'))?.payload;
+    }
+    ```
+
+5.  5
+
+    ## Evaluate multivariate feature flags
+
+    Optional
+
+    For multivariate flags, check which variant the user has been assigned:
+
+    Dart
+
+    PostHog AI
+
+    ```dart
+    final enabledVariant = await Posthog().getFeatureFlag('flag-key');
+    if (enabledVariant == 'variant-key') { // replace 'variant-key' with the key of your variant
+        // Do something differently for this user
+        // Optional: fetch the payload
+        final matchedFlagPayload = (await Posthog().getFeatureFlagResult('flag-key'))?.payload;
+    }
+    ```
+
+6.  6
+
+    ## Running experiments
+
+    Optional
+
+    Experiments run on top of our feature flags. Once you've implemented the flag in your code, you run an experiment by creating a new experiment in the PostHog dashboard.
+
+7.  7
+
+    ## Next steps
+
+    Recommended
+
+    Now that you're evaluating flags, continue with the resources below to learn what else Feature Flags enables within the PostHog platform.
+
+    | Resource | Description |
+    | --- | --- |
+    | [Creating a feature flag](/docs/feature-flags/creating-feature-flags.md) | How to create a feature flag in PostHog |
+    | [Adding feature flag code](/docs/feature-flags/adding-feature-flag-code.md) | How to check flags in your code for all platforms |
+    | [Framework-specific guides](/docs/feature-flags/tutorials.md#framework-guides) | Setup guides for React Native, Next.js, Flutter, and other frameworks |
+    | [How to do a phased rollout](/tutorials/phased-rollout.md) | Gradually roll out features to minimize risk |
+    | [More tutorials](/docs/feature-flags/tutorials.md) | Other real-world examples and use cases |
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better

package/dist/global-skills/instrument-feature-flags/references/go.md

@@ -0,0 +1,208 @@
+# Go Feature Flags installation - Docs
+
+1.  1
+
+    ## Install the package
+
+    Required
+
+    Install the PostHog Go library:
+
+    Terminal
+
+    PostHog AI
+
+    ```bash
+    go get "github.com/posthog/posthog-go"
+    ```
+
+2.  2
+
+    ## Configure PostHog
+
+    Required
+
+    Initialize the PostHog client with your project token and host:
+
+    main.go
+
+    PostHog AI
+
+    ```go
+    package main
+    import (
+        "github.com/posthog/posthog-go"
+    )
+    func main() {
+        client, _ := posthog.NewWithConfig("<ph_project_token>", posthog.Config{Endpoint: "https://us.i.posthog.com"})
+        defer client.Close()
+    }
+    ```
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, you can manually send events to test your integration:
+
+    Go
+
+    PostHog AI
+
+    ```go
+    client.Enqueue(posthog.Capture{
+        DistinctId: "user_123",
+        Event: "button_clicked",
+        Properties: posthog.NewProperties().
+            Set("button_name", "signup"),
+    })
+    ```
+
+4.  4
+
+    ## Evaluate boolean feature flags
+
+    Required
+
+    Check if a feature flag is enabled:
+
+    ```go
+    isMyFlagEnabled, err := client.IsFeatureEnabled(posthog.FeatureFlagPayload{
+        Key:        "flag-key",
+        DistinctId: "distinct_id_of_your_user",
+    })
+    if err != nil {
+        // Handle error (e.g. capture error and fallback to default behaviour)
+    }
+    if isMyFlagEnabled == true {
+        // Do something differently for this user
+    }
+    ```
+
+5.  5
+
+    ## Evaluate multivariate feature flags
+
+    Optional
+
+    For multivariate flags, check which variant the user has been assigned:
+
+    ```go
+    enabledVariant, err := client.GetFeatureFlag(posthog.FeatureFlagPayload{
+        Key:        "flag-key",
+        DistinctId: "distinct_id_of_your_user",
+    })
+    if err != nil {
+        // Handle error (e.g. capture error and fallback to default behaviour)
+    }
+    if enabledVariant == "variant-key" { // replace 'variant-key' with the key of your variant
+        // Do something differently for this user
+    }
+    ```
+
+6.  6
+
+    ## Include feature flag information in events
+
+    Required
+
+    If you want to use your feature flag to breakdown or filter events in your insights, you'll need to include feature flag information in those events. This ensures that the feature flag value is attributed correctly to the event.
+
+    **Note:** This step is only required for events captured using our server-side SDKs or API.
+
+    ## Set SendFeatureFlags (recommended)
+
+    Set `SendFeatureFlags` to `true` in your capture call:
+
+    Go
+
+    PostHog AI
+
+    ```go
+    client.Enqueue(posthog.Capture{
+        DistinctId: "distinct_id_of_your_user",
+        Event:      "event_name",
+        SendFeatureFlags: true,
+    })
+    ```
+
+    ## Include $feature property
+
+    Include the `$feature/feature_flag_name` property in your event properties:
+
+    Go
+
+    PostHog AI
+
+    ```go
+    client.Enqueue(posthog.Capture{
+        DistinctId: "distinct_id_of_your_user",
+        Event:      "event_name",
+        Properties: posthog.NewProperties().
+            Set("$feature/feature-flag-key", "variant-key"), // replace feature-flag-key with your flag key. Replace 'variant-key' with the key of your variant
+    })
+    ```
+
+7.  7
+
+    ## Override server properties
+
+    Optional
+
+    Sometimes, you may want to evaluate feature flags using properties that haven't been ingested yet, or were set incorrectly earlier. You can provide properties to evaluate the flag with:
+
+    ```go
+    enabledVariant, err := client.GetFeatureFlag(
+        FeatureFlagPayload{
+            Key:        "flag-key",
+            DistinctId: "distinct_id_of_the_user",
+            Groups: posthog.NewGroups().
+                Set("your_group_type", "your_group_id").
+                Set("another_group_type", "your_group_id"),
+            PersonProperties: posthog.NewProperties().
+                Set("property_name", "value"),
+            GroupProperties: map[string]map[string]interface{}{
+                "your_group_type": {
+                    "group_property_name": "value",
+                },
+                "another_group_type": {
+                    "group_property_name": "value",
+                },
+            },
+        },
+    )
+    ```
+
+8.  8
+
+    ## Running experiments
+
+    Optional
+
+    Experiments run on top of our feature flags. Once you've implemented the flag in your code, you run an experiment by creating a new experiment in the PostHog dashboard.
+
+9.  9
+
+    ## Next steps
+
+    Recommended
+
+    Now that you're evaluating flags, continue with the resources below to learn what else Feature Flags enables within the PostHog platform.
+
+    | Resource | Description |
+    | --- | --- |
+    | [Creating a feature flag](/docs/feature-flags/creating-feature-flags.md) | How to create a feature flag in PostHog |
+    | [Adding feature flag code](/docs/feature-flags/adding-feature-flag-code.md) | How to check flags in your code for all platforms |
+    | [Framework-specific guides](/docs/feature-flags/tutorials.md#framework-guides) | Setup guides for React Native, Next.js, Flutter, and other frameworks |
+    | [How to do a phased rollout](/tutorials/phased-rollout.md) | Gradually roll out features to minimize risk |
+    | [More tutorials](/docs/feature-flags/tutorials.md) | Other real-world examples and use cases |
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better