From 7d2e14b35e7f220c2c765d1089a7be2491e45155 Mon Sep 17 00:00:00 2001
From: Sergei Predvoditelev <sergei@predvoditelev.ru>
Date: Sat, 28 Feb 2026 21:54:47 +0300
Subject: [PATCH] Add "Demo Applications" section

---
 src/.vitepress/config.js     | 18 ++++++++++++------
 src/guide/start/demo-apps.md | 16 ++++++++++++++++
 2 files changed, 28 insertions(+), 6 deletions(-)
 create mode 100644 src/guide/start/demo-apps.md

diff --git a/src/.vitepress/config.js b/src/.vitepress/config.js
index d100302e..ffb1f989 100644
--- a/src/.vitepress/config.js
+++ b/src/.vitepress/config.js
@@ -63,7 +63,8 @@ export default {
                                 {text: 'Working with Databases', link: '/guide/start/databases'},
                                 {text: 'Generating Code with Gii', link: '/guide/start/gii'},
                                 {text: 'Looking Ahead', link: '/guide/start/looking-ahead'},
-                                {text: 'Application Workflow', link: '/guide/start/workflow'}
+                                {text: 'Application Workflow', link: '/guide/start/workflow'},
+                                {text: 'Demo Applications', link: '/guide/start/demo-apps'}
                             ]
                         },
                         {
@@ -256,7 +257,8 @@ export default {
                                 {text: 'Trabajando con bases de datos', link: '/es/guide/start/databases'},
                                 {text: 'Generando código con Gii', link: '/es/guide/start/gii'},
                                 {text: 'Mirando hacia adelante', link: '/es/guide/start/looking-ahead'},
-                                {text: 'Flujo de trabajo de la aplicación', link: '/es/guide/start/workflow'}
+                                {text: 'Flujo de trabajo de la aplicación', link: '/es/guide/start/workflow'},
+                                {text: 'Aplicaciones de demostración', link: '/es/guide/start/demo-apps'}
                             ]
                         },
                         {
@@ -449,7 +451,8 @@ export default {
                                 {text: 'Bekerja dengan Database', link: '/id/guide/start/databases'},
                                 {text: 'Menghasilkan Kode dengan Gii', link: '/id/guide/start/gii'},
                                 {text: 'Melihat ke Depan', link: '/id/guide/start/looking-ahead'},
-                                {text: 'Alur Kerja Aplikasi', link: '/id/guide/start/workflow'}
+                                {text: 'Alur Kerja Aplikasi', link: '/id/guide/start/workflow'},
+                                {text: 'Aplikasi Demo', link: '/id/guide/start/demo-apps'}
                             ]
                         },
                         {
@@ -642,7 +645,8 @@ export default {
                                 {text: 'Lavorare con i database', link: '/it/guide/start/databases'},
                                 {text: 'Generazione di codice con Gii', link: '/it/guide/start/gii'},
                                 {text: 'Prossimi passi', link: '/it/guide/start/looking-ahead'},
-                                {text: 'Flusso applicativo', link: '/it/guide/start/workflow'}
+                                {text: 'Flusso applicativo', link: '/it/guide/start/workflow'},
+                                {text: 'Applicazioni demo', link: '/it/guide/start/demo-apps'}
                             ]
                         },
                         {
@@ -858,7 +862,8 @@ export default {
                                 {text: 'Работа с базами данных', link: '/ru/guide/start/databases'},
                                 {text: 'Генерация кода с Gii', link: '/ru/guide/start/gii'},
                                 {text: 'Что дальше', link: '/ru/guide/start/looking-ahead'},
-                                {text: 'Рабочий процесс приложения', link: '/ru/guide/start/workflow'}
+                                {text: 'Рабочий процесс приложения', link: '/ru/guide/start/workflow'},
+                                {text: 'Демо-приложения', link: '/ru/guide/start/demo-apps'}
                             ]
                         },
                         {
@@ -1057,7 +1062,8 @@ export default {
                                 {text: '使用数据库', link: '/zh-CN/guide/start/databases'},
                                 {text: '使用 Gii 生成代码', link: '/zh-CN/guide/start/gii'},
                                 {text: '展望未来', link: '/zh-CN/guide/start/looking-ahead'},
-                                {text: '应用程序工作流', link: '/zh-CN/guide/start/workflow'}
+                                {text: '应用程序工作流', link: '/zh-CN/guide/start/workflow'},
+                                {text: '演示应用', link: '/zh-CN/guide/start/demo-apps'}
                             ]
                         },
                         {
diff --git a/src/guide/start/demo-apps.md b/src/guide/start/demo-apps.md
new file mode 100644
index 00000000..53749cc4
--- /dev/null
+++ b/src/guide/start/demo-apps.md
@@ -0,0 +1,16 @@
+# Demo Applications
+
+There are several demo applications that showcase different architectural approaches and framework capabilities.
+
+**[Demo Blog](https://github.com/yiisoft/demo-blog) — Layered DDD architecture**
+
+A blog application demonstrating a layered architecture following Domain-Driven Design (DDD) principles.
+This demo is a good starting point if you want to learn how to structure a Yii3 application
+with a clear separation of concerns between domain, application, and infrastructure layers.
+
+**[Demo Diary](https://github.com/yiisoft/demo-diary) — Vertical slices architecture**
+
+A diary application built using the vertical slices architecture pattern.
+In this approach, each feature is implemented end-to-end rather than being split across horizontal layers,
+making it easier to add or modify features independently.
+