OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

Start here

A fast onboarding path from install to your first generated contract.

Install the CLI

bun add contractspec -D

Add core libraries

bun add @contractspec/lib.contracts-spec @contractspec/lib.schema

Initialize your project

start-here-init

bunx contractspec init

Create your first contract

start-here-create

contractspec create --type operation

Generate implementation

start-here-build

contractspec build src/contracts/mySpec.ts
contractspec validate src/contracts/mySpec.ts

Next: Hello World Troubleshooting Compatibility

OSS docsstartStart with OSS. Adopt Studio when you want the operating layer.

Installation

Install the CLI and core packages, then prepare a workspace for incremental adoption.

Why ContractSpec

Keep educational and comparison content reachable without letting it define the primary OSS learning path.

Manifesto Contract-first API Spec-driven development

Open system docs