Part of Trax: business logic you can call, schedule, or serve as an API, with every run recorded in your Postgres. Docs · Getting started · All repos
Trax.Scheduler adds cron schedules, retries, dead letters and remote or Lambda workers for Trax trains. It builds on Trax.Mediator, and Trax.Api and Trax.Dashboard read and manage what it schedules.
dotnet add package Trax.Scheduler
dotnet add package Trax.Effect.Data.Postgres # or Trax.Effect.Data.Sqlite for a single processAdapted from the game server sample:
builder.Services.AddTrax(trax => trax
.AddEffects(effects => effects.UsePostgres(connectionString))
.AddMediator(typeof(RecalculateLeaderboardTrain).Assembly)
.AddScheduler(scheduler => scheduler
.Schedule<IRecalculateLeaderboardTrain>(
"leaderboard-na",
new RecalculateLeaderboardInput { Region = "na" },
Every.Minutes(5),
options => options.MaxRetries(3))));Every five minutes the scheduler queues a run with that input and a worker claims it. A failed run retries with backoff, then lands in the dead-letter queue.
Trax is split into layers, one repo each. Take the ones you need; the trains you wrote do not change. You are here: Trax.Scheduler.
| Repo | What it adds |
|---|---|
| Trax.Core | Trains, junctions and the chain, with no database and no DI container |
| Trax.Effect | A recorded run for every execution (Postgres, SQLite or in memory), DI, effect providers, the state-machine engine |
| Trax.Mediator | The train bus: run a train by handing over its input, with every chain checked at startup |
| Trax.Scheduler | Cron and interval schedules, retries, dead letters, and workers on other machines or in Lambda |
| Trax.Api | GraphQL generated from your trains, with authentication, audit and typed clients |
| Trax.Dashboard | A Blazor Server UI for runs, schedules and dead letters, mounted in your app |
| Trax.Cli | The trax tool: scaffold a hub and trains from an OpenAPI or GraphQL schema, and state-machine codegen |
| Trax.Samples | Complete sample apps, and the trax-api, trax-scheduler and trax-hub templates |
Docs live in Trax.Docs and are published at traxsharp.net/docs.
Read AGENTS.md before changing code. Report vulnerabilities privately as described in SECURITY.md.
MIT. There is no commercial edition, and there will not be one.
Trax is an independent open-source project and is not affiliated with the Utah Transit Authority, Trax Retail, or any other organization using the Trax name.