FireForNet.Firebase.RemoteConfig.Windows 1.0.1-preview.22

FireForNet.Firebase.RemoteConfig.Windows

Windows desktop integration for FireForNet Firebase Remote Config.

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 Windows-specific functionality for Firebase Remote Config:

• Persistence — SQLite-backed storage (via FireForNet.Firebase.RemoteConfig.Sqlite) for the Remote Config containers, settings, and metadata, resolving the database path from the user's LocalApplicationData directory.
• Realtime lifecycle monitoring — a Windows lifecycle monitor that disconnects the realtime stream on sleep/lock and reconnects on resume/unlock.

It targets net10.0-windows10.0.19041.0 with no WinForms/WPF dependency.

Installation

dotnet add package FireForNet.Firebase.RemoteConfig.Windows

Usage

services.AddFirebase(new FirebaseOptions
{
    ApiKey = "your-api-key",
    ProjectId = "your-project"
})
.AddFirebaseRemoteConfig()
.UseWindows(options =>
{
    options.DatabaseFileName = "firefornet-remoteconfig.db3";
    options.EnableLifecycleMonitor = true;
});

MAUI apps on Windows should normally call UseMaui() from FireForNet.Firebase.RemoteConfig.Maui-chained flows, which delegate to this package on the Windows TFM.

Installations chaining

UseWindows() chains Installations.Windows.UseWindows() when the installation store is still the in-memory default, so Remote Config's installation ID is persisted alongside the config data. To use a custom installation store, register it before calling UseWindows().

Lifecycle monitor

The WindowsLifecycleMonitor maps Windows power-management and session events to IRealtimeLifecycleMonitor:

• Suspend/Resume — PowerRegisterSuspendResumeNotification (callback-based, no window required).
• Session Lock/Unlock — WTSRegisterSessionNotification via a message-only window on a dedicated background thread.

When the desktop sleeps or the session locks, the realtime stream disconnects. On resume or unlock, it reconnects. Set EnableLifecycleMonitor = false to disable, or register a custom IRealtimeLifecycleMonitor after calling UseWindows() to override it.

Platform / Framework Support

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.