AdamEssenmacher · AdamEssenmacher · Apr 13, 2026 · Apr 13, 2026
diff --git a/docs/Firebase/NuGet/ABTesting.md b/docs/Firebase/NuGet/ABTesting.md
@@ -0,0 +1,151 @@
+# AdamE.Firebase.iOS.ABTesting
+
+.NET bindings for Firebase A/B Testing on Apple platforms, for use from .NET iOS and Mac Catalyst apps.
+
+## What this package provides
+
+This package binds the Firebase A/B Testing Apple SDK surface exposed in the `Firebase.ABTesting` namespace. It provides access to experiment payload coordination APIs such as `ExperimentController`, `LifecycleEvents`, and default experiment lifecycle event names.
+
+Use this package when you need:
+
+- Firebase A/B Testing experiment payload handling from C#
+- access to `ExperimentController.SharedInstance`
+- experiment lifecycle event names for activation, timeout, expiration, and clearing
+
+Most app code uses this package indirectly through Firebase feature packages such as Remote Config, In-App Messaging, or Performance Monitoring.
+
+## Official Firebase documentation comes first
+
+These packages are **thin .NET bindings over the official Firebase Apple SDKs**.
+
+Use the official Firebase documentation as the starting point for:
+
+- Firebase configuration and platform setup
+- feature usage and behavioral guidance
+- troubleshooting and best practices
+
+These bindings primarily:
+
+- expose the native Firebase Apple SDK APIs to .NET through C#
+- deliver the packaged native Firebase SDK artifacts through NuGet
+
+- Firebase documentation: https://firebase.google.com/docs
+- Firebase Apple platform setup: https://firebase.google.com/docs/ios/setup
+- Firebase A/B Testing documentation: https://firebase.google.com/docs/ab-testing/
+
+## Supported target frameworks
+
+This package is intended for Apple platform TFMs such as:
+
+- `net9.0-ios`
+- `net10.0-ios`
+- `net9.0-maccatalyst`
+- `net10.0-maccatalyst`
+
+When multi-targeting, condition the package reference so it only restores for Apple targets.
+
+```xml
+<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios' Or $([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">
+  <PackageReference Include="AdamE.Firebase.iOS.ABTesting" Version="12.6.0" />
+</ItemGroup>
+```
+
+## Installation
+
+```sh
+dotnet add package AdamE.Firebase.iOS.ABTesting
+```
+
+## Basic usage
+
+This package does not itself perform Firebase app initialization; call `Firebase.Core.App.Configure()` from the app before using Firebase feature APIs. Direct use of A/B Testing payload APIs is uncommon in app code, but the binding exposes the native controller surface.
+
+```csharp
+using System;
+using Firebase.ABTesting;
+using Firebase.Core;
+using Foundation;
+
+App.Configure();
+
+var controller = ExperimentController.SharedInstance;
+var events = new LifecycleEvents
+{
+    SetExperimentEventName = DefaultLifecycleEventNames.SetExperiment,
+    ActivateExperimentEventName = DefaultLifecycleEventNames.ActivateExperiment,
+    ClearExperimentEventName = DefaultLifecycleEventNames.ClearExperiment,
+    TimeoutExperimentEventName = DefaultLifecycleEventNames.TimeoutExperiment,
+    ExpireExperimentEventName = DefaultLifecycleEventNames.ExpireExperiment,
+};
+
+controller.UpdateExperiments(
+    "remote-config",
+    events,
+    ExperimentPayloadExperimentOverflowPolicy.DiscardOldest,
+    0,
+    Array.Empty<NSData>(),
+    error =>
+    {
+        if (error is not null)
+        {
+            Console.WriteLine(error.LocalizedDescription);
+        }
+    });
+```
+
+## Common companion packages
+
+- `AdamE.Firebase.iOS.Core` - Firebase app initialization.
+- `AdamE.Firebase.iOS.RemoteConfig` - commonly uses A/B Testing experiment payloads.
+- `AdamE.Firebase.iOS.InAppMessaging` - commonly uses A/B Testing experiment payloads.
+- `AdamE.Firebase.iOS.PerformanceMonitoring` - package metadata references A/B Testing as a companion dependency.
+
+## Firebase app configuration
+
+Firebase apps commonly require app-specific configuration from your own Firebase project, such as `GoogleService-Info.plist`.
+
+Keep app-specific Firebase configuration in the application project or sample app, not in reusable library projects.
+
+If the official Firebase docs for this feature require additional setup, follow those docs first.
+
+## Package versioning rules (important)
+
+Because Firebase Apple SDKs are packaged as native xcframeworks and distributed here through NuGet, consumers should explicitly pin package versions.
+
+Due to packaging differences between CocoaPods and NuGet, it is highly recommended that applications follow these rules:
+
+1. Keep the MAJOR.MINOR version aligned across all Firebase packages in the app, for example `12.6.*.*`.
+2. Then use the latest available PATCH.REVISION for each individual package.
+
+Example:
+
+```xml
+<ItemGroup>
+  <PackageReference Include="AdamE.Firebase.iOS.Core" Version="12.6.0.3" />
+  <PackageReference Include="AdamE.Firebase.iOS.Auth" Version="12.6.0.2" />
+  <PackageReference Include="AdamE.Firebase.iOS.CloudFirestore" Version="12.6.0.5" />
+</ItemGroup>
+```
+
+Avoid mixing mismatched Firebase package lines such as `12.6.x.x` with `12.5.x.x`, or `12.x.x.x` with `11.x.x.x`. Doing so can lead to native dependency conflicts, duplicate symbols, runtime failures, or other undefined behavior.
+
+## Notes on native dependency conflicts
+
+Google and Firebase Apple SDKs share native dependencies. Avoid mixing multiple unrelated binding packages that embed overlapping Google/Firebase native SDK binaries in the same app unless you are certain they are compatible.
+
+## API surface notes
+
+The public namespace is `Firebase.ABTesting`. API names closely mirror the native Firebase Apple SDK surface and expose Apple-native concepts such as `NSError`, `NSData`, and callback-based completion handlers.
+
+## Repository / support
+
+- Repository: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents
+- Issues: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents/issues
+
+## Support the project
+
+Keeping Firebase Apple bindings current for .NET requires ongoing work across SDK updates, native dependency changes, and API surface maintenance.
+
+If this package is valuable in your app or organization, sponsorship helps support continued maintenance and updates.
+
+- GitHub Sponsors: https://github.com/sponsors/AdamEssenmacher
diff --git a/docs/Firebase/NuGet/Analytics.md b/docs/Firebase/NuGet/Analytics.md
@@ -0,0 +1,134 @@
+# AdamE.Firebase.iOS.Analytics
+
+.NET bindings for Firebase Analytics on Apple platforms, for use from .NET iOS and Mac Catalyst apps.
+
+## What this package provides
+
+This package binds the Firebase Analytics Apple SDK surface exposed in the `Firebase.Analytics` namespace. It provides static `Analytics` APIs and event, parameter, user property, consent, and session constants for reporting app analytics data to Firebase.
+
+Use this package when you need:
+
+- analytics event logging with `Analytics.LogEvent`
+- user property and user ID reporting with `Analytics.SetUserProperty` and `Analytics.SetUserId`
+- analytics collection, consent, and session controls
+- access to the Firebase Analytics app instance ID
+
+Most apps using this package also reference `AdamE.Firebase.iOS.Core` for Firebase app initialization.
+
+## Official Firebase documentation comes first
+
+These packages are **thin .NET bindings over the official Firebase Apple SDKs**.
+
+Use the official Firebase documentation as the starting point for:
+
+- Firebase configuration and platform setup
+- feature usage and behavioral guidance
+- troubleshooting and best practices
+
+These bindings primarily:
+
+- expose the native Firebase Apple SDK APIs to .NET through C#
+- deliver the packaged native Firebase SDK artifacts through NuGet
+
+- Firebase documentation: https://firebase.google.com/docs
+- Firebase Apple platform setup: https://firebase.google.com/docs/ios/setup
+- Firebase Analytics documentation: https://firebase.google.com/docs/analytics/ios/start
+
+## Supported target frameworks
+
+This package is intended for Apple platform TFMs such as:
+
+- `net9.0-ios`
+- `net10.0-ios`
+- `net9.0-maccatalyst`
+- `net10.0-maccatalyst`
+
+When multi-targeting, condition the package reference so it only restores for Apple targets.
+
+```xml
+<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios' Or $([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">
+  <PackageReference Include="AdamE.Firebase.iOS.Analytics" Version="12.6.0" />
+</ItemGroup>
+```
+
+## Installation
+
+```sh
+dotnet add package AdamE.Firebase.iOS.Analytics
+```
+
+## Basic usage
+
+This package does not itself perform Firebase app initialization; call `Firebase.Core.App.Configure()` from the app before using Firebase feature APIs.
+
+```csharp
+using System.Collections.Generic;
+using Firebase.Analytics;
+using Firebase.Core;
+
+App.Configure();
+
+Analytics.LogEvent(EventNamesConstants.SelectContent, new Dictionary<object, object>
+{
+    { ParameterNamesConstants.ContentType, "screen" },
+    { ParameterNamesConstants.ItemId, "home" },
+});
+
+Analytics.SetUserProperty("paid", "account_type");
+Analytics.SetUserId("user-123");
+```
+
+## Common companion packages
+
+- `AdamE.Firebase.iOS.Core` - Firebase app initialization.
+- `AdamE.Firebase.iOS.Installations` - package metadata references Firebase Installations for underlying Firebase identity support.
+
+## Firebase app configuration
+
+Firebase apps commonly require app-specific configuration from your own Firebase project, such as `GoogleService-Info.plist`.
+
+Keep app-specific Firebase configuration in the application project or sample app, not in reusable library projects.
+
+If the official Firebase docs for this feature require additional setup, follow those docs first.
+
+## Package versioning rules (important)
+
+Because Firebase Apple SDKs are packaged as native xcframeworks and distributed here through NuGet, consumers should explicitly pin package versions.
+
+Due to packaging differences between CocoaPods and NuGet, it is highly recommended that applications follow these rules:
+
+1. Keep the MAJOR.MINOR version aligned across all Firebase packages in the app, for example `12.6.*.*`.
+2. Then use the latest available PATCH.REVISION for each individual package.
+
+Example:
+
+```xml
+<ItemGroup>
+  <PackageReference Include="AdamE.Firebase.iOS.Core" Version="12.6.0.3" />
+  <PackageReference Include="AdamE.Firebase.iOS.Auth" Version="12.6.0.2" />
+  <PackageReference Include="AdamE.Firebase.iOS.CloudFirestore" Version="12.6.0.5" />
+</ItemGroup>
+```
+
+Avoid mixing mismatched Firebase package lines such as `12.6.x.x` with `12.5.x.x`, or `12.x.x.x` with `11.x.x.x`. Doing so can lead to native dependency conflicts, duplicate symbols, runtime failures, or other undefined behavior.
+
+## Notes on native dependency conflicts
+
+Google and Firebase Apple SDKs share native dependencies. Avoid mixing multiple unrelated binding packages that embed overlapping Google/Firebase native SDK binaries in the same app unless you are certain they are compatible.
+
+## API surface notes
+
+The public namespace is `Firebase.Analytics`. API names closely mirror the native Firebase Analytics SDK surface, including static APIs on `Analytics` and Apple-native data shapes such as `NSDictionary` for parameter dictionaries.
+
+## Repository / support
+
+- Repository: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents
+- Issues: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents/issues
+
+## Support the project
+
+Keeping Firebase Apple bindings current for .NET requires ongoing work across SDK updates, native dependency changes, and API surface maintenance.
+
+If this package is valuable in your app or organization, sponsorship helps support continued maintenance and updates.
+
+- GitHub Sponsors: https://github.com/sponsors/AdamEssenmacher