Cratis.Stage.Contracts 1.0.1

Prefix Reserved

dotnet add package Cratis.Stage.Contracts --version 1.0.1

NuGet\Install-Package Cratis.Stage.Contracts -Version 1.0.1

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Cratis.Stage.Contracts" Version="1.0.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Cratis.Stage.Contracts" Version="1.0.1" />
                    

                            Directory.Packages.props

<PackageReference Include="Cratis.Stage.Contracts" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Cratis.Stage.Contracts --version 1.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Cratis.Stage.Contracts, 1.0.1"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Cratis.Stage.Contracts@1.0.1

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Cratis.Stage.Contracts&version=1.0.1
                    

                            Install as a Cake Addin

#tool nuget:?package=Cratis.Stage.Contracts&version=1.0.1
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Cratis Stage

Stage takes an authored event model — the intermediate JSON format produced by Cratis Studio or any other tool — and materializes it into a live, running Cratis application at runtime: dynamically generated commands and queries (Arc), read models and projections (Chronicle), and a Scalar/OpenAPI surface. No code generation, no compilation — the model is the application.

Stage is self contained: it has no dependency on Studio. It is consumed as containers (the host and the specification runner) and as a NuGet package (the contracts) from Studio, the Cratis CLI, or your own tooling.

Projects

Project	Package / Image	Purpose
`Source/Contracts`	`Cratis.Stage.Contracts` (NuGet)	The event model intermediate format (with its embedded JSON schema), specification run results, and the serialization for both (`EventModelFile`, `SpecificationRunResultsFile`, `StageJson`).
`Source/Stage`	`Cratis.Stage` (NuGet)	The engine — synthesizes commands, queries, validators, read models, and projections from a deserialized `EventModel` at runtime.
`Source/Host`	`cratis/stage` (Docker)	Self-contained play sandbox: MongoDB + Chronicle kernel + the Stage engine in one container. Mount a model at `/eventmodel`, get a live API on port `9090`.
`Source/SpecRunner`	`cratis/stage-specrunner` (Docker)	Run-to-completion job that loads an event model from the mounted `/model` folder, runs its specifications and writes `results.json` to the mounted `/output` folder.

Consuming

Everything Stage needs as input is a serialized EventModel — the types and the exact serialization live in Cratis.Stage.Contracts, so consumers write the file with EventModelFile.Write(model) and never hand-roll JSON.

Studio / CLI ──(event-model.json)──▶ cratis/stage            ⇒ live HTTP API (port 9090)
Studio / CLI ──(event-model.json)──▶ cratis/stage-specrunner ⇒ results.json

The host takes the model file path as its first argument (the container entrypoint finds it in /eventmodel). Deployment configuration can be supplied through a dedicated cratis-stage.json file (path overridable with the STAGE_CONFIG environment variable) instead of appsettings.json.
The spec runner takes --model <file> and --output <file>, with optional --slice <guid> / --spec <guid> filters; the container defaults to /model/event-model.json and /output/results.json.

Building

dotnet build                # Debug
dotnet test                 # run specs
dotnet build -c Release     # Release — treat warnings as errors

Container images are built from the repository root:

docker build -f Source/Host/Dockerfile -t cratis/stage .
docker build -f Source/SpecRunner/Dockerfile -t cratis/stage-specrunner .

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Cratis.Stage.Contracts:

Package	Downloads
Cratis.Stage The Cratis Stage engine — materializes an authored event model into a live Cratis application at runtime.	48

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.1	51	7/15/2026