Rask.WebPush 0.23.1-alpha.0.62

This is a prerelease version of Rask.WebPush.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Rask.WebPush --version 0.23.1-alpha.0.62
                    
NuGet\Install-Package Rask.WebPush -Version 0.23.1-alpha.0.62
                    
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="Rask.WebPush" Version="0.23.1-alpha.0.62" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Rask.WebPush" Version="0.23.1-alpha.0.62" />
                    
Directory.Packages.props
<PackageReference Include="Rask.WebPush" />
                    
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 Rask.WebPush --version 0.23.1-alpha.0.62
                    
#r "nuget: Rask.WebPush, 0.23.1-alpha.0.62"
                    
#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 Rask.WebPush@0.23.1-alpha.0.62
                    
#: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=Rask.WebPush&version=0.23.1-alpha.0.62&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Rask.WebPush&version=0.23.1-alpha.0.62&prerelease
                    
Install as a Cake Tool

Rask.WebPush

Server-side Web Push sender. Signs VAPID and encrypts (RFC 8291, aes128gcm) push messages, then POSTs them to a browser PushSubscription endpoint. It is the send half that pairs with Rask.Wasm's IWebPush client — but it is transport-neutral: usable from a Rask Server app or any ASP.NET backend behind a WASM PWA.

No external dependencies beyond Microsoft.Extensions.* — all crypto is in-box System.Security.Cryptography.

Install

dotnet add package Rask.WebPush

Use

The key pair and the contact come from the Rask:WebPush configuration section. A rask new app already has a development pair in its (gitignored) appsettings.Development.json. Otherwise mint one with VapidKeys.Generate() and keep it out of source — the private key signs every push you send:

// appsettings.Development.json — gitignored
{
  "Rask": { "WebPush": { "VapidKeys": { "PublicKey": "…", "PrivateKey": "…" } } }
}

Deployed, both keys come from the environment instead: Rask__WebPush__VapidKeys__PublicKey and Rask__WebPush__VapidKeys__PrivateKey.

// appsettings.json
{
  "Rask": {
    "WebPush": {
      "Subject": "mailto:admin@example.com"    // a contact the push service can reach
    }
  }
}
builder.Services.AddRaskWebPush();   // reads Rask:WebPush; a callback here would run after it and win

// ... inject IWebPush, then given a PushSubscription the browser sent you:
var result = await sender.Send(
    subscription,
    new WebPushMessage { Title = "Hello", Body = "from the server" },
    ct);

// Inspect the result to prune dead subscriptions:
if (result.ShouldDelete) await store.RemoveAsync(subscription);

Notes

  • Standards-based — VAPID (RFC 8292) auth + RFC 8291 aes128gcm payload encryption; interops with any standard browser Push service (FCM, Mozilla, WNS).
  • Zero external deps — ECDH, HKDF and AES-GCM come from System.Security.Cryptography.
  • Generate a VAPID key pair once with VapidKeys.Generate() and keep the private key server-side; hand the public key to the browser subscription.
  • Send returns a WebPushResult whose ShouldDelete / ShouldRetry flags map the push service's response to the action to take on the subscription.

Full documentation: https://github.com/pal-tamas/rask/blob/main/docs/pwa.md

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.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 Rask.WebPush:

Package Downloads
Rask.Server

The ASP.NET host for Rask, a full-stack .NET web framework, with every battery: database (SQLite, PostgreSQL or SQL Server, picked by Rask:Database:Provider), mediator and query cache, accounts, background jobs, transactional email, cache, file storage, outbox, operator dashboard, durable logs, Web Push, SQLite snapshots and continuous backup. Renders Rask components with live updates over a WebSocket. RaskApp.Create(args).Run<App>() is the whole Program.cs; app.Configure(c => c.Jobs.Off()) is how an app does without one. Depends on Rask, the shared core.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.23.1-alpha.0.84 25 9/25/2026
0.23.1-alpha.0.82 0 9/25/2026
0.23.1-alpha.0.81 13 9/25/2026
0.23.1-alpha.0.80 18 9/25/2026
0.23.1-alpha.0.79 23 9/25/2026
0.23.1-alpha.0.78 19 9/25/2026
0.23.1-alpha.0.76 30 9/25/2026
0.23.1-alpha.0.74 21 9/25/2026
0.23.1-alpha.0.72 28 9/25/2026
0.23.1-alpha.0.70 32 9/25/2026
0.23.1-alpha.0.69 35 9/25/2026
0.23.1-alpha.0.68 30 9/25/2026
0.23.1-alpha.0.67 30 9/25/2026
0.23.1-alpha.0.66 31 9/24/2026
0.23.1-alpha.0.65 27 9/24/2026
0.23.1-alpha.0.64 35 9/24/2026
0.23.1-alpha.0.62 35 9/24/2026
0.23.1-alpha.0.61 33 9/24/2026
0.23.1-alpha.0.50 34 9/24/2026
0.23.0 159 9/18/2026
Loading failed