👁 Image
ZeroAlloc.Scheduling.Dashboard.Blazor 1.0.1

ZeroAlloc.Scheduling

👁 NuGet
👁 Build
👁 GitHub Sponsors

ZeroAlloc.Scheduling is a source-generated background job scheduler for .NET 8 and .NET 10. Decorate any class with [Job] and the source generator wires up the executor, DI registration, and recurring startup automatically — no reflection, no convention scanning at runtime.

Install

dotnet add package ZeroAlloc.Scheduling
dotnet add package ZeroAlloc.Scheduling.InMemory # or EfCore / Redis

The generator package must be added as an analyzer:

<PackageReference Include="ZeroAlloc.Scheduling.Generator" Version="*" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />

Example

// 1. Define a job — the generator picks it up automatically
[Job(Every = Every.Hour)]
public sealed class CleanupExpiredSessionsJob : IJob
{
 private readonly ISessionRepository _repo;
 public CleanupExpiredSessionsJob(ISessionRepository repo) => _repo = repo;

 public async ValueTask ExecuteAsync(JobContext ctx, CancellationToken ct)
 => await _repo.DeleteExpiredAsync(ct);
}

// 2. Register — generated AddCleanupExpiredSessionsJob() wires executor + recurring startup
services.AddScheduling()
 .WithInMemoryStore()
 .AddCleanupExpiredSessionsJob();

// 3. Enqueue a one-off job from application code
public class OrderService(IScheduler scheduler)
{
 public async Task CompleteOrderAsync(Order order, CancellationToken ct)
 {
 await ProcessAsync(order, ct);
 await scheduler.EnqueueAsync(new SendOrderConfirmationJob(order.Id), ct);
 }
}

Features

• Source generator — [Job] on a class emits a typed executor, DI extension method, and optional recurring startup (IHostedService)
• Recurring jobs — [Job(Cron = "0 * * * *")] or [Job(Every = Every.Hour)] — scheduled via Cronos at startup
• Retry with backoff — exponential retry up to MaxAttempts (per-job or global); dead-letters after exhaustion
• Multiple backends — InMemory (dev/test), EF Core (SQL Server / PostgreSQL / SQLite), Redis
• Dashboard — embedded HTML/JS dashboard via app.MapJobsDashboard("/jobs")
• Blazor component — <JobsDashboard> Razor component for integration into Blazor apps
• Mediator bridge — [Job] + IRequest<Unit> auto-registers MediatorJobTypeExecutor<T>, routing execution through ZeroAlloc.Mediator pipeline behaviors
• Native AOT compatible — no reflection at runtime; all dispatch resolved at compile time

Dashboard

An embedded HTML/JS dashboard — summary cards for each job state, a live-refreshing table with per-row requeue / delete actions, and fully responsive down to mobile widths.

app.MapJobsDashboard("/jobs");

// Optional: protect with auth
app.MapJobsDashboard("/jobs").RequireAuthorization("AdminPolicy");

Tablet (768 × 1024) and mobile (375 × 812) captures live in .

See for the full endpoint reference and the Blazor component.

Packages

Documentation

License

MIT