From 9f378691f14730506efc7705fd225e2f7a3cdb0c Mon Sep 17 00:00:00 2001
From: Cell <1024@lruihao.cn>
Date: Fri, 14 Aug 2026 12:45:34 +0800
Subject: [PATCH] docs: add README for apps directory with development
 instructions

---
 apps/README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 apps/README.md

diff --git a/apps/README.md b/apps/README.md
new file mode 100644
index 00000000..cf33c0f8
--- /dev/null
+++ b/apps/README.md
@@ -0,0 +1,25 @@
+# Apps
+
+This directory contains the Hugo sites used for development, testing, and demonstration of the [FixIt](https://fixit.lruihao.cn) theme.
+
+## Overview
+
+| App            | Description                                           | Live                                                              |
+| -------------- | ----------------------------------------------------- | ----------------------------------------------------------------- |
+| [demo](./demo) | Demo site showcasing FixIt theme features             | [demo.fixit.lruihao.cn](https://demo.fixit.lruihao.cn)            |
+| [test](./test) | Test site for exercising and verifying theme features | [demo.fixit.lruihao.cn/test](https://demo.fixit.lruihao.cn/test/) |
+
+> [!NOTE]
+> The documentation site (`fixit-docs`) lives in a separate repository: [hugo-fixit/fixit-docs](https://github.com/hugo-fixit/fixit-docs).
+
+## Development
+
+From the repository root:
+
+```bash
+pnpm dev:demo          # Start demo site dev server
+pnpm dev:test          # Start test site dev server
+pnpm build:demo        # Build demo site
+pnpm build:test        # Build test site
+pnpm build             # Build all sites (merged into public/)
+```