Runtime Versions¶
Single source of truth for the platform's pinned versions. Each row links to where the version is actually pinned in code or chart.
| Component | Version | Pinned in |
|---|---|---|
| .NET runtime (Sense API, Sense Worker, Gen API, Gen Worker) | .NET 10 | axion.sense.backend/global.json, axion.gen.backend/global.json |
| C# language | 13 | Directory.Build.props (LangVersion) |
| Node.js (web build + dev) | 22 | axion.sense.web/.nvmrc, axion.gen.web/package.json engines |
| Next.js (Gen Web) | 15.1 | axion.gen.web/frontend/package.json |
| React | 19 | axion.sense.web/package.json, axion.gen.web/frontend/package.json |
| TypeScript | 5.7 (Sense Web), 5 (Gen Web) | package.json |
| Vite | 6 (Sense Web) | package.json |
| TanStack Router | v1.92 | axion.sense.web/package.json |
| TanStack Query | (via Orval) | package.json |
| MapLibre GL JS | 5.18 | axion.sense.web/package.json |
| 2GIS MapGL | latest | axion.gen.web/frontend/package.json |
| DuckDB.NET (Gen API in-process federation engine) | latest stable | axion.gen.backend/Directory.Packages.props |
| Apache Arrow / ADBC drivers (Gen API) | latest stable | axion.gen.backend/Directory.Packages.props |
| PostgreSQL | 17 | axion.infra (or provider) |
| PostGIS | matching PG 17 | bundled with Postgres image |
pg_partman |
latest stable for PG 17 | bundled with Postgres image |
| ClickHouse | 26.3 | axion.infra/services/clickhouse/values.yaml |
| Altinity ClickHouse Operator | 0.3.11 | axion.infra/services/clickhouse/Chart.yaml |
| OpenFGA | 1.14.2 | axion.infra/services/openfga/Chart.yaml |
| OpenFGA Helm chart | 0.3.2 | axion.infra/services/openfga/Chart.yaml |
| Kafka | KRaft mode (provider-managed; pin via provider) | (external) |
| KafkaFlow (.NET client) | 3.1 | axion.sense.backend/Directory.Packages.props |
| Hangfire | 1.8 (and Hangfire.PostgreSql 1.21) | axion.sense.backend/Directory.Packages.props, axion.gen.backend/Directory.Packages.props |
| Valhalla | latest stable | axion.infra/services/valhalla |
| SigNoz | 0.119.0 | axion.infra/services/signoz/Chart.yaml |
| OpenTelemetry .NET | matching latest stable | Directory.Packages.props |
| EF Core | 9 | Directory.Packages.props |
| Npgsql / Npgsql.EntityFrameworkCore.PostgreSQL | matching EF 9 | Directory.Packages.props |
@ai-sdk/openai |
latest stable | axion.gen.web/frontend/package.json |
tippecanoe |
latest stable | baked into the Sense Worker and Gen Worker container images (Dockerfile) |
| Buf (proto codegen) | v2 | axion.sense.contracts/buf.yaml |
Update policy¶
- Major version bumps (e.g., .NET 10 → 11) require an MR with a changelog walkthrough and a CI run on a feature branch before merge.
- Patch / minor within a major are picked up via Renovate / Dependabot weekly.
- Helm chart bumps require a staging deploy before prod.
- Kafka and Postgres majors are coordinated with the infra/operations team — they're externally managed.
Compatibility notes¶
- ClickHouse 26.3 is needed for the
UUIDv7ToDateTimefunction used in partitioning. - pg_partman version must match the Postgres major.
- KafkaFlow 3.1 + .NET 10 is the tested combination.
- OpenFGA 1.14.2 is the first version with the
BatchCheckAPI at scale we depend on.