# webassembly/design architecture

> Architecture diagram of the GitHub repository webassembly/design, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webassembly/design
- Repository: https://github.com/webassembly/design

## Overview

This repository is a collection of non-normative WebAssembly design documents, not an executable product. An engineer’s main workflow is to use the README as an index and consult relevant design material; the README also identifies the issue tracker and discussion forum as community resources. Only the README was provided as evidence, so links are shown only where it explicitly names documents or community resources; other documents are included from the file tree without inferred relationships.

Main entry points: [`README.md`](https://github.com/webassembly/design/blob/main/README.md) (Document index), [`HighLevelGoals.md`](https://github.com/webassembly/design/blob/main/HighLevelGoals.md) (High-level goals), [`Rationale.md`](https://github.com/webassembly/design/blob/main/Rationale.md) (Design rationale), [`Nondeterminism.md`](https://github.com/webassembly/design/blob/main/Nondeterminism.md) (Nondeterminism)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Goals and semantics"]
  node_goals["High-level goals<br/>[HighLevelGoals.md]"]
  node_rationale["Design rationale<br/>[Rationale.md]"]
  node_semantics["Semantics<br/>[Semantics.md]"]
  node_nondeterminism["Nondeterminism<br/>[Nondeterminism.md]"]
end

subgraph group_execution["Execution and modules"]
  node_modules["Modules<br/>[Modules.md]"]
  node_jit["JIT library<br/>[JITLibrary.md]"]
  node_binary["Binary encoding<br/>[BinaryEncoding.md]"]
  node_text["Text format<br/>[TextFormat.md]"]
  node_events["Events<br/>[Events.md]"]
end

subgraph group_interfaces["Interfaces and platforms"]
  node_js["JavaScript API<br/>[JS.md]"]
  node_web["Web integration<br/>[Web.md]"]
  node_nonweb["Non-web use<br/>[NonWeb.md]"]
  node_c_cpp["C and C++<br/>[CAndC++.md]"]
  node_dynamic["Dynamic linking<br/>[DynamicLinking.md]"]
  node_portability["Portability<br/>[Portability.md]"]
end

subgraph group_constraints["Security and evolution"]
  node_security["Security model<br/>[Security.md]"]
  node_featuretest["Feature testing<br/>[FeatureTest.md]"]
  node_future["Future features<br/>[FutureFeatures.md]"]
  node_tooling["Tooling<br/>[Tooling.md]"]
  node_usecases["Use cases<br/>[UseCases.md]"]
  node_mvp["Minimum viable product<br/>[MVP.md]"]
end

node_engineer(("Engineer"))
node_readme["Document index<br/>[README.md]"]
node_issue_tracker["Issue tracker"]
node_discussion["Discussion forum"]

node_engineer -->|"consults"| node_readme
node_readme -->|"links to"| node_goals
node_readme -->|"links to"| node_portability
node_readme -->|"links to"| node_rationale
node_readme -->|"links to"| node_security
node_readme -->|"links to"| node_nondeterminism
node_readme -->|"hosts"| node_issue_tracker
node_readme -->|"hosts"| node_discussion

click node_readme "https://github.com/webassembly/design/blob/main/README.md"
click node_goals "https://github.com/webassembly/design/blob/main/HighLevelGoals.md"
click node_rationale "https://github.com/webassembly/design/blob/main/Rationale.md"
click node_semantics "https://github.com/webassembly/design/blob/main/Semantics.md"
click node_nondeterminism "https://github.com/webassembly/design/blob/main/Nondeterminism.md"
click node_modules "https://github.com/webassembly/design/blob/main/Modules.md"
click node_jit "https://github.com/webassembly/design/blob/main/JITLibrary.md"
click node_binary "https://github.com/webassembly/design/blob/main/BinaryEncoding.md"
click node_text "https://github.com/webassembly/design/blob/main/TextFormat.md"
click node_events "https://github.com/webassembly/design/blob/main/Events.md"
click node_js "https://github.com/webassembly/design/blob/main/JS.md"
click node_web "https://github.com/webassembly/design/blob/main/Web.md"
click node_nonweb "https://github.com/webassembly/design/blob/main/NonWeb.md"
click node_c_cpp "https://github.com/webassembly/design/blob/main/CAndC%2B%2B.md"
click node_dynamic "https://github.com/webassembly/design/blob/main/DynamicLinking.md"
click node_portability "https://github.com/webassembly/design/blob/main/Portability.md"
click node_security "https://github.com/webassembly/design/blob/main/Security.md"
click node_featuretest "https://github.com/webassembly/design/blob/main/FeatureTest.md"
click node_future "https://github.com/webassembly/design/blob/main/FutureFeatures.md"
click node_tooling "https://github.com/webassembly/design/blob/main/Tooling.md"
click node_usecases "https://github.com/webassembly/design/blob/main/UseCases.md"
click node_mvp "https://github.com/webassembly/design/blob/main/MVP.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_goals,node_rationale,node_semantics,node_nondeterminism toneBlue
class node_modules,node_jit,node_binary,node_text,node_events toneAmber
class node_js,node_web,node_nonweb,node_c_cpp,node_dynamic,node_portability toneMint
class node_security,node_featuretest,node_future,node_tooling,node_usecases,node_mvp toneRose
class node_engineer,node_issue_tracker,node_discussion toneIndigo
class node_readme toneTeal
```

## Components

### Goals and semantics

- [High-level goals](https://github.com/webassembly/design/blob/main/HighLevelGoals.md): `HighLevelGoals.md`
- [Design rationale](https://github.com/webassembly/design/blob/main/Rationale.md): `Rationale.md`
- [Semantics](https://github.com/webassembly/design/blob/main/Semantics.md): `Semantics.md`
- [Nondeterminism](https://github.com/webassembly/design/blob/main/Nondeterminism.md): `Nondeterminism.md`

### Execution and modules

- [Modules](https://github.com/webassembly/design/blob/main/Modules.md): `Modules.md`
- [JIT library](https://github.com/webassembly/design/blob/main/JITLibrary.md): `JITLibrary.md`
- [Binary encoding](https://github.com/webassembly/design/blob/main/BinaryEncoding.md): `BinaryEncoding.md`
- [Text format](https://github.com/webassembly/design/blob/main/TextFormat.md): `TextFormat.md`
- [Events](https://github.com/webassembly/design/blob/main/Events.md): `Events.md`

### Interfaces and platforms

- [JavaScript API](https://github.com/webassembly/design/blob/main/JS.md): `JS.md`
- [Web integration](https://github.com/webassembly/design/blob/main/Web.md): `Web.md`
- [Non-web use](https://github.com/webassembly/design/blob/main/NonWeb.md): `NonWeb.md`
- [C and C++](https://github.com/webassembly/design/blob/main/CAndC%2B%2B.md): `CAndC++.md`
- [Dynamic linking](https://github.com/webassembly/design/blob/main/DynamicLinking.md): `DynamicLinking.md`
- [Portability](https://github.com/webassembly/design/blob/main/Portability.md): `Portability.md`

### Security and evolution

- [Security model](https://github.com/webassembly/design/blob/main/Security.md): `Security.md`
- [Feature testing](https://github.com/webassembly/design/blob/main/FeatureTest.md): `FeatureTest.md`
- [Future features](https://github.com/webassembly/design/blob/main/FutureFeatures.md): `FutureFeatures.md`
- [Tooling](https://github.com/webassembly/design/blob/main/Tooling.md): `Tooling.md`
- [Use cases](https://github.com/webassembly/design/blob/main/UseCases.md): `UseCases.md`
- [Minimum viable product](https://github.com/webassembly/design/blob/main/MVP.md): `MVP.md`

### Other components

- **Engineer**
- [Document index](https://github.com/webassembly/design/blob/main/README.md): `README.md`
- **Issue tracker**
- **Discussion forum**

## Connections

- Engineer → Document index: consults (evidence: `README.md`)
- Document index → High-level goals: links to (evidence: `README.md`)
- Document index → Portability: links to (evidence: `README.md`)
- Document index → Design rationale: links to (evidence: `README.md`)
- Document index → Security model: links to (evidence: `README.md`)
- Document index → Nondeterminism: links to (evidence: `README.md`)
- Document index → Issue tracker: hosts (evidence: `README.md`)
- Document index → Discussion forum: hosts (evidence: `README.md`)
