Documentation

language.blue docs

Learn how Blue works, how to build with it, and how to trust it. Start with the mental model, then descend as deep as you need.

Choose your path

I want intuition

What is Blue, why it matters, the mental model.

I want to build

MyOS + Blink, the JavaScript SDK, or raw Blue — pick a path.

I want trust + timelines

Timelines, providers, actors, and the trust model.

I want the exact spec

The Blue Language Specification.

Try the document stepper. Watch one Blue document process new entries live, with real BlueId chaining, real diff, real gas usage from the published processor. Open the stepper →

Start hereWhat is Blue?The core idea in plain language. What a document is, why it matters, what Blue is not.Mental modelBlocks, worlds, compositionEvery interaction is a block. Your world is the set of blocks you participate in.ConceptsDocuments, timelines, trustThe ideas behind the protocol: how documents, timelines, and participants work together.ConceptsBlueId essentialsWhy every Blue node has a content-derived id, and what it lets you do.BuildThree ways to buildMyOS + Blink, the JavaScript SDK, or raw Blue. Same model, different depths.RuntimeDeterministic processingWhy the same document and the same events always produce the same result.TutorialsLanguage and contracts tracksDeep guided learning paths. Read these after you have the mental model.PlaygroundDocument stepperWatch one document change state step by step as events arrive.ReferenceSpec, white papers, deep materialThe map of deeper reference materials and recommended reading orders.

Looking for the original deep tutorials? The legacy tutorial pages on language.blue are still the most precise treatment of operations, channel binding, sequential workflows, processing checkpoints, embedded documents, and composite timeline channels. The reference overview lists them in recommended reading order.

language.blue docs

Choose your path

Recommended reading paths