FireForNet.Firebase.Firestore.Apple 1.0.1-preview.22

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of FireForNet.Firebase.Firestore.Apple. 
dotnet add package FireForNet.Firebase.Firestore.Apple --version 1.0.1-preview.22
                    


                    

                
NuGet\Install-Package FireForNet.Firebase.Firestore.Apple -Version 1.0.1-preview.22
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FireForNet.Firebase.Firestore.Apple" Version="1.0.1-preview.22" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FireForNet.Firebase.Firestore.Apple" Version="1.0.1-preview.22" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FireForNet.Firebase.Firestore.Apple" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FireForNet.Firebase.Firestore.Apple --version 1.0.1-preview.22
                    


                    

                
#r "nuget: FireForNet.Firebase.Firestore.Apple, 1.0.1-preview.22"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package FireForNet.Firebase.Firestore.Apple@1.0.1-preview.22
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FireForNet.Firebase.Firestore.Apple&version=1.0.1-preview.22&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FireForNet.Firebase.Firestore.Apple&version=1.0.1-preview.22&prerelease
                    


                            Install as a Cake Tool

FireForNet.Firebase.Firestore.Apple

Apple-native platform integration for FireForNet Cloud Firestore (iOS, macOS, Mac Catalyst).

About FireForNet

FireForNet is a platform-agnostic, .NET-native Firebase Client SDK developed as part of the Circuids ecosystem. It provides a consistent Firebase client development experience across .NET application environments, while allowing platform-specific implementations where Firebase requires them.

About This Package

This package provides Apple-specific Cloud Firestore functionality for FireForNet. It multi-targets net10.0-ios, net10.0-macos, and net10.0-maccatalyst with no MAUI dependency.

It provides:

  • Transport — native gRPC over HTTP/2, registered automatically.
  • Network detection — AppleNetworkDetector uses NWPathMonitor from the Network framework (available on all three Apple TFMs) and raises NetworkStatusChanged when connectivity changes, enabling Firestore stream recovery.
  • Persistence — SQLite-backed offline cache (via FireForNet.Firebase.Firestore.Sqlite) with Apple path resolution:
    • iOS — the app's Documents directory inside the sandbox container.
    • macOS (native) — ~/Library/Application Support/FireForNet.
    • Mac Catalyst — the app container's Application Support directory.

Installation

dotnet add package FireForNet.Firebase.Firestore.Apple

Usage

services.AddFirebase(new FirebaseOptions
{
    ApiKey = "your-api-key",
    ProjectId = "your-project"
})
.AddFirestore()
.UseApple(options =>
{
    options.DatabaseFileName = "firefornet-firestore.db3";
    options.EnableNetworkDetector = true;
});

MAUI apps on Apple platforms should normally call UseMaui() from FireForNet.Firebase.Firestore.Maui, which delegates to this package on the Apple TFMs.

Minimum OS versions

TFM Minimum
net10.0-ios iOS 15.0
net10.0-macos macOS 10.15 (Catalina)
net10.0-maccatalyst Mac Catalyst 15.0 (macOS 12 Monterey)

NWPathMonitor requires iOS 12+ and macOS 10.15+ — at or below the set floors. Native gRPC requires HTTP/2 support, available on all three targets.

No entitlements required

This package does not require any Apple entitlements. SQLite file access is within the app's sandbox container (iOS / Mac Catalyst) or the user's Application Support directory (macOS). NWPathMonitor is a public Network framework API with no entitlement requirement.

Platform / Framework Support

Platform / Framework Status
iOS Preview
macOS Preview
Mac Catalyst Preview

Documentation

Comprehensive FireForNet documentation is being prepared for the Release Candidate stage.

Project Status

FireForNet is currently available as a Preview release and is approaching its Release Candidate milestone. APIs, package structure, and implementation details may continue to evolve before RC and GA.

The RC milestone will be followed by an extensive cross-platform validation and testing phase before the first GA release.

All FireForNet packages are part of a coordinated release train and share the same version number.

Source Availability

FireForNet is currently being developed in a private source repository during the Preview development phase. The source will be made publicly available as the project approaches its open-source phase, with the public repository established from the appropriate release milestone.

Until then, NuGet Preview packages provide the public distribution channel for evaluating and using FireForNet.

License

This package is licensed under the Apache-2.0 license.

Product Compatible and additional computed target framework versions.
.NET net10.0-ios26.0 is compatible.  net10.0-maccatalyst26.0 is compatible.  net10.0-macos26.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on FireForNet.Firebase.Firestore.Apple:

Package Downloads
FireForNet.Firebase.Firestore.Maui

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1-preview.22 52 9/27/2026
1.0.1-preview.21 58 9/22/2026
1.0.1-preview.20 57 9/18/2026

v1.0.1-preview.22
- Synchronized package version with the preview.22 release.

v1.0.1-preview.21
- No functional changes; synchronized with the framework-free MAUI integration sweep.

v1.0.1-preview.20
- Synchronized package version with the preview.20 release.

v1.0.1-preview.19
- Synchronized package version with the preview.19 release.

v1.0.1-preview.18
- Synchronized package version with the preview.18 release.

v1.0.1-preview.17
- Synchronized package version with the preview.17 release.

v1.0.1-preview.16
- Synchronized package version with the preview.16 release.

v1.0.1-preview.15
- Synchronized package version with the preview.15 release.

v1.0.1-preview.14
- Synchronized package version with the preview.14 release.

v1.0.1-preview.13
- Updated to depend on FireForNet.Firebase.Firestore 1.0.1-preview.13, which adds offline-first optimistic writes (opt-in via FirestoreBuilder.OptimisticWrites) and eliminates the proto-to-JSON round-trip on typed model conversion. Offline writes persist via the SQLite backend.

v1.0.1-preview.12
- Updated to depend on FireForNet.Firebase.Firestore 1.0.1-preview.12, which fixes ObjectDisposedException on SemaphoreSlim.Release() during network disable and UnobservedTaskException from WebChannel receive-loop exceptions during concurrent disposal.