Architecture
The backbone of MeshWeaver: message-based communication, the actor model, partitioned persistence, access control, and UI streaming. Start here to understand how the platform works under the hood.

MeshWeaver is a distributed platform for building data-driven applications with AI capabilities. A handful of principles hold the whole system together:

Principle What it means
Data locality Process and render where the data lives — no unnecessary round-trips.
Message-driven Every operation is a typed message routed through the hub; no direct object calls across boundaries.
Type as data Node types live in the mesh, not only in compiled code — they can be authored, versioned, and released at runtime.
Agent-ready AI agents reach everything through the same unified APIs as users — no special back-channels.
Security-first Access control is validated at every read and write, not bolted on after the fact.

Platform overview

Core concepts

Message-based communication
Message hubs manage concurrency through the actor model and route messages across the mesh.
Read more →
User interface
UI is generated where data lives, serialized to JSON, and streamed to the browser with two-way binding.
Read more →
Agentic AI
AI agents are first-class citizens that query the mesh for context and collaborate through messages.
Read more →
Mesh graph
Hierarchical namespaces where data types attach at any level, with built-in semantic versioning.
Read more →
Access control
Hierarchical, dimensional, and operation-specific permissions enforced on every read and write.
Read more →
Deployment
Run as a single-process monolith or an Orleans-based distributed mesh orchestrated by .NET Aspire.
Read more →

Topic map

Each theme starts with its introductory page, followed by related architecture topics.

Reactive core

Reading & writing nodes

Storage & partitions

Security

Threads, activities & AI

UI

Node types

Plugins & content delivery

Reliability & wedges

Testing & debugging

Deployment & ops

Contributing docs

Licensing

Getting started

New to the platform? Read Specifying Software to learn how to write iterative specifications closely aligned with implementation, skim the Glossary for the vocabulary, then explore the full catalog of architecture topics above.

Reconnecting…
The server was updated. Reloading the page to pick up the latest version.