{"id":19149803,"url":"https://github.com/harness/ff-dotnet-wasm-client-sdk","last_synced_at":"2026-02-07T21:04:20.758Z","repository":{"id":240015818,"uuid":"797697655","full_name":"harness/ff-dotnet-wasm-client-sdk","owner":"harness","description":"FF .NET client SDK for Blazor WebAssembly","archived":false,"fork":false,"pushed_at":"2025-10-22T13:38:31.000Z","size":343,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-22T15:40:06.958Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harness.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-05-08T10:46:08.000Z","updated_at":"2025-10-21T12:25:54.000Z","dependencies_parsed_at":"2025-04-14T17:21:14.557Z","dependency_job_id":"5d7a7eb7-5880-462a-8023-1bc9a0c89400","html_url":"https://github.com/harness/ff-dotnet-wasm-client-sdk","commit_stats":null,"previous_names":["harness/ff-dotnet-wasm-client-sdk"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/harness/ff-dotnet-wasm-client-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fff-dotnet-wasm-client-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fff-dotnet-wasm-client-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fff-dotnet-wasm-client-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fff-dotnet-wasm-client-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harness","download_url":"https://codeload.github.com/harness/ff-dotnet-wasm-client-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harness%2Fff-dotnet-wasm-client-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29208176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T20:33:12.493Z","status":"ssl_error","status_checked_at":"2026-02-07T20:30:47.381Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T08:09:43.307Z","updated_at":"2026-02-07T21:04:20.751Z","avatar_url":"https://github.com/harness.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ff-dotnet-wasm-client-sdk\nFF .NET client SDK for [Blazor WebAssembly](https://dotnet.microsoft.com/en-us/apps/aspnet/web-apps/blazor)\n\n# Intro\nUse this README to get started with our Feature Flags (FF) Client SDK for .NET. This guide outlines the basics of getting started with the SDK and provides a full code sample for you to try out. This sample doesn’t include configuration options, for in depth steps and configuring the SDK, for example, disabling streaming or using our Relay Proxy, see the .NET SDK Reference.\n\n`ff-dotnet-wasm-client-sdk` allows you to run a Feature Flags client inside a WebAssembly (Wasm) Virtual Machine on a browser. For a detailed overview of Wasm see [MDN web docs](https://developer.mozilla.org/en-US/docs/WebAssembly).\nIt supports polling, metrics and streaming via `Microsoft.AspNetCore.Components.WebAssembly.Http.HttpRequestMessage` and uses a non-threaded design based async/await C# methods and timers for compatibility with the limited .NET APIs available in the VM.\n\n\n![FeatureFlags](docs/images/ff-gui.png)\n\n\n# Which SDK to use?\n\nHarness Feature flags provide several .NET SDKs. Broadly speaking a client SDK serves one end user (or target) whereas a server SDK handles many targets.\nA client SDK typically requires less CPU and network bandwith as they don't process rules locally, so are more suited to web browsers, phone and desktop apps.\nServer SDKs are designed for server environments, since potentially sensitive rule config is pulled, the SDK API key should be treated as a backend secret and not exposed.\n\n## ff-dotnet-wasm-client-sdk\n\nThis repository. This is a client SDK - it is designed to run client-side inside the web browser's WebAssembly Virtual Machine.\nIt imports some wasm specific modules for streaming support.\n\n## ff-dotnet-client-sdk\n\nThis is a generic .NET C# client SDK designed for desktop and mobule apps via MAUI. See the [Github repository](https://github.com/harness/ff-dotnet-client-sdk)\n\n## ff-dotnet-server-sdk\n\nOur server side .NET C# server SDK, designed for server environments. See the [Github repository](https://github.com/harness/ff-dotnet-server-sdk)\n\n\n## Requirements\nThe library is packaged as multi-target supporting  `net5.0`, `net6.0`, `net7.0`  and `net8.0`.\n\n## Build Requirements\nIf building from source you will need [.Net 8.0.100](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) or newer (dotnet --version)\u003cbr\u003e\n\n\n## Quickstart\nTo follow along with our test code sample, make sure you’ve:\n\n- [Created a Feature Flag on the Harness Platform](https://ngdocs.harness.io/article/1j7pdkqh7j-create-a-feature-flag) called harnessappdemodarkmode\n- [Created a server SDK key and made a copy of it](https://ngdocs.harness.io/article/1j7pdkqh7j-create-a-feature-flag#step_3_create_an_sdk_key)\n\n\n### Install the SDK\nAdd the sdk using dotnet\n```bash\ndotnet add package ff-dotnet-wasm-client-sdk\n```\n\n\n# Getting started\n\nSome sample applications are [provided](examples/) to help you test the SDK for the first time.\nYou will need to create a boolean flag called `harnessappdemodarkmode` and have a client API key for the SDK to authenticate. Edit `FeatureFlagsContext.cs` and add your client API to `_apiKey`.\nMake sure you have the WASM workflows installed for your particular development environment. This is not described here but you can find more information from Microsoft at [Blazor WebAssembly build tools](https://learn.microsoft.com/en-us/aspnet/core/blazor/webassembly-build-tools-and-aot?view=aspnetcore-8.0).\n\n\n### Running the example\n\nThe `dotnet watch` command will open up a browser:\n\n```bash\ncd examples/blazor-wasm\ndotnet watch\n```\n\nAlso, a small command line version has been provided. This runs from the console. To see full browser integration checkout the [Blazor WASM example](examples/blazor-wasm)\n\n```bash\ncd examples/getting-started\nexport FF_API_KEY=\u003cyour key here\u003e\ndotnet run\n```\n\n\n### Additional Reading\n\n\nFor further examples and config options, see the [Client SDK Reference](https://developer.harness.io/docs/category/client-sdk-guides).\n\nFor more information about Feature Flags, see our [Feature Flags documentation](https://ngdocs.harness.io/article/0a2u2ppp8s-getting-started-with-feature-flags).\n\n\n-------------------------\n[Harness](https://www.harness.io/) is a feature management platform that helps teams to build better software and to\ntest features quicker.\n\n-------------------------\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharness%2Fff-dotnet-wasm-client-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharness%2Fff-dotnet-wasm-client-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharness%2Fff-dotnet-wasm-client-sdk/lists"}