TypeScript SDK for Railway that lets developers create sandboxes, run commands inside them, and manage sandbox filesystem files. It is useful for infrastructure-as-code workflows where you need to programmatically provision environments and execute commands, with support for streaming command output and reading or writing files to the sandbox.
Project status
- The repo appears actively maintained, with an upstream push on 2026-10-01 and the most recent published updates on 2026-09-29 (v3.12.0).
- Update cadence is ongoing and fairly frequent, with updates in mid-August (v3.10.0 on 2026-08-13), late August (v3.11.0 on 2026-08-24), and late September (v3.12.0 on 2026-09-29).
AI summary generated
Recent updates
v3.12.0
v3.12.0 adds support for publishing Railway-provided public HTTP domains on sandboxes and exposes them via the SDK. It also introduces an IaC feature to configure per-service tracing options inside Railway service environments. In addition, the GraphQL schema/types were regenerated, causing substantial type-level changes.
Featuresv3.11.0
v3.11.0 focuses on making `railway/iac` a thin authoring layer and updating the IaC CLI integration. Release notes only mention two internal PRs, one about PATH handling for node resolution in e2e tests, and one about slimming `railway/iac` into authoring-only behavior.
v3.10.0
v3.10.0 speeds up the live sandbox E2E suite and changes sandbox exec behavior to run commands through a login shell. The code diff also shows additional SDK and schema surface area changes beyond what is described in the release notes.
v3.9.0
Release v3.9.0 implements reuse of `/ws/files` connections across sequential file operations by pooling idle WebSocket sessions. It also updates the auto-release workflow to pass the repository name when dispatching the release workflow.
Featuresv3.8.1
v3.8.1 includes changes related to npm publishing identity and an asynchronous IaC ChangeSet apply behavior. The SDK update adds client-side polling for ChangeSet applies that start in an "applying" state.
Featuresv3.7.0
v3.7.0 adds a fix for interrupted sandbox exec sessions by detecting when the underlying exec socket closes before an exit frame is received. In that case, the exec handle now rejects with a dedicated error type that includes partial stdout and stderr.
BreakingFeaturesv3.6.0
v3.6.0 adds support for selecting a Railway region when creating sandboxes, and documents how region affects sandbox creation, templates, checkpoints, and forks. The code changes also expand the GraphQL-generated schema (including new fields and updated feature flag unions) beyond what the release notes mention.
Featuresv3.5.10
v3.5.10 adds support for restoring volume group membership from the environment canvas state, specifically using GraphQL canvas group references. It also updates the IaC graph generation so volume nodes can carry groupId based on those canvas group refs.
Featuresv3.5.9
v3.5.9 adds validation around IaC service image auto updates. The code enforces that autoUpdates is only supported for Docker image sources (Docker Hub and GHCR related registries), and adjusts IaC graph diffing to avoid planning drift when autoUpdates is present on unsupported sources.
Breakingv3.5.8
v3.5.8 updates the IaC graph generation to filter out canvas groups that are not referenced by resources in the imported environment. Instead of including all non-deleted groups, it now includes only groups referenced by services and buckets, plus their parent group chain.
Breaking