vybekiit 0.4.0 → 0.6.0

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

@@ -0,0 +1,146 @@
+# iOS Feature Flags installation - Docs
+
+1.  1
+
+    ## Install dependency
+
+    Required
+
+    Install via Swift Package Manager:
+
+    Package.swift
+
+    PostHog AI
+
+    ```swift
+    dependencies: [
+      .package(url: "https://github.com/PostHog/posthog-ios.git", from: "3.56.0")
+    ]
+    ```
+
+    Or add PostHog to your Podfile:
+
+    Podfile
+
+    PostHog AI
+
+    ```ruby
+    pod "PostHog", "~> 3.56"
+    ```
+
+2.  2
+
+    ## Configure PostHog
+
+    Required
+
+    Initialize PostHog in your AppDelegate:
+
+    AppDelegate.swift
+
+    PostHog AI
+
+    ```swift
+    import Foundation
+    import PostHog
+    import UIKit
+    class AppDelegate: NSObject, UIApplicationDelegate {
+        func application(_: UIApplication, didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
+            let POSTHOG_PROJECT_TOKEN = "<ph_project_token>"
+            let POSTHOG_HOST = "https://us.i.posthog.com"
+            let config = PostHogConfig(projectToken: POSTHOG_PROJECT_TOKEN, host: POSTHOG_HOST)
+            PostHogSDK.shared.setup(config)
+            return true
+        }
+    }
+    ```
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:
+
+    Swift
+
+    PostHog AI
+
+    ```swift
+    PostHogSDK.shared.capture("button_clicked", properties: ["button_name": "signup"])
+    ```
+
+4.  4
+
+    ## Evaluate boolean feature flags
+
+    Required
+
+    Check if a feature flag is enabled:
+
+    Swift
+
+    PostHog AI
+
+    ```swift
+    let isMyFlagEnabled = PostHogSDK.shared.isFeatureEnabled("flag-key")
+    if isMyFlagEnabled {
+        // Do something differently for this user
+        // Optional: fetch the payload
+        let matchedFlagPayload = PostHogSDK.shared.getFeatureFlagResult("flag-key")?.payload
+    }
+    ```
+
+5.  5
+
+    ## Evaluate multivariate feature flags
+
+    Optional
+
+    For multivariate flags, check which variant the user has been assigned:
+
+    Swift
+
+    PostHog AI
+
+    ```swift
+    let enabledVariant = PostHogSDK.shared.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
+        let matchedFlagPayload = PostHogSDK.shared.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/java.md

@@ -0,0 +1,94 @@
+# Java Feature Flags installation - Docs
+
+The best way to install the PostHog Java SDK is with a build system like Gradle or Maven. This ensures you can easily upgrade to the latest versions.
+
+Look up the latest version of [`com.posthog.posthog-server`](https://central.sonatype.com/artifact/com.posthog/posthog-server).
+
+#### Gradle
+
+All you need to do is add the `posthog-server` module to your `build.gradle`:
+
+build.gradle
+
+PostHog AI
+
+```kotlin
+dependencies {
+  implementation 'com.posthog:posthog-server:2.+'
+}
+```
+
+#### Maven
+
+All you need to do is add the `posthog-server` module to your `pom.xml`:
+
+pom.xml
+
+PostHog AI
+
+```xml
+<dependency>
+  <groupId>com.posthog</groupId>
+  <artifactId>posthog-server</artifactId>
+  <version>LATEST</version>
+</dependency>
+```
+
+#### Other
+
+See [`com.posthog.posthog-server`](https://central.sonatype.com/artifact/com.posthog/posthog-server) in the Maven Central Repository. Clicking on the latest version shows you options for adding dependencies for other build systems.
+
+### Setup
+
+Java
+
+PostHog AI
+
+```java
+import com.posthog.server.PostHog;
+import com.posthog.server.PostHogConfig;
+import com.posthog.server.PostHogInterface;
+class Sample {
+  private static final String POSTHOG_API_KEY = "<ph_project_token>";
+  private static final String POSTHOG_HOST = "https://us.i.posthog.com";
+  public static void main(String args[]) {
+    PostHogConfig config = PostHogConfig
+            .builder(POSTHOG_API_KEY)
+            .host(POSTHOG_HOST)
+            .build();
+    PostHogInterface posthog = PostHog.with(config);
+    posthog.flush(); // send any remaining events
+    posthog.close(); // shut down the client
+  }
+}
+```
+
+## Integrating with Spring
+
+To see how to integrate the PostHog SDK with Spring, check out this [sample project](https://github.com/PostHog/posthog-android/tree/main/posthog-samples/posthog-spring-sample).
+
+## Debug mode
+
+If you're not seeing the expected events being captured, or the feature flags being evaluated, you can enable debug mode to see what's happening.
+
+To see detailed logging, set the debug configuration option to true.
+
+Java
+
+PostHog AI
+
+```java
+PostHogConfig config = PostHogConfig
+          .builder(POSTHOG_API_KEY)
+          .host(POSTHOG_HOST)
+          .debug(true)
+          .build();
+```
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better

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

@@ -0,0 +1,170 @@
+# Laravel - Docs
+
+PostHog integrates with Laravel through the [PostHog PHP SDK](/docs/libraries/php.md). This page covers Laravel-specific setup. For SDK features such as event capture, identifying users, feature flags, group analytics, and configuration options, see the [PHP SDK docs](/docs/libraries/php.md).
+
+## Installation
+
+Install the PHP SDK as described in the [PHP installation guide](/docs/libraries/php.md#installation), then add your project token and host to `.env`:
+
+.env
+
+PostHog AI
+
+```bash
+POSTHOG_API_KEY=<ph_project_token>
+POSTHOG_HOST=https://us.i.posthog.com
+```
+
+Add PostHog to Laravel's services config:
+
+config/services.php
+
+PostHog AI
+
+```php
+'posthog' => [
+    'api_key' => env('POSTHOG_API_KEY'),
+    'host' => env('POSTHOG_HOST', 'https://us.i.posthog.com'),
+],
+```
+
+Initialize PostHog in the `boot` method of `app/Providers/AppServiceProvider.php`:
+
+app/Providers/AppServiceProvider.php
+
+PostHog AI
+
+```php
+<?php
+namespace App\Providers;
+use Illuminate\Support\ServiceProvider;
+use PostHog\PostHog;
+class AppServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        if (! config('services.posthog.api_key')) {
+            return;
+        }
+        PostHog::init(
+            config('services.posthog.api_key'),
+            [
+                'host' => config('services.posthog.host'),
+            ]
+        );
+    }
+}
+```
+
+## Request context middleware
+
+Client SDKs such as [PostHog JS](/docs/libraries/js.md) can send tracing headers to your Laravel backend. Configure [`tracing_headers`](/docs/libraries/js/config.md#tracing-headers) for your Laravel backend hostname so browser requests include the session and distinct ID headers.
+
+The PHP SDK can read `X-PostHog-Distinct-Id` and `X-PostHog-Session-Id` headers and apply them to events captured during the request. Tracing headers are client-controlled analytics context, not authentication or authorization. For security-sensitive server-side events or decisions, pass an authenticated `distinctId` explicitly, such as `auth()->id()`. For the lower-level context APIs, see the [PHP request context docs](/docs/libraries/php.md#request-context).
+
+Add middleware like this:
+
+app/Http/Middleware/PostHogRequestContext.php
+
+PostHog AI
+
+```php
+<?php
+namespace App\Http\Middleware;
+use Closure;
+use Illuminate\Http\Request;
+use PostHog\PostHog;
+use Symfony\Component\HttpFoundation\Response;
+final class PostHogRequestContext
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        if (! config('services.posthog.api_key')) {
+            return $next($request);
+        }
+        $context = PostHog::contextFromHeaders($request->headers->all());
+        $context['properties'] = array_merge(
+            $context['properties'] ?? [],
+            array_filter([
+                '$current_url' => $request->fullUrl(),
+                '$request_method' => $request->method(),
+                '$request_path' => $request->getPathInfo(),
+                '$user_agent' => $request->userAgent(),
+                '$ip' => $request->ip(),
+            ], static fn ($value): bool => $value !== null && $value !== '')
+        );
+        return PostHog::withContext(
+            $context,
+            static fn (): Response => $next($request),
+            ['fresh' => true]
+        );
+    }
+}
+```
+
+Register this middleware using your Laravel version's normal middleware registration.
+
+## Error tracking in Laravel
+
+The PHP SDK supports [error tracking](/docs/libraries/php.md#error-tracking), but Laravel handles most request exceptions before they become uncaught PHP exceptions. Capture Laravel-reported exceptions explicitly.
+
+In Laravel 11 and later, add a report callback in `bootstrap/app.php`:
+
+bootstrap/app.php
+
+PostHog AI
+
+```php
+use Illuminate\Foundation\Configuration\Exceptions;
+use PostHog\PostHog;
+use Throwable;
+->withExceptions(function (Exceptions $exceptions): void {
+    $exceptions->report(function (Throwable $e): void {
+        if (! config('services.posthog.api_key')) {
+            return;
+        }
+        PostHog::captureException(
+            $e,
+            auth()->id() !== null ? (string) auth()->id() : null,
+            [
+                '$current_url' => request()->fullUrl(),
+                '$request_method' => request()->method(),
+            ]
+        );
+    });
+})
+```
+
+For older Laravel versions, call `PostHog::captureException()` from your exception handler's `report` method.
+
+## Long-running processes
+
+In normal PHP request lifecycles, queued events flush when the client is destroyed. In long-running Laravel processes such as queue workers, Horizon, or Octane, call `PostHog::flush()` after capturing important events or at the end of a job/request.
+
+If you prefer immediate delivery in queue workers, configure the PHP SDK with `batch_size` set to `1` for those workers:
+
+PHP
+
+PostHog AI
+
+```php
+PostHog::init(
+    '<ph_project_token>',
+    [
+        'host' => config('services.posthog.host'),
+        'batch_size' => 1,
+    ]
+);
+```
+
+## Next steps
+
+See the [PHP SDK docs](/docs/libraries/php.md) for usage examples and the full API reference.
+
+### Community questions
+
+Ask a question
+
+### Was this page useful?
+
+HelpfulCould be better