BlazorChat 1.3.0
See the version list below for details.
dotnet add package BlazorChat --version 1.3.0
NuGet\Install-Package BlazorChat -Version 1.3.0
<PackageReference Include="BlazorChat" Version="1.3.0" />
<PackageVersion Include="BlazorChat" Version="1.3.0" />
<PackageReference Include="BlazorChat" />
paket add BlazorChat --version 1.3.0
#r "nuget: BlazorChat, 1.3.0"
#:package BlazorChat@1.3.0
#addin nuget:?package=BlazorChat&version=1.3.0
#tool nuget:?package=BlazorChat&version=1.3.0
BlazorChat - Real-Time Chat for Blazor
Drop-in Chat Widget • SignalR • Emoji Reactions • Themeable
🚀 Quick Start
dotnet add package BlazorChat
Register the in-memory service (demos/testing):
// Program.cs
using BlazorChat.Services;
builder.Services.AddSingleton<IChatService, InMemoryChatService>();
Add the widget to any interactive Razor component:
@page "/my-chat"
@rendermode InteractiveServer
<ChatWidget ThreadId="project-alpha-general"
ChatSender="@currentUser"
ThreadTitle="Project Alpha Chat" />
@code {
private ChatSender currentUser = new() { Id = "user123",
DisplayName = "Sam Wilson",
AvatarUrl = "https://i.pravatar.cc/150?img=11" };
}
Note:
InMemoryChatServiceis for demos only. For production, use BlazorChat.Server.SqlServer withHubUrl="/chathub".
🎯 Features
- Real-time Messaging — instant delivery via SignalR
- Emoji Reactions — react to any message
- Typing Indicators — shows who's typing
- Active User Presence — live count and user list
- Message Editing & Deletion — soft-delete tombstones with undo
- Reply to Message — threaded context
- Themeable — CSS variables, built-in presets (Default, Dark, Teams, Slack), or custom
ChatTheme - Backend Agnostic — implement
IChatServicefor any database
📖 Parameters
| Parameter | Type | Description |
|---|---|---|
ThreadId |
string |
Required. Unique conversation identifier |
ChatSender |
ChatSender |
Required. Current user |
HubUrl |
string |
SignalR hub URL — only needed with BlazorChat.Server (default: /chathub) |
ThreadTitle |
string |
Header title |
ThemePreset |
ChatThemePreset |
Built-in theme (Default, Dark, Teams, Slack) |
CustomTheme |
ChatTheme |
Custom theme override |
WidgetWidth / Height |
string |
Widget dimensions (e.g. "500px", "100%") |
BubbleBackgroundMine / Other |
string |
Bubble CSS colors |
AutoCreateChatService |
bool |
Auto-create SignalRChatService if none injected (default: true) |
🏢 Production — BlazorChat.Server
For production with persistence, add BlazorChat.Server.SqlServer:
- Complete SignalR hub infrastructure
- SQL Server persistence (included SQL scripts)
- Extensible
IChatRepository/IChatPresenceStoreinterfaces - 30-day free trial
📜 License
BlazorChat (this package) is GPL v3 — free and open source. Modifications to BlazorChat itself must remain open-source under GPL v3.
BlazorChat.Server requires a commercial license.
You can use BlazorChat with your own
IChatServiceimplementation without purchasing BlazorChat.Server.
Copyright (C) 2024-2026 LoneWorx LLC
- Demo: loneworx.com/blazor-chat-demo
- Repository: github.com/simscon1/BlazorChat
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
-
net10.0
- BlazorChat.Shared (>= 1.0.3)
- BlazorEmo (>= 1.0.2)
- BlazorRTE (>= 1.2.4)
- Microsoft.AspNetCore.Components.Web (>= 10.0.2)
- Microsoft.AspNetCore.Components.WebAssembly (>= 10.0.2)
- Microsoft.AspNetCore.SignalR.Client (>= 10.0.2)
-
net8.0
- BlazorChat.Shared (>= 1.0.3)
- BlazorEmo (>= 1.0.2)
- BlazorRTE (>= 1.2.4)
- Microsoft.AspNetCore.Components.Web (>= 8.0.12)
- Microsoft.AspNetCore.Components.WebAssembly (>= 8.0.12)
- Microsoft.AspNetCore.SignalR.Client (>= 8.0.12)
-
net9.0
- BlazorChat.Shared (>= 1.0.3)
- BlazorEmo (>= 1.0.2)
- BlazorRTE (>= 1.2.4)
- Microsoft.AspNetCore.Components.Web (>= 9.0.3)
- Microsoft.AspNetCore.Components.WebAssembly (>= 9.0.3)
- Microsoft.AspNetCore.SignalR.Client (>= 9.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
v1.3.0 (2026-03-12):
- Added: .NET 8 and .NET 9 multi-target support
- Added: Embedded debug symbols and SourceLink for consumer debugging
- Fixed: README — corrected quick start example, updated pricing links, removed stale changelog
v1.2.9:
- Updated: BlazorRTE dependency with contenteditable bug fixes for font family and font size dropdown selections
v1.2.8:
- Fixed: Send message on Enter key reliability improvements
v1.2.7:
- Fixed: Emoji reactions replacing each other when multiple different emojis added to the same message
v1.2.6:
- Added: Hover/focus affordance for the active users toggle button (.people-btn)
- Fixed: Active users dropdown panel — styled list of connected users anchored to the chat header
- Fixed: Styled tooltip on the active users badge now matches the BlazorRTE toolbar tooltip (data-tooltip pseudo-element) instead of the unstyled native browser title tooltip
v1.2.5:
- Fixed: Emoji reactions not appearing under message bubbles when using InMemoryChatService directly (without a SignalR hub)
- Fixed: RestoreMessageAsync signature mismatch with IChatService interface — undo-delete was silently no-op in InMemoryChatService
v1.2.4:
- Fixed: BlazorChat.Shared is now declared as a proper package dependency — resolves assembly-not-found errors when consuming BlazorChat from NuGet
- Fixed: BlazorChat.Shared models (ChatMessage, ChatSender, ChatReactionSummary, etc.) are now automatically restored in consumer projects