vybekiit 0.4.0 → 0.6.0

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

@@ -0,0 +1,187 @@
+# PHP Feature Flags installation - Docs
+
+1.  1
+
+    ## Install the package
+
+    Required
+
+    Install the PostHog PHP library using Composer:
+
+    Terminal
+
+    PostHog AI
+
+    ```bash
+    composer require posthog/posthog-php
+    ```
+
+2.  2
+
+    ## Configure PostHog
+
+    Required
+
+    Initialize the PostHog client with your project token and host:
+
+    PHP
+
+    PostHog AI
+
+    ```php
+    PostHog\PostHog::init(
+        '<ph_project_token>',
+        ['host' => 'https://us.i.posthog.com']
+    );
+    ```
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, you can manually send events to test your integration:
+
+    PHP
+
+    PostHog AI
+
+    ```php
+    PostHog::capture([
+        'distinctId' => 'test-user',
+        'event' => 'test-event',
+    ]);
+    ```
+
+4.  4
+
+    ## Evaluate boolean feature flags
+
+    Required
+
+    Check if a feature flag is enabled:
+
+    ```php
+    $isMyFlagEnabledForUser = PostHog::isFeatureEnabled('flag-key', 'distinct_id_of_your_user')
+    if ($isMyFlagEnabledForUser) {
+        // Do something differently for this user
+    }
+    ```
+
+5.  5
+
+    ## Evaluate multivariate feature flags
+
+    Optional
+
+    For multivariate flags, check which variant the user has been assigned:
+
+    ```php
+    $enabledVariant = PostHog::getFeatureFlag('flag-key', 'distinct_id_of_your_user')
+    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 send_feature_flags (recommended)
+
+    Set `send_feature_flags` to `true` in your capture call:
+
+    PHP
+
+    PostHog AI
+
+    ```php
+    PostHog::capture(array(
+        'distinctId' => 'distinct_id_of_your_user',
+        'event' => 'event_name',
+        'send_feature_flags' => true
+    ));
+    ```
+
+    ## Include $feature property
+
+    Include the `$feature/feature_flag_name` property in your event properties:
+
+    PHP
+
+    PostHog AI
+
+    ```php
+    PostHog::capture(array(
+        'distinctId' => 'distinct_id_of_your_user',
+        'event' => 'event_name',
+        'properties' => array(
+            '$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:
+
+    ```php
+    PostHog::getFeatureFlag(
+        'flag-key',
+        'distinct_id_of_the_user',
+        [
+            'your_group_type' => 'your_group_id',
+            'another_group_type' => 'your_group_id'
+        ], // groups
+        ['property_name' => 'value'], // person properties
+        [
+            'your_group_type' => ['group_property_name' => 'value'],
+            'another_group_type' => ['group_property_name' => 'value']
+        ], // group properties
+        false, // onlyEvaluateLocally, Optional. Defaults to false.
+        true // sendFeatureFlagEvents
+    )
+    ```
+
+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

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

@@ -0,0 +1,191 @@
+# Python Feature Flags installation - Docs
+
+1.  1
+
+    ## Install the package
+
+    Required
+
+    Install the PostHog Python library using pip:
+
+    Terminal
+
+    PostHog AI
+
+    ```bash
+    pip install posthog
+    ```
+
+2.  2
+
+    ## Initialize PostHog
+
+    Required
+
+    Initialize the PostHog client with your project token and host from your project settings:
+
+    Python
+
+    PostHog AI
+
+    ```python
+    from posthog import Posthog
+    posthog = Posthog(
+        project_api_key='<ph_project_token>',
+        host='https://us.i.posthog.com'
+    )
+    ```
+
+    **Django integration**
+
+    If you're using Django, check out our [Django integration](/docs/libraries/django.md) for automatic request tracking.
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:
+
+    Capture custom events by calling the `capture` method with an event name and properties:
+
+    Python
+
+    PostHog AI
+
+    ```python
+    import posthog
+    posthog.capture('user_signed_up', distinct_id='user_123', properties={'example_property': 'example_value'})
+    ```
+
+4.  4
+
+    ## Evaluate boolean feature flags
+
+    Required
+
+    Check if a feature flag is enabled:
+
+    ```python
+    is_my_flag_enabled = posthog.feature_enabled('flag-key', 'distinct_id_of_your_user')
+    if is_my_flag_enabled:
+        # Do something differently for this user
+        # Optional: fetch the payload
+        matched_flag_payload = posthog.get_feature_flag_payload('flag-key', 'distinct_id_of_your_user')
+    ```
+
+5.  5
+
+    ## Evaluate multivariate feature flags
+
+    Optional
+
+    For multivariate flags, check which variant the user has been assigned:
+
+    ```python
+    enabled_variant = posthog.get_feature_flag('flag-key', 'distinct_id_of_your_user')
+    if enabled_variant == 'variant-key': # replace 'variant-key' with the key of your variant
+        # Do something differently for this user
+        # Optional: fetch the payload
+        matched_flag_payload = posthog.get_feature_flag_payload('flag-key', 'distinct_id_of_your_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 send_feature_flags (recommended)
+
+    Set `send_feature_flags` to `True` in your capture call:
+
+    Python
+
+    PostHog AI
+
+    ```python
+    posthog.capture(
+        distinct_id="distinct_id_of_the_user",
+        event='event_name',
+        send_feature_flags=True
+    )
+    ```
+
+    ## Include $feature property
+
+    Include the `$feature/feature_flag_name` property in your event properties:
+
+    Python
+
+    PostHog AI
+
+    ```python
+    posthog.capture(
+        "event_name",
+        distinct_id="distinct_id_of_the_user",
+        properties={
+            "$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:
+
+    ```python
+    posthog.get_feature_flag(
+        'flag-key',
+        'distinct_id_of_the_user',
+        person_properties={'property_name': 'value'},
+        groups={
+            'your_group_type': 'your_group_id',
+            'another_group_type': 'your_group_id'},
+        group_properties={
+            '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

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

@@ -0,0 +1,166 @@
+# React Native Feature Flags installation - Docs
+
+1.  1
+
+    ## Install the package
+
+    Required
+
+    Install the PostHog React Native library and its dependencies:
+
+    PostHog AI
+
+    ### Expo
+
+    ```bash
+    npx expo install posthog-react-native expo-file-system expo-application expo-device expo-localization
+    ```
+
+    ### yarn
+
+    ```bash
+    yarn add posthog-react-native @react-native-async-storage/async-storage react-native-device-info react-native-localize
+    # for iOS
+    cd ios && pod install
+    ```
+
+    ### npm
+
+    ```bash
+    npm i -s posthog-react-native @react-native-async-storage/async-storage react-native-device-info react-native-localize
+    # for iOS
+    cd ios && pod install
+    ```
+
+2.  2
+
+    ## Configure PostHog
+
+    Required
+
+    PostHog is most easily used via the `PostHogProvider` component. Wrap your app with the provider:
+
+    App.tsx
+
+    PostHog AI
+
+    ```jsx
+    import { PostHogProvider } from 'posthog-react-native'
+    export function MyApp() {
+        return (
+            <PostHogProvider
+                apiKey="<ph_project_token>"
+                options={{
+                    host: "https://us.i.posthog.com",
+                }}
+            >
+                <RestOfApp />
+            </PostHogProvider>
+        )
+    }
+    ```
+
+3.  3
+
+    ## Send events
+
+    Recommended
+
+    Once installed, PostHog will automatically start capturing events. You can also manually send events using the `usePostHog` hook:
+
+    Component.tsx
+
+    PostHog AI
+
+    ```jsx
+    import { usePostHog } from 'posthog-react-native'
+    function MyComponent() {
+        const posthog = usePostHog()
+        const handlePress = () => {
+            posthog.capture('button_pressed', {
+                button_name: 'signup'
+            })
+        }
+        return <Button onPress={handlePress} title="Sign Up" />
+    }
+    ```
+
+4.  4
+
+    ## Use feature flags
+
+    Required
+
+    PostHog provides hooks to make it easy to use feature flags in your React Native app. Use `useFeatureFlagEnabled` for boolean flags:
+
+    Component.tsx
+
+    PostHog AI
+
+    ```jsx
+    import { usePostHog } from 'posthog-react-native'
+    function MyComponent() {
+        const posthog = usePostHog()
+        const isMyFlagEnabled = posthog.isFeatureEnabled('flag-key')
+        if (isMyFlagEnabled) {
+            // Do something differently for this user
+            // Optional: fetch the payload
+            const matchedFlagPayload = posthog.getFeatureFlagResult('flag-key')?.payload
+        }
+        return <View>...</View>
+    }
+    ```
+
+    ### Multivariate flags
+
+    For multivariate flags, use `getFeatureFlag`:
+
+    Component.tsx
+
+    PostHog AI
+
+    ```jsx
+    import { usePostHog } from 'posthog-react-native'
+    function MyComponent() {
+        const posthog = usePostHog()
+        const enabledVariant = 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
+            const matchedFlagPayload = posthog.getFeatureFlagResult('flag-key')?.payload
+        }
+        return <View>...</View>
+    }
+    ```
+
+5.  5
+
+    ## 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.
+
+6.  6
+
+    ## 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