diff --git a/docs/README.md b/docs/README.md
index 1d69c4961..b2e93afc2 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -185,6 +185,12 @@ See the full documentation at [`../README.md`](../README.md) or browse sub-pages
 
 [Design](https://lightspeed-core.github.io/lightspeed-stack/design/observability-opentelemetry/observability-opentelemetry.html)
 
+*** Widget System in Lightspeed Stack ***
+
+[Spike](https://lightspeed-core.github.io/lightspeed-stack/design/widget-system/widget-system-spike.html)
+
+[Design](https://lightspeed-core.github.io/lightspeed-stack/design/widget-system/widget-system.html)
+
 ## Demos
 
 [LCORE introduction](https://lightspeed-core.github.io/lightspeed-stack/demos/lcore/lcore.html#/)
diff --git a/docs/index.md b/docs/index.md
index b8b68e01d..edb29f3db 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -86,6 +86,8 @@ product questions using backend LLM services, agents, and RAG databases.
 
 ### Models
 
+#### Descriptions
+
 [Common](https://lightspeed-core.github.io/lightspeed-stack/models/common.html)
 
 [Database](https://lightspeed-core.github.io/lightspeed-stack/models/database.html)
@@ -174,7 +176,7 @@ product questions using backend LLM services, agents, and RAG databases.
 
 [Design](https://lightspeed-core.github.io/lightspeed-stack/design/human-in-the-loop/human-in-the-loop.html)
 
-*** ogx config merge (unified `lightspeed-stack.yaml`) ***
+*** OGX config merge (unified `lightspeed-stack.yaml`) ***
 
 [Spike](https://lightspeed-core.github.io/lightspeed-stack/design/ogx-config-merge/ogx-config-merge-spike.html)
 
@@ -190,6 +192,12 @@ product questions using backend LLM services, agents, and RAG databases.
 
 [Design](https://lightspeed-core.github.io/lightspeed-stack/design/observability-opentelemetry/observability-opentelemetry.html)
 
+*** Widget System in Lightspeed Stack ***
+
+[Spike](https://lightspeed-core.github.io/lightspeed-stack/design/widget-system/widget-system-spike.html)
+
+[Design](https://lightspeed-core.github.io/lightspeed-stack/design/widget-system/widget-system.html)
+
 ## Demos
 
 [LCORE introduction](https://lightspeed-core.github.io/lightspeed-stack/demos/lcore/lcore.html#/)