diff --git a/README.md b/README.md
index 09ac372..6b4aa3b 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # Octoscript
 
+<img src="docs/assets/octoscript-logo.svg" alt="OctoScript" width="96" height="96" />
+
 English | [简体中文](README.zh-CN.md)
 
 > **Building an OctoSense app?** You do not need this repository: it is the standalone OctoScript language runtime (VM, capabilities, workflows, LSP). An app's `main.splash` runs on the Makepad-based runtime that the app tools set up for you, and the language an app may use is documented in [SCRIPT-API](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/SCRIPT-API.md). Start from the [OctoSense organization profile](https://github.com/OctoSense-org)'s reading order: [OctoScript-App-Design-Flow `AGENTS.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/AGENTS.md) → [`flows/README.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/flows/README.md) → [`docs/QUICKSTART.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/QUICKSTART.md).
diff --git a/README.zh-CN.md b/README.zh-CN.md
index aaaee7d..7548ecd 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,7 @@
 # Octoscript
 
+<img src="docs/assets/octoscript-logo.svg" alt="OctoScript" width="96" height="96" />
+
 [English](README.md) | 简体中文
 
 > **要开发 OctoSense 应用？** 你不需要这个仓库：它是独立的 OctoScript 语言运行时（VM、能力、工作流、LSP）。应用的 `main.splash` 运行在应用工具为你准备好的 Makepad 运行时上，应用可用的语言与 API 见 [SCRIPT-API](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/SCRIPT-API.md)。请按 [OctoSense 组织主页](https://github.com/OctoSense-org)给出的顺序阅读：[OctoScript-App-Design-Flow `AGENTS.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/AGENTS.md) → [`flows/README.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/flows/README.md) → [`docs/QUICKSTART.md`](https://github.com/OctoSense-org/OctoScript-App-Design-Flow/blob/main/docs/QUICKSTART.md)。
diff --git a/docs/assets/octoscript-logo.png b/docs/assets/octoscript-logo.png
new file mode 100644
index 0000000..0510ee3
Binary files /dev/null and b/docs/assets/octoscript-logo.png differ
diff --git a/docs/assets/octoscript-logo.svg b/docs/assets/octoscript-logo.svg
new file mode 100644
index 0000000..886d435
--- /dev/null
+++ b/docs/assets/octoscript-logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="OctoScript"><rect width="64" height="64" rx="18" fill="#0b1017"/><g fill="#67e8f9" transform="translate(32 32)"><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(0)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(45)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(90)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(135)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(180)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(225)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(270)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(315)"/><path fill-rule="evenodd" d="M 12.5 0 A 12.5 12.5 0 1 0 -12.5 0 A 12.5 12.5 0 1 0 12.5 0 Z M -4 -5.3 H -7 V 5.3 H -4 V 3.5 H -5.2 V -3.5 H -4 Z M 4 -5.3 H 7 V 5.3 H 4 V 3.5 H 5.2 V -3.5 H 4 Z M 1 -4.2 H 2.8 L -1 4.2 H -2.8 Z"/></g></svg>
diff --git a/docs/assets/octoscript-mark.svg b/docs/assets/octoscript-mark.svg
new file mode 100644
index 0000000..2c10af5
--- /dev/null
+++ b/docs/assets/octoscript-mark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="OctoScript"><g fill="currentColor" transform="translate(32 32)"><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(0)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(45)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(90)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(135)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(180)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(225)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(270)"/><path d="M 0 -9 C -3.1 -9 -5 -10.4 -5 -14.8 C -5 -20.3 -2.5 -25 0.8 -25 C 3.6 -25 5.4 -22.9 4.9 -20.7 C 4.7 -20 4.2 -19.6 3.9 -19.7 C 3.6 -19.8 3.5 -20.1 3.2 -20 C 2.9 -19.9 2.9 -19.5 3 -19 C 3.4 -16.3 4.5 -13.3 4.3 -11.7 C 4.1 -9.8 2.1 -9 0 -9 Z" transform="rotate(315)"/><path fill-rule="evenodd" d="M 12.5 0 A 12.5 12.5 0 1 0 -12.5 0 A 12.5 12.5 0 1 0 12.5 0 Z M -4 -5.3 H -7 V 5.3 H -4 V 3.5 H -5.2 V -3.5 H -4 Z M 4 -5.3 H 7 V 5.3 H 4 V 3.5 H 5.2 V -3.5 H 4 Z M 1 -4.2 H 2.8 L -1 4.2 H -2.8 Z"/></g></svg>