diff --git a/Design:-Runtime-Events.md b/Design:-Runtime-Events.md
new file mode 100644
index 0000000..052e569
--- /dev/null
+++ b/Design:-Runtime-Events.md
@@ -0,0 +1,11 @@
+
+All events are emitted by `runtime.events`.
+
+| Event                    | Args                    | Description |
+|--------------------------|-------------------------|-------------|
+| `node-status`            | `{id: node.id, status:statusMessage }`| A node status event to display in the editor |
+| `runtime-event`          | `{id:"runtime-unsupported-version",type:"error",text:"message.id"}`                    | A runtime event that should be displayed in the editor as a notification
+| `node-examples-dir`      | `{name:pkg.name,path:examplesDir}`| A directory of example flows has been discovered
+| `node-module-uninstalled`| `module` | A module has been removed from the runtime |
+| `node-icon-dir`          | `path` | A directory of node icons has been discovered |
+| `type-registered`        | `type` | A new node type has been registered |