DotNetQuery.Blazor 1.0.0-beta.0

DotNet Query

A TanStack Query-inspired async data fetching and state management library for .NET and Blazor.

DotNet Query brings the proven data-fetching patterns of TanStack Query to the .NET ecosystem. It provides a structured, reactive approach to managing asynchronous data, caching, and mutations — removing boilerplate and giving you predictable loading, error, and success states out of the box.

Features

• Queries — fetch async data with automatic caching, background refetching, and stale-while-revalidate semantics
• Mutations — execute data-modifying operations with lifecycle callbacks and automatic cache invalidation
• Reactive state — built on Rx.NET, every query and mutation exposes IObservable streams for composable async pipelines
• Retry logic — configurable retry strategies with exponential backoff out of the box
• Query deduplication — identical keys share a single cached query instance
• CSR / SSR modes — QueryExecutionMode controls singleton (WebAssembly) vs scoped (Server-Side Rendering) lifetime
• DI integration — first-class support for Microsoft.Extensions.DependencyInjection
• Blazor components — <Suspense> and <Transition> components for declarative query rendering in Blazor

Documentation

Full API reference and usage guides are published via docfx and available at (link TBD).

Developer Documentation

Prerequisites

A Nix flake is provided for reproducible dev environments. With direnv installed, run direnv allow in the repo root to activate it automatically.

Getting Started

# Restore tools and packages
dotnet tool restore
dotnet restore

# Build
dotnet build

# Run tests
dotnet test

# Check formatting
dotnet csharpier check .

Project Structure

src/
  DotNetQuery.Core/                          Core interfaces and implementations
  DotNetQuery.Blazor/                        Blazor components (Suspense, Transition)
  DotNetQuery.Extensions.DependencyInjection/ DI extension methods
tests/
  DotNetQuery.Core.Tests/
  DotNetQuery.Extensions.DependencyInjection.Tests/

CI / CD

The build pipeline runs on every push and pull request to main:

1. Restore tools and packages
2. CSharpier format check
3. Release build
4. Tests with code coverage (Cobertura)
5. Coverage upload to Codecov

Dependency updates are managed automatically via Dependabot (weekly, for NuGet and GitHub Actions).

License

MIT — Copyright (c) 2026 Patrick Sachmann