From 74e95924c03ad0025e0c2816d1120a3f0c044768 Mon Sep 17 00:00:00 2001
From: Henning Wendtland <156231187+HenningWendtland@users.noreply.github.com>
Date: Tue, 29 Sep 2026 23:49:23 +0200
Subject: [PATCH 1/2] feat: add pages written in Desk (Compendium Page) (#28)

Co-authored-by: barredterra <14891507+barredterra@users.noreply.github.com>
---
 README.md                                     |   1 +
 compendium/compendium/doctype/__init__.py     |   0
 .../doctype/compendium_page/__init__.py       |   0
 .../compendium_page/compendium_page.js        |  34 ++++
 .../compendium_page/compendium_page.json      | 115 ++++++++++++
 .../compendium_page/compendium_page.py        |  41 ++++
 .../compendium_page/test_compendium_page.py   | 175 ++++++++++++++++++
 .../doctype/compendium_page_role/__init__.py  |   0
 .../compendium_page_role.json                 |  35 ++++
 .../compendium_page_role.py                   |   9 +
 compendium/compendium/page/docs/docs.css      |  84 +++++++--
 compendium/compendium/page/docs/docs.js       | 141 +++++++++++---
 compendium/docs.py                            | 169 +++++++++++++++--
 .../docs/de/compendium/docs/authoring.md      |  13 +-
 .../docs/de/compendium/docs/desk-pages.md     |  83 +++++++++
 compendium/docs/de/compendium/docs/index.md   |   1 +
 compendium/docs/de/compendium/docs/search.md  |   7 +-
 compendium/docs/de/compendium/index.md        |   3 +-
 .../docs/en/compendium/docs/authoring.md      |  12 +-
 .../docs/en/compendium/docs/desk-pages.md     |  74 ++++++++
 compendium/docs/en/compendium/docs/index.md   |   1 +
 compendium/docs/en/compendium/docs/search.md  |   5 +-
 compendium/docs/en/compendium/index.md        |   3 +-
 compendium/locale/de.po                       |  96 ++++++++--
 compendium/locale/main.pot                    |  98 ++++++++--
 compendium/search.py                          |   9 +-
 compendium/tests/test_docs.py                 |  28 ++-
 cypress/integration/docs.js                   |  28 ++-
 28 files changed, 1153 insertions(+), 112 deletions(-)
 create mode 100644 compendium/compendium/doctype/__init__.py
 create mode 100644 compendium/compendium/doctype/compendium_page/__init__.py
 create mode 100644 compendium/compendium/doctype/compendium_page/compendium_page.js
 create mode 100644 compendium/compendium/doctype/compendium_page/compendium_page.json
 create mode 100644 compendium/compendium/doctype/compendium_page/compendium_page.py
 create mode 100644 compendium/compendium/doctype/compendium_page/test_compendium_page.py
 create mode 100644 compendium/compendium/doctype/compendium_page_role/__init__.py
 create mode 100644 compendium/compendium/doctype/compendium_page_role/compendium_page_role.json
 create mode 100644 compendium/compendium/doctype/compendium_page_role/compendium_page_role.py
 create mode 100644 compendium/docs/de/compendium/docs/desk-pages.md
 create mode 100644 compendium/docs/en/compendium/docs/desk-pages.md

diff --git a/README.md b/README.md
index 7b2aca8..bcbc438 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,7 @@ See the [built-in docs](compendium/docs) for authoring conventions and a getting
 - Role-gated pages via frontmatter (`title`, `order`, `roles`)
 - Multi-language trees with locale picker and fallback (`de-CH` → `de` → `en`)
 - Later apps override the same logical path
+- Pages written in Desk (Compendium Page), on top of the app docs
 - Relative images served safely from each app's `docs/` tree
 - Mermaid diagrams in fenced code blocks
 - Syntax highlighting for fenced code blocks
diff --git a/compendium/compendium/doctype/__init__.py b/compendium/compendium/doctype/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/compendium/compendium/doctype/compendium_page/__init__.py b/compendium/compendium/doctype/compendium_page/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/compendium/compendium/doctype/compendium_page/compendium_page.js b/compendium/compendium/doctype/compendium_page/compendium_page.js
new file mode 100644
index 0000000..1ee99cc
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page/compendium_page.js
@@ -0,0 +1,34 @@
+// Copyright (c) 2026, ALYF GmbH and contributors
+// For license information, please see license.txt
+
+frappe.ui.form.on("Compendium Page", {
+	onload(frm) {
+		if (frm.is_new() && !frm.doc.language) {
+			frm.set_value("language", frappe.boot.lang);
+		}
+	},
+
+	refresh(frm) {
+		// the Markdown Editor attaches dropped images only to a saved page
+		frm.set_intro(frm.is_new() ? __("Save the page before adding images.") : "");
+
+		if (!frm.is_new() && frm.doc.published) {
+			frm.add_custom_button(__("View"), () => {
+				frappe.set_route(["docs", frm.doc.language, ...frm.doc.path.split("/")]);
+			});
+		}
+	},
+
+	title(frm) {
+		// the docs sidebar opens a new page with its group as "guides/"; add the slug to it
+		const group = frm.doc.path || "";
+		if (!group || group.endsWith("/")) {
+			// same slug as slugify() in compendium_page.py
+			const slug = (frm.doc.title || "")
+				.toLowerCase()
+				.replace(/[^\p{L}\p{N}]+/gu, "-")
+				.replace(/^-+|-+$/g, "");
+			frm.set_value("path", group + slug);
+		}
+	},
+});
diff --git a/compendium/compendium/doctype/compendium_page/compendium_page.json b/compendium/compendium/doctype/compendium_page/compendium_page.json
new file mode 100644
index 0000000..3371999
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page/compendium_page.json
@@ -0,0 +1,115 @@
+{
+ "actions": [],
+ "creation": "2026-09-21 13:07:20.055891",
+ "doctype": "DocType",
+ "engine": "InnoDB",
+ "field_order": [
+  "title",
+  "roles",
+  "order",
+  "column_break_dmvv",
+  "language",
+  "path",
+  "published",
+  "section_break_jnxq",
+  "content"
+ ],
+ "fields": [
+  {
+   "fieldname": "title",
+   "fieldtype": "Data",
+   "in_list_view": 1,
+   "label": "Title",
+   "reqd": 1
+  },
+  {
+   "fieldname": "content",
+   "fieldtype": "Markdown Editor",
+   "ignore_xss_filter": 1,
+   "label": "Content"
+  },
+  {
+   "description": "Who can read the page. Empty means Desk User. Ignored for a translation: it takes the roles of the page in the canonical language (English where one exists).",
+   "fieldname": "roles",
+   "fieldtype": "Table MultiSelect",
+   "label": "Roles",
+   "options": "Compendium Page Role"
+  },
+  {
+   "fieldname": "order",
+   "fieldtype": "Int",
+   "label": "Sort Order"
+  },
+  {
+   "description": "Filled from the title when empty. Use slashes to nest pages, e.g. guides/setup. A page at the path of an app page replaces it.",
+   "fieldname": "path",
+   "fieldtype": "Data",
+   "in_list_view": 1,
+   "label": "Path"
+  },
+  {
+   "default": "1",
+   "fieldname": "published",
+   "fieldtype": "Check",
+   "in_list_view": 1,
+   "in_standard_filter": 1,
+   "label": "Published"
+  },
+  {
+   "fieldname": "column_break_dmvv",
+   "fieldtype": "Column Break"
+  },
+  {
+   "fieldname": "language",
+   "fieldtype": "Link",
+   "in_list_view": 1,
+   "label": "Language",
+   "options": "Language",
+   "reqd": 1
+  },
+  {
+   "fieldname": "section_break_jnxq",
+   "fieldtype": "Section Break"
+  }
+ ],
+ "grid_page_length": 50,
+ "links": [],
+ "modified": "2026-09-21 14:17:24.768175",
+ "modified_by": "Administrator",
+ "module": "Compendium",
+ "name": "Compendium Page",
+ "owner": "Administrator",
+ "permissions": [
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "System Manager",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "Compendium Contributor",
+   "share": 1,
+   "write": 1
+  }
+ ],
+ "row_format": "Dynamic",
+ "rows_threshold_for_grid_search": 20,
+ "show_title_field_in_link": 1,
+ "sort_field": "modified",
+ "sort_order": "DESC",
+ "states": [],
+ "title_field": "title"
+}
\ No newline at end of file
diff --git a/compendium/compendium/doctype/compendium_page/compendium_page.py b/compendium/compendium/doctype/compendium_page/compendium_page.py
new file mode 100644
index 0000000..93e7b1d
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page/compendium_page.py
@@ -0,0 +1,41 @@
+# Copyright (c) 2026, ALYF GmbH and contributors
+# For license information, please see license.txt
+
+import re
+
+import frappe
+from frappe import _
+from frappe.model.document import Document
+
+from compendium.docs import normalize_path
+
+
+class CompendiumPage(Document):
+	def validate(self):
+		self.path = normalize_path(self.path or slugify(self.title))
+		if not self.path:
+			frappe.throw(_("Please set a path for this page"))
+
+		duplicate = frappe.db.exists(
+			self.doctype, {"language": self.language, "path": self.path, "name": ("!=", self.name)}
+		)
+		if duplicate:
+			frappe.throw(
+				_("{0} already documents the path {1} in this language").format(
+					frappe.get_desk_link(self.doctype, duplicate), frappe.bold(self.path)
+				),
+				frappe.DuplicateEntryError,
+			)
+
+
+def on_doctype_update():
+	# validate() gives the readable error; the index also catches concurrent saves
+	frappe.db.add_unique("Compendium Page", ["language", "path"])
+
+
+def slugify(title):
+	"""`Getting Started` → `getting-started`, like the Markdown file names apps ship.
+
+	Mirrored in compendium_page.js, which fills the path while the title is typed.
+	"""
+	return re.sub(r"[\W_]+", "-", (title or "").lower()).strip("-")
diff --git a/compendium/compendium/doctype/compendium_page/test_compendium_page.py b/compendium/compendium/doctype/compendium_page/test_compendium_page.py
new file mode 100644
index 0000000..be51194
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page/test_compendium_page.py
@@ -0,0 +1,175 @@
+# Copyright (c) 2026, ALYF GmbH and Contributors
+# See license.txt
+
+from unittest.mock import patch
+
+import frappe
+from frappe.tests.utils import FrappeTestCase
+
+from compendium.docs import discover_pages, get_asset, get_page, get_view, make_override
+from compendium.search import awesomebar_results
+from compendium.tests.test_docs import DocsTestEnvironment
+
+
+class TestCompendiumPage(FrappeTestCase):
+	def setUp(self):
+		frappe.set_user("Administrator")
+		frappe.local.lang = "en"
+		self.next_request()
+
+	def tearDown(self):
+		frappe.db.rollback()
+		frappe.set_user("Administrator")
+		frappe.local.lang = "en"
+
+	def next_request(self):
+		if hasattr(frappe.local, "request_cache"):
+			frappe.local.request_cache.clear()
+
+	def make_page(self, title, content="", **kwargs):
+		roles = kwargs.pop("roles", [])
+		doc = frappe.get_doc(
+			{
+				"doctype": "Compendium Page",
+				"title": title,
+				"language": "en",
+				"content": content,
+				"roles": [{"role": role} for role in roles],
+				**kwargs,
+			}
+		).insert()
+		self.next_request()
+		return doc
+
+	def test_path_is_slugged_from_title_and_normalized(self):
+		self.assertEqual(self.make_page("Getting Started — Übersicht!").path, "getting-started-übersicht")
+		self.assertEqual(self.make_page("Nested", path="/guides//nested/").path, "guides/nested")
+
+		with self.assertRaises(frappe.ValidationError):
+			self.make_page("Escape", path="../secrets")
+		with self.assertRaises(frappe.ValidationError):
+			self.make_page("!!!")
+
+	def test_override_copies_app_page(self):
+		files = {"en/guides/setup.md": "---\ntitle: Setup\norder: 3\nroles: System Manager\n---\nShipped"}
+		with DocsTestEnvironment(files):
+			doc = make_override("guides/setup", locale="en")
+
+		self.assertTrue(doc.is_new())
+		self.assertEqual(
+			(doc.title, doc.path, doc.language, doc.order, doc.content),
+			("Setup", "guides/setup", "en", 3, "Shipped"),
+		)
+		self.assertEqual([row.role for row in doc.roles], ["System Manager"])
+
+	def test_markdown_is_stored_verbatim_and_sanitized_on_render(self):
+		with DocsTestEnvironment({}, db_pages=True):
+			doc = self.make_page("Quote", "> [!NOTE]\n> Quoted\n\n<script>alert(1)</script>")
+			content = get_page("quote", locale="en")["content"]
+
+		self.assertTrue(doc.content.startswith("> [!NOTE]"))
+		self.assertIn("docs-alert-note", content)
+		self.assertNotIn("<script>", content)
+
+	def test_path_is_unique_per_language(self):
+		self.make_page("Wiki Unique")
+		self.make_page("Wiki Unique", language="de")
+		with self.assertRaises(frappe.DuplicateEntryError):
+			self.make_page("Wiki Unique")
+
+	def test_page_is_added_on_top_of_app_docs(self):
+		with DocsTestEnvironment({"en/shipped.md": "# Shipped"}, db_pages=True):
+			self.make_page("Site Wiki", "Our own notes")
+			pages = discover_pages("en")
+
+		self.assertIn("shipped", pages)
+		self.assertEqual(pages["site-wiki"].body, "Our own notes")
+		self.assertEqual(pages["site-wiki"].roles, ["Desk User"])
+
+	def test_page_overrides_app_page_at_same_path(self):
+		with DocsTestEnvironment({"en/shared.md": "---\ntitle: Shipped\n---\nWrong for us"}, db_pages=True):
+			self.make_page("Corrected", "Right for us", path="shared", roles=["System Manager"])
+			page = discover_pages("en")["shared"]
+
+		self.assertEqual(page.title, "Corrected")
+		self.assertEqual(page.roles, ["System Manager"])
+
+	def test_unpublished_page_neither_shows_nor_hides(self):
+		with DocsTestEnvironment({"en/shared.md": "---\ntitle: Shipped\n---\nBody"}, db_pages=True):
+			self.make_page("Draft Override", path="shared", published=0)
+			self.make_page("Draft Page", published=0)
+			pages = discover_pages("en")
+
+		self.assertEqual(pages["shared"].title, "Shipped")
+		self.assertNotIn("draft-page", pages)
+
+	def test_translation_takes_roles_of_canonical_page(self):
+		files = {"en/guides/setup.md": "---\ntitle: Setup\nroles: System Manager\n---\nEnglish"}
+		with DocsTestEnvironment(files, db_pages=True):
+			self.make_page("Einrichtung", "Deutsch", path="guides/setup", language="de", roles=["Desk User"])
+			page = discover_pages("de")["guides/setup"]
+
+		self.assertEqual(page.body, "Deutsch")
+		self.assertEqual(page.roles, ["System Manager"])
+
+	def test_edit_route_replaces_github_link(self):
+		with DocsTestEnvironment(
+			{}, repository="https://github.com/alyf-de/compendium", docs_branch="main", db_pages=True
+		):
+			doc = self.make_page("Editable")
+			payload = get_page("editable", locale="en")
+
+		self.assertIsNone(payload["edit_url"])
+		self.assertEqual(payload["edit_route"], f"/app/compendium-page/{doc.name}")
+
+	def test_serves_only_attached_private_files(self):
+		with DocsTestEnvironment({}, db_pages=True):
+			doc = self.make_page("With Image")
+			attached = self.make_private_file("attached.png", b"attached", doc.name)
+			elsewhere = self.make_private_file("elsewhere.png", b"elsewhere")
+			doc.content = f"![Image]({attached.file_url})\n\n[Other]({elsewhere.file_url})"
+			doc.save()
+			self.next_request()
+
+			content = get_view("with-image", locale="en")["page"]["content"]
+			self.assertNotIn('"/private/files/', content)
+			self.assertIn("compendium.docs.get_asset", content)
+
+			get_asset("with-image", attached.file_url, locale="en")
+			self.assertEqual(frappe.response["filecontent"], b"attached")
+
+			with self.assertRaises(frappe.DoesNotExistError):
+				get_asset("with-image", elsewhere.file_url, locale="en")
+
+	def test_private_files_require_page_access(self):
+		with DocsTestEnvironment({}, db_pages=True):
+			doc = self.make_page("Restricted Image", roles=["System Manager"])
+			attached = self.make_private_file("restricted.png", b"secret", doc.name)
+
+			frappe.set_user("test@example.com")
+			with patch("compendium.docs.get_user_roles", return_value=["Desk User"]):
+				with self.assertRaises(frappe.PermissionError):
+					get_asset("restricted-image", attached.file_url, locale="en")
+
+	def test_search_sees_saved_and_deleted_pages(self):
+		with DocsTestEnvironment({}, db_pages=True):
+			self.assertEqual(awesomebar_results("zymurgy"), [])
+
+			doc = self.make_page("Brewing", "All about zymurgy.")
+			self.assertEqual([item["label"] for item in awesomebar_results("zymurgy")], ["Brewing"])
+
+			doc.delete()
+			self.next_request()
+			self.assertEqual(awesomebar_results("zymurgy"), [])
+
+	def make_private_file(self, file_name, content, attached_to_name=None):
+		return frappe.get_doc(
+			{
+				"doctype": "File",
+				"file_name": file_name,
+				"content": content,
+				"is_private": 1,
+				"attached_to_doctype": "Compendium Page" if attached_to_name else None,
+				"attached_to_name": attached_to_name,
+			}
+		).insert()
diff --git a/compendium/compendium/doctype/compendium_page_role/__init__.py b/compendium/compendium/doctype/compendium_page_role/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/compendium/compendium/doctype/compendium_page_role/compendium_page_role.json b/compendium/compendium/doctype/compendium_page_role/compendium_page_role.json
new file mode 100644
index 0000000..1793204
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page_role/compendium_page_role.json
@@ -0,0 +1,35 @@
+{
+ "actions": [],
+ "allow_rename": 1,
+ "creation": "2026-09-21 13:10:50.500722",
+ "doctype": "DocType",
+ "editable_grid": 1,
+ "engine": "InnoDB",
+ "field_order": [
+  "role"
+ ],
+ "fields": [
+  {
+   "fieldname": "role",
+   "fieldtype": "Link",
+   "in_list_view": 1,
+   "label": "Role",
+   "options": "Role",
+   "reqd": 1
+  }
+ ],
+ "grid_page_length": 50,
+ "istable": 1,
+ "links": [],
+ "modified": "2026-09-21 14:06:07.227251",
+ "modified_by": "Administrator",
+ "module": "Compendium",
+ "name": "Compendium Page Role",
+ "owner": "Administrator",
+ "permissions": [],
+ "row_format": "Dynamic",
+ "rows_threshold_for_grid_search": 20,
+ "sort_field": "modified",
+ "sort_order": "DESC",
+ "states": []
+}
\ No newline at end of file
diff --git a/compendium/compendium/doctype/compendium_page_role/compendium_page_role.py b/compendium/compendium/doctype/compendium_page_role/compendium_page_role.py
new file mode 100644
index 0000000..4fffccb
--- /dev/null
+++ b/compendium/compendium/doctype/compendium_page_role/compendium_page_role.py
@@ -0,0 +1,9 @@
+# Copyright (c) 2026, ALYF GmbH and contributors
+# For license information, please see license.txt
+
+# import frappe
+from frappe.model.document import Document
+
+
+class CompendiumPageRole(Document):
+	pass
diff --git a/compendium/compendium/page/docs/docs.css b/compendium/compendium/page/docs/docs.css
index def6bd0..a92cc52 100644
--- a/compendium/compendium/page/docs/docs.css
+++ b/compendium/compendium/page/docs/docs.css
@@ -169,10 +169,6 @@
 	font-weight: 600;
 }
 
-.docs-tree-node.disabled {
-	color: var(--text-muted);
-}
-
 .docs-tree-children {
 	padding-left: var(--padding-md);
 }
@@ -181,6 +177,62 @@
 	display: none;
 }
 
+/* Contributors: a "+" on group rows, shown on hover or keyboard focus. */
+.docs-tree-add-child {
+	display: inline-flex;
+	flex: 0 0 auto;
+	align-items: center;
+	justify-content: center;
+	width: 1.25rem;
+	height: 1.25rem;
+	margin-right: var(--margin-xs);
+	padding: 0;
+	border: 1px solid var(--border-color);
+	border-radius: var(--border-radius);
+	background: var(--card-bg, var(--bg-color));
+	color: var(--text-muted);
+	--icon-stroke: currentColor;
+	cursor: pointer;
+	opacity: 0;
+	transition: opacity 0.15s ease;
+}
+
+.docs-tree-row:hover > .docs-tree-add-child,
+.docs-tree-add-child:focus-visible {
+	opacity: 1;
+}
+
+.docs-tree-add-child:hover {
+	border-color: var(--gray-400, var(--border-color));
+	color: var(--text-color);
+}
+
+/* Slim placeholder row at the end of the tree, for contributors. */
+.docs-tree-add {
+	display: flex;
+	align-items: center;
+	gap: var(--margin-xs);
+	padding: 2px var(--padding-sm) 2px 0;
+	border-radius: var(--border-radius);
+	color: var(--text-muted);
+	font-size: var(--text-sm);
+	text-decoration: none;
+	opacity: 0.6;
+}
+
+.docs-tree-add .docs-tree-toggle-spacer {
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+}
+
+.docs-tree-add:hover,
+.docs-tree-add:focus-visible {
+	color: var(--text-color);
+	text-decoration: none;
+	opacity: 1;
+}
+
 .docs-reading-pane {
 	box-sizing: border-box;
 	width: 100%;
@@ -223,7 +275,13 @@
 	text-underline-offset: 0.15em;
 }
 
-.docs-copy-button {
+.docs-page-footer-actions {
+	display: flex;
+	gap: var(--margin-xs);
+	margin-left: auto;
+}
+
+.docs-footer-button {
 	display: inline-flex;
 	align-items: center;
 	white-space: nowrap;
@@ -236,22 +294,22 @@
 	font-size: 0.75rem;
 }
 
-.docs-copy-button:hover,
-.docs-copy-button:focus-visible {
+.docs-footer-button:hover,
+.docs-footer-button:focus-visible {
 	background: var(--fg-hover-color, var(--gray-100));
 	color: var(--text-color);
 }
 
 /* Show only the icon until hover or keyboard focus, then slide the label open. */
-.docs-copy-button-label {
+.docs-footer-button-label {
 	max-width: 0;
 	overflow: hidden;
 	opacity: 0;
 	transition: max-width 0.2s ease, margin 0.2s ease, opacity 0.2s ease;
 }
 
-.docs-copy-button:hover .docs-copy-button-label,
-.docs-copy-button:focus-visible .docs-copy-button-label {
+.docs-footer-button:hover .docs-footer-button-label,
+.docs-footer-button:focus-visible .docs-footer-button-label {
 	max-width: 10rem;
 	margin-right: 0.25rem;
 	opacity: 1;
@@ -466,10 +524,6 @@
 	font-size: var(--text-sm);
 }
 
-.docs-page-footer .docs-edit-link {
-	color: var(--text-muted);
-}
-
 @media (min-width: 1200px) {
 	.docs-browser.has-toc {
 		display: grid;
@@ -508,4 +562,4 @@
 		flex-direction: row;
 		justify-content: space-between;
 	}
-}
\ No newline at end of file
+}
diff --git a/compendium/compendium/page/docs/docs.js b/compendium/compendium/page/docs/docs.js
index 9151a38..5db38e4 100644
--- a/compendium/compendium/page/docs/docs.js
+++ b/compendium/compendium/page/docs/docs.js
@@ -51,6 +51,8 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 		this.locales = [];
 		this._view_seq = 0;
 		this.layout_ready = Promise.resolve();
+		// adding and overriding pages both start a new Compendium Page
+		this.can_create = frappe.model.can_create("Compendium Page");
 		this.setup_layout();
 	}
 
@@ -96,13 +98,22 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 				return;
 			}
 			if ($node.attr("data-has-page") !== "1") {
-				this.toggle_group(path);
-				return;
+				// a group without an index page opens its generated overview
+				this.expanded_paths.add(path);
 			}
 			this.navigate_to(path);
 		});
 
-		// Desk treats href="#…" as v1 routes (/desk/%23…). Keep in-page anchors local.
+		this.$tree.on("click", ".docs-tree-add, .docs-tree-add-child", (event) => {
+			event.preventDefault();
+			const group = $(event.currentTarget).attr("data-group");
+			frappe.new_doc("Compendium Page", {
+				language: this.current_locale,
+				path: group ? `${group}/` : "",
+			});
+		});
+
+		// Desk treats href="#…" as v1 routes (/app/%23…). Keep in-page anchors local.
 		this.$content.on("click", 'a[href^="#"]', (event) => {
 			this.follow_in_page_anchor(event);
 		});
@@ -114,6 +125,10 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 			event.stopPropagation();
 			this.copy_as_markdown();
 		});
+		this.$reading.on("click", ".docs-edit-button", (event) => {
+			event.preventDefault();
+			this.edit_page(this.current_doc);
+		});
 	}
 
 	show() {
@@ -271,10 +286,14 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 
 	render_tree() {
 		this.$tree.empty();
-		if (!this.tree_data.length) {
-			return;
-		}
 		this.$tree.append(this.render_tree_nodes(this.tree_data));
+		if (this.can_create) {
+			this.$tree.append(
+				`<a class="docs-tree-add" href="#" data-group=""><span class="docs-tree-toggle-spacer" aria-hidden="true">+</span>${frappe.utils.escape_html(
+					__("Add new Page"),
+				)}</a>`,
+			);
+		}
 	}
 
 	render_tree_nodes(nodes) {
@@ -312,15 +331,22 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 				classes.push("active");
 				$row.addClass("active");
 			}
-			if (!node.has_page) {
-				classes.push("disabled");
-			}
 			$(
 				`<a class="${classes.join(" ")}" data-path="${escaped_path}" data-has-page="${
 					node.has_page ? "1" : "0"
 				}" href="#">${frappe.utils.escape_html(node.title)}</a>`,
 			).appendTo($row);
 
+			if (this.can_create) {
+				const add_label = frappe.utils.escape_html(__("Add page to {0}", [node.title]));
+				$(
+					`<button type="button" class="docs-tree-add-child" data-group="${escaped_path}" title="${add_label}" aria-label="${add_label}">${frappe.utils.icon(
+						"add",
+						"xs",
+					)}</button>`,
+				).appendTo($row);
+			}
+
 			if (has_children) {
 				$item.append(
 					$('<div class="docs-tree-children"></div>').append(
@@ -435,6 +461,7 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 		this.$reading.removeClass("docs-loading hide");
 		this.$state.addClass("hide");
 		this.page.set_title(doc.title || __("Documentation"));
+		this.current_doc = doc;
 		this.current_markdown = doc.markdown || "";
 		this.$reading.html(doc.content || "");
 		const toc_html = doc.toc_html || "";
@@ -579,17 +606,18 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 			);
 		}
 
-		if (doc.edit_url) {
-			const label = frappe.utils.escape_html(__("Edit on GitHub"));
-			parts.push(
-				`<a class="docs-edit-link" href="${frappe.utils.escape_html(
-					doc.edit_url,
-				)}" target="_blank" rel="noopener noreferrer">${label}</a>`,
-			);
-		}
+		const edit_label = frappe.utils.escape_html(__("Edit"));
+		// the server sets edit_route and edit_url only for users who may use them
+		const can_edit = doc.edit_route || doc.edit_url || this.can_create;
+		const edit_button = can_edit
+			? `<button type="button" class="docs-footer-button docs-edit-button" title="${edit_label}" aria-label="${edit_label}"><span class="docs-footer-button-label">${edit_label}</span>${frappe.utils.icon(
+					"edit",
+					"sm",
+			  )}</button>`
+			: "";
 
 		const copy_label = frappe.utils.escape_html(__("Copy as Markdown"));
-		const copy_button = `<button type="button" class="docs-copy-button" title="${copy_label}" aria-label="${copy_label}"><span class="docs-copy-button-label">${copy_label}</span>${frappe.utils.icon(
+		const copy_button = `<button type="button" class="docs-footer-button docs-copy-button" title="${copy_label}" aria-label="${copy_label}"><span class="docs-footer-button-label">${copy_label}</span>${frappe.utils.icon(
 			"es-line-copy",
 			"sm",
 		)}</button>`;
@@ -598,7 +626,75 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 			? `<div class="docs-page-footer-meta">${parts.join("<br>")}</div>`
 			: ``;
 
-		this.$reading.append(`<footer class="docs-page-footer">${meta}${copy_button}</footer>`);
+		this.$reading.append(
+			`<footer class="docs-page-footer">${meta}<div class="docs-page-footer-actions">${edit_button}${copy_button}</div></footer>`,
+		);
+	}
+
+	edit_page(doc) {
+		if (doc.is_overview) {
+			// writing the group's index page replaces the generated overview
+			frappe.new_doc("Compendium Page", {
+				language: this.current_locale,
+				path: doc.path,
+				title: doc.title,
+			});
+			return;
+		}
+
+		if (doc.edit_route) {
+			frappe.set_route(doc.edit_route);
+			return;
+		}
+
+		if (!this.can_create) {
+			window.open(doc.edit_url, "_blank", "noopener");
+			return;
+		}
+
+		// An app ships this page: override it on this site, or change it at the source.
+		const message = doc.edit_url
+			? __(
+					"This page comes with an installed app. You can override it on this site with a Compendium Page, or change its source on GitHub.",
+			  )
+			: __(
+					"This page comes with an installed app. You can override it on this site with a Compendium Page.",
+			  );
+		const dialog = new frappe.ui.Dialog({
+			title: __("Edit Page"),
+			fields: [
+				{
+					fieldtype: "HTML",
+					options: `<p class="text-muted">${frappe.utils.escape_html(message)}</p>`,
+				},
+			],
+			primary_action_label: __("Override with Compendium Page"),
+			primary_action: () => {
+				dialog.hide();
+				this.override_page(doc);
+			},
+		});
+		if (doc.edit_url) {
+			dialog.set_secondary_action_label(__("Edit on GitHub"));
+			dialog.set_secondary_action(() => {
+				dialog.hide();
+				window.open(doc.edit_url, "_blank", "noopener");
+			});
+		}
+		dialog.show();
+	}
+
+	override_page(doc) {
+		frappe
+			.xcall("compendium.docs.make_override", {
+				path: doc.path,
+				locale: this.current_locale,
+			})
+			.then((page) => {
+				// same as frappe.model.open_mapped_doc: sync names the unsaved doc
+				frappe.model.sync(page);
+				frappe.set_route("Form", page.doctype, page.name);
+			});
 	}
 
 	render_mermaid() {
@@ -719,8 +815,7 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 			for (const node of trail) {
 				items.push({
 					label: node.title,
-					route: node.has_page ? this.get_docs_route(node.path) : "",
-					disabled: !node.has_page,
+					route: this.get_docs_route(node.path),
 				});
 			}
 		} else {
@@ -745,8 +840,8 @@ frappe.ui.DocsBrowser = class DocsBrowser {
 						? title
 						: node?.title ||
 						  frappe.utils.to_title_case(segments[index].replace(/-/g, " ")),
-				route: !is_last && node?.has_page ? this.get_docs_route(accumulated) : "",
-				disabled: is_last || !node?.has_page,
+				route: !is_last && node ? this.get_docs_route(accumulated) : "",
+				disabled: is_last || !node,
 			});
 		}
 	}
diff --git a/compendium/docs.py b/compendium/docs.py
index ab7f0aa..4a64c17 100644
--- a/compendium/docs.py
+++ b/compendium/docs.py
@@ -6,7 +6,7 @@
 import re
 import tomllib
 from collections import Counter
-from urllib.parse import quote, urlencode
+from urllib.parse import quote, unquote, urlencode
 
 import frappe
 from frappe import _
@@ -18,10 +18,14 @@
 from compendium.permissions import CONTRIBUTOR_ROLE
 
 DOCS_FOLDER = "docs"
+PAGE_DOCTYPE = "Compendium Page"
 DEFAULT_LANG = "en"
 DEFAULT_ROLE = "Desk User"
 ALLOWED_FRONTMATTER_KEYS = ("title", "order", "roles")
 IMAGE_SRC_PATTERN = re.compile(r'(<img[^>]+src=["\'])([^"\']+)(["\'])', re.IGNORECASE)
+PRIVATE_FILE_PATTERN = re.compile(
+	r'(<(?:img|a)\b[^>]+(?:src|href)=["\'])(/private/files/[^"\']+)(["\'])', re.IGNORECASE
+)
 GITHUB_ALERT_MARKER = re.compile(r"^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\][ \t]*", re.IGNORECASE)
 GITHUB_ALERTS = {
 	"NOTE": ("Note", "info"),
@@ -76,24 +80,23 @@ def get_view(path: str = "", locale: str | None = None, resolve_first: int | boo
 		}
 
 	page_record = pages.get(path)
-	if not page_record:
-		return {
-			"tree": tree,
-			"page": None,
-			"variants": [],
-			"path": path,
-			"first_path": first_path,
-			"exc_type": "DoesNotExistError",
-		}
+	if not page_record or not is_permitted(page_record):
+		# a group without an index page the reader may see still gets a page: its overview
+		group = find_tree_node(tree, path)
+		if group:
+			exc_type = None
+		elif page_record:
+			exc_type = "PermissionError"
+		else:
+			exc_type = "DoesNotExistError"
 
-	if not is_permitted(page_record):
 		return {
 			"tree": tree,
-			"page": None,
+			"page": build_overview_payload(group, locale) if group else None,
 			"variants": [],
 			"path": path,
 			"first_path": first_path,
-			"exc_type": "PermissionError",
+			"exc_type": exc_type,
 		}
 
 	return {
@@ -107,7 +110,7 @@ def get_view(path: str = "", locale: str | None = None, resolve_first: int | boo
 
 
 def build_page_payload(page, locale):
-	content = render_page_content(page.body, page.path, locale)
+	content = render_page_content(page.body, page.path, locale, is_db_page=bool(page.name))
 	user_roles = set(get_user_roles())
 	matching_roles = [role for role in page.roles if role in user_roles]
 	return {
@@ -122,9 +125,44 @@ def build_page_payload(page, locale):
 		"toc_html": render_toc(page.body),
 		"roles": [_(role) for role in matching_roles],
 		"edit_url": get_edit_url(page),
+		"edit_route": get_edit_route(page),
 	}
 
 
+def build_overview_payload(group, locale):
+	"""Stand-in page for a group without an index page: a list of its pages."""
+	links = []
+	for child in group["children"]:
+		label = child["title"].replace("[", r"\[").replace("]", r"\]")
+		links.append(f"- [{label}](/app/docs/{locale}/{quote(child['path'])})")
+	markdown = f"# {group['title']}\n\n" + "\n".join(links)
+
+	return {
+		"path": group["path"],
+		"title": group["title"],
+		"locale": locale,
+		"language": locale,
+		"language_label": get_locale_label(locale),
+		"is_fallback": False,
+		"is_overview": True,
+		"content": render_page_content(markdown),
+		"markdown": markdown,
+		"toc_html": "",
+		"roles": [],
+		"edit_url": None,
+		"edit_route": None,
+	}
+
+
+def find_tree_node(nodes, path):
+	for node in nodes:
+		if node["path"] == path:
+			return node
+		if path.startswith(node["path"] + "/"):
+			return find_tree_node(node["children"], path)
+	return None
+
+
 @frappe.whitelist()
 def get_first_page(locale: str | None = None):
 	"""Return the logical path of the first accessible documentation page."""
@@ -210,7 +248,10 @@ def get_asset(page_path: str, asset_path: str, locale: str | None = None):
 	"""Serve a documentation asset after verifying access to the referring page."""
 	locale = normalize_locale(locale)
 	page = get_page_record(normalize_path(page_path), locale=locale, check_permission=True)
-	asset_file = resolve_asset_path(page, asset_path)
+	if page.name:
+		asset_file = get_attached_file(page, asset_path).get_full_path()
+	else:
+		asset_file = resolve_asset_path(page, asset_path)
 
 	with open(asset_file, "rb") as f:
 		content = f.read()
@@ -283,9 +324,43 @@ def discover_raw_pages():
 				page.app_index = app_index
 				pages[(language, logical_path)] = page
 
+	# Pages written in Desk are the last layer, so a site can override what its apps ship.
+	for page in get_compendium_pages():
+		page.app_index = len(get_installed_apps())
+		pages[(page.language, page.path)] = page
+
 	return pages
 
 
+def get_compendium_pages():
+	"""Published Compendium Pages as page records."""
+	roles = {}
+	for row in frappe.get_all(
+		"Compendium Page Role", filters={"parenttype": PAGE_DOCTYPE}, fields=["parent", "role"]
+	):
+		roles.setdefault(row.parent, []).append(row.role)
+
+	return [
+		frappe._dict(
+			{
+				"name": record.name,
+				"path": record.path,
+				"title": record.title,
+				"order": cint(record.order),
+				"roles": roles.get(record.name) or [DEFAULT_ROLE],
+				"body": record.content or "",
+				"language": record.language,
+				"app": PAGE_DOCTYPE,
+			}
+		)
+		for record in frappe.get_all(
+			PAGE_DOCTYPE,
+			filters={"published": 1},
+			fields=["name", "path", "title", "order", "content", "language"],
+		)
+	]
+
+
 def compose_pages(raw_pages, locale):
 	"""Compose the final page map for the requested locale.
 
@@ -411,6 +486,7 @@ def get_first_page_path(pages):
 def merge_translated_page(canonical, localized):
 	return frappe._dict(
 		{
+			"name": localized.name,
 			"path": canonical.path,
 			"title": localized.title,
 			"order": canonical.order,
@@ -564,7 +640,7 @@ def can_edit_on_github():
 
 def get_edit_url(page):
 	"""GitHub edit URL for the Markdown file currently rendered, or None."""
-	if not can_edit_on_github():
+	if page.name or not can_edit_on_github():
 		return None
 
 	repository = get_app_repository_url(page.app)
@@ -592,6 +668,37 @@ def get_edit_url(page):
 	return f"https://github.com/{owner}/{repo}/edit/{quote(branch, safe='')}/{relative_path}"
 
 
+@frappe.whitelist()
+def make_override(path: str, locale: str | None = None):
+	"""An unsaved Compendium Page that overrides the page at this path.
+
+	Like a mapped document, the client opens it in a new form. The copy keeps the
+	page's path, language and roles, so saving it replaces the page for the same readers.
+	"""
+	page = get_page_record(normalize_path(path), locale=normalize_locale(locale), check_permission=True)
+	doc = frappe.new_doc(PAGE_DOCTYPE)
+	doc.update(
+		{
+			"title": page.title,
+			"path": page.path,
+			"language": page.language,
+			"order": page.order,
+			"content": page.body,
+		}
+	)
+	for role in page.roles:
+		doc.append("roles", {"role": role})
+	return doc
+
+
+def get_edit_route(page):
+	"""Desk route of the Compendium Page currently rendered, for users who may edit it."""
+	if not page.name or not frappe.has_permission(PAGE_DOCTYPE, "write", page.name):
+		return None
+
+	return f"/app/compendium-page/{quote(page.name)}"
+
+
 @frappe.request_cache
 def get_app_pyproject(app):
 	"""Parsed pyproject.toml for an installed app, or an empty dict."""
@@ -690,10 +797,13 @@ def sort_tree_nodes(nodes):
 		sort_tree_nodes(node["children"])
 
 
-def render_page_content(body, page_path="", locale=None):
+def render_page_content(body, page_path="", locale=None, is_db_page=False):
 	html = frappe.utils.md_to_html(body or "")
 	content = apply_github_alerts(str(html))
 	content = sanitize_html(content, linkify=True)
+	if is_db_page:
+		# readers cannot open the page's private attachments directly; get_asset serves them
+		return rewrite_private_file_urls(content, page_path, locale)
 	return rewrite_asset_urls(content, page_path, locale)
 
 
@@ -768,6 +878,14 @@ def replace(match):
 	return IMAGE_SRC_PATTERN.sub(replace, html or "")
 
 
+def rewrite_private_file_urls(html, page_path, locale=None):
+	def replace(match):
+		prefix, url, suffix = match.groups()
+		return f"{prefix}{get_asset_url(page_path, url, locale)}{suffix}"
+
+	return PRIVATE_FILE_PATTERN.sub(replace, html or "")
+
+
 def get_asset_url(page_path, asset_path, locale=None):
 	query = urlencode(
 		{
@@ -801,6 +919,23 @@ def resolve_asset_path(page, asset_path):
 	return asset_file
 
 
+def get_attached_file(page, file_url):
+	"""A file attached to the Compendium Page. Any other file is refused, so an author
+	cannot expose a private file from elsewhere on the site to the page's readers."""
+	name = frappe.db.get_value(
+		"File",
+		{
+			"file_url": unquote(file_url),
+			"attached_to_doctype": PAGE_DOCTYPE,
+			"attached_to_name": page.name,
+		},
+	)
+	if not name:
+		frappe.throw(_("Documentation asset not found"), frappe.DoesNotExistError)
+
+	return frappe.get_doc("File", name)
+
+
 def normalize_asset_path(asset_path):
 	if not asset_path:
 		frappe.throw(_("Invalid asset path"), frappe.ValidationError)
diff --git a/compendium/docs/de/compendium/docs/authoring.md b/compendium/docs/de/compendium/docs/authoring.md
index 8e43e07..ec746bb 100644
--- a/compendium/docs/de/compendium/docs/authoring.md
+++ b/compendium/docs/de/compendium/docs/authoring.md
@@ -70,6 +70,14 @@ logischem Pfad. Untergeordnete Pfade werden weiterhin unabhängig zusammengefüh
 Eine Übersetzung greift nur, wenn sie aus der App stammt, der die kanonische Seite
 gehört, oder aus einer später installierten App.
 
+## Seiten in Desk
+
+Seiten lassen sich auch in Desk schreiben, statt sie als Dateien auszuliefern.
+Sie kommen nach allen installierten Apps, eine Seite mit gleichem logischem Pfad
+ersetzt also die Seite der App. Übersetzte Seiten folgen denselben Regeln zur
+kanonischen Sprache wie Dateien. Siehe
+[Seiten in Desk schreiben](/app/docs/compendium/docs/desk-pages).
+
 ## Bilder und Assets
 
 Verweisen Sie im Markdown mit relativen Pfaden auf Bilder. Compendium liefert sie
@@ -79,8 +87,9 @@ App bleiben.
 ## Auf GitHub bearbeiten
 
 Wenn eine App in ihrer `pyproject.toml` eine GitHub-`Repository`-URL und
-`docs_branch` angibt, sehen Nutzer mit der Rolle **Compendium Contributor**
-einen Link **Edit on GitHub**, der die Markdown-Datei der aktuellen Seite öffnet.
+`docs_branch` angibt, können Nutzer mit der Rolle **Compendium Contributor**
+die Markdown-Datei der aktuellen Seite auf GitHub öffnen. Dazu klicken sie unten
+auf der Seite auf **Bearbeiten** und dann auf **Auf GitHub bearbeiten**.
 
 ```toml
 [project.urls]
diff --git a/compendium/docs/de/compendium/docs/desk-pages.md b/compendium/docs/de/compendium/docs/desk-pages.md
new file mode 100644
index 0000000..6a57f09
--- /dev/null
+++ b/compendium/docs/de/compendium/docs/desk-pages.md
@@ -0,0 +1,83 @@
+---
+title: Seiten in Desk schreiben
+translated_from_rev: 282363b
+---
+
+Neben den Seiten, die Apps mitbringen, können Sie eigene Seiten in Desk
+schreiben, die in der Datenbank Ihrer Site gespeichert werden.
+Sie benötigen die Berechtigung, eine **Compendium Page** anzulegen.
+Standardmäßig haben die Rollen **Compendium Contributor** und
+**System Manager** diese Berechtigung.
+
+## Seite hinzufügen
+
+Klicken Sie unten in der Seitenleiste der Dokumentation auf
+**+ Neue Seite hinzufügen**.
+
+Um eine Seite unter einer Gruppe oder einer Seite anzulegen, zeigen Sie in der
+Seitenleiste mit der Maus darauf und klicken Sie auf **+**. Der Pfad der neuen
+Seite beginnt mit dem Pfad der Gruppe.
+
+## Gruppen und Indexseiten
+
+Eine Seite mit Unterseiten ist eine Gruppe. Die Seite selbst ist die Indexseite
+der Gruppe. Um eine neue Gruppe anzulegen, fügen Sie unter einer bestehenden
+Seite eine Seite hinzu.
+
+Eine Gruppe ohne Indexseite zeigt eine Liste ihrer Seiten. Um die Indexseite zu
+schreiben, öffnen Sie die Gruppe und klicken Sie unten auf der Seite auf
+**Bearbeiten**.
+
+## Pfad
+
+Der Pfad wird aus der Bezeichnung gefüllt, z. B. wird `Erste Schritte` zu
+`erste-schritte`. Mit Schrägstrichen legen Sie die Seite in einen Ordner, z. B.
+`wiki/einarbeitung`. Pro Sprache gibt es nur eine Seite je Pfad.
+
+Eine Seite mit demselben Pfad wie die Seite einer App ersetzt diese auf dieser
+Site, zum Beispiel um eine Anleitung zu korrigieren, die nicht zu Ihrer
+Einrichtung passt.
+
+So ersetzen Sie die Seite einer App:
+
+1. Öffnen Sie die Seite und klicken Sie unten auf der Seite auf **Bearbeiten**.
+2. Klicken Sie auf **Mit Compendium Page überschreiben**. Ein neues Formular
+   öffnet sich mit Inhalt, Pfad und Rollen der App-Seite.
+3. Ändern Sie den Inhalt und speichern Sie.
+
+Hat die App ein GitHub-Repository, bietet derselbe Dialog auch
+**Auf GitHub bearbeiten**. Damit ändern Sie die Seite für alle Sites.
+
+> [!NOTE]
+> Bilder mit relativen Pfaden in der App-Seite werden in Ihrer Kopie nicht
+> angezeigt. Hängen Sie die Bilder an Ihre Seite an und ändern Sie die Links.
+
+> [!WARNING]
+> Solange Ihre Seite sie ersetzt, werden spätere Updates der App-Seite nicht
+> angezeigt. Löschen Sie Ihre Seite oder entfernen Sie den Haken bei
+> **Veröffentlicht**, um wieder die Seite der App zu zeigen.
+
+## Übersetzungen
+
+Eine Seite mit demselben Pfad in einer anderen Sprache ist eine Übersetzung.
+Sie übernimmt **Sortierung** und **Rollen** von der Seite in der Hauptsprache –
+Englisch, wo es sie gibt – und ignoriert ihre eigenen. Legen Sie diese auf der
+Hauptseite fest.
+
+## Bilder
+
+Sie können Anhänge in Ihre Seite einbetten, wenn sie öffentlich sind oder an der
+**Compendium Page** hängen. Andere private Dateien zeigt Compendium nicht an,
+damit Berechtigungen nicht umgangen werden.
+
+Wenn Sie ein Bild in den Editor ziehen, wird das Markdown automatisch eingefügt.
+Jede andere Datei hängen Sie über **Anhänge** in der Seitenleiste des Formulars
+an und verlinken ihre URL:
+
+```md
+![Lagerplan](/private/files/lagerplan.png)
+
+[Preisliste (PDF)](/private/files/preisliste.pdf)
+
+![Firmenlogo](/files/logo.png)
+```
diff --git a/compendium/docs/de/compendium/docs/index.md b/compendium/docs/de/compendium/docs/index.md
index 919cf27..c3d88c4 100644
--- a/compendium/docs/de/compendium/docs/index.md
+++ b/compendium/docs/de/compendium/docs/index.md
@@ -14,6 +14,7 @@ Mit Compendium können Frappe-Apps ihre Benutzerdokumentation als Markdown-Datei
 - Optionale Frontmatter-Schlüssel: `title`, `order`, `roles`
 - Ohne `roles` ist eine Seite für alle **Desk User** sichtbar
 - Später installierte Apps überschreiben Seiten mit gleichem logischem Pfad
+- In Desk geschriebene Seiten kommen nach allen Apps – siehe [Seiten in Desk schreiben](/app/docs/compendium/docs/desk-pages)
 
 Eine Einführung finden Sie unter [Erste Schritte](/desk/docs/compendium/docs/getting-started),
 und unter [Suche](/desk/docs/compendium/docs/search), wie Sie eine Seite über die
diff --git a/compendium/docs/de/compendium/docs/search.md b/compendium/docs/de/compendium/docs/search.md
index 0f55e4e..2b58906 100644
--- a/compendium/docs/de/compendium/docs/search.md
+++ b/compendium/docs/de/compendium/docs/search.md
@@ -34,6 +34,7 @@ Die Ergebnisse enthalten nur Seiten, die Sie öffnen dürfen. Eine über `roles`
 eingeschränkte Seite bleibt für alle anderen Benutzer verborgen.
 
 > [!NOTE]
-> Der Index erneuert sich, sobald sich eine Markdown-Datei ändert. Suchen Sie
-> nach dem Bearbeiten einer Seite erneut, um den neuen Inhalt zu sehen. Ein
-> Neustart ist nicht nötig.
+> Der Index erneuert sich, sobald sich eine Markdown-Datei ändert oder eine in
+> Desk geschriebene Seite gespeichert oder gelöscht wird. Suchen Sie nach dem
+> Bearbeiten einer Seite erneut, um den neuen Inhalt zu sehen. Ein Neustart ist
+> nicht nötig.
diff --git a/compendium/docs/de/compendium/index.md b/compendium/docs/de/compendium/index.md
index 10cb468..8968bcd 100644
--- a/compendium/docs/de/compendium/index.md
+++ b/compendium/docs/de/compendium/index.md
@@ -5,4 +5,5 @@ translated_from_rev: 82e1353
 
 Compendium ist eine eigenständige Frappe-App, die App-interne Dokumentation aus Markdown-Dateien ausliefert, die beliebige installierte Apps mitbringen.
 
-Die gesammelte Dokumentation finden Sie im Desk unter `/desk/docs`. Jede App kann Seiten aus ihrem eigenen `docs/{language}/`-Baum beisteuern.
+Die gesammelte Dokumentation finden Sie im Desk unter `/desk/docs`. Jede App kann Seiten aus ihrem eigenen `docs/{language}/`-Baum beisteuern, und
+Sie können eigene Seiten in Desk ergänzen.
diff --git a/compendium/docs/en/compendium/docs/authoring.md b/compendium/docs/en/compendium/docs/authoring.md
index cfa03c2..a66e844 100644
--- a/compendium/docs/en/compendium/docs/authoring.md
+++ b/compendium/docs/en/compendium/docs/authoring.md
@@ -68,6 +68,13 @@ path. Child paths continue to merge independently.
 For translations, a localized variant applies only when it comes from the app
 that owns the canonical page or a later installed app.
 
+## Pages in Desk
+
+Pages can also be written in Desk instead of shipped as files. They come after
+all installed apps, so a page at the same logical path replaces the app's page.
+Localized pages follow the same canonical-language rules as files. See
+[Writing Pages in Desk](/app/docs/compendium/docs/desk-pages).
+
 ## Images and assets
 
 Reference images with relative paths in Markdown. Compendium serves them through
@@ -76,8 +83,9 @@ Reference images with relative paths in Markdown. Compendium serves them through
 ## Edit on GitHub
 
 When an app declares a GitHub `Repository` URL and a `docs_branch` in its
-`pyproject.toml`, contributors with the **Compendium Contributor** role see an
-**Edit on GitHub** link that opens the Markdown file for the current page.
+`pyproject.toml`, contributors with the **Compendium Contributor** role can
+open the Markdown file of the current page on GitHub. They click **Edit** at the
+bottom of the page, then **Edit on GitHub**.
 
 ```toml
 [project.urls]
diff --git a/compendium/docs/en/compendium/docs/desk-pages.md b/compendium/docs/en/compendium/docs/desk-pages.md
new file mode 100644
index 0000000..6734bad
--- /dev/null
+++ b/compendium/docs/en/compendium/docs/desk-pages.md
@@ -0,0 +1,74 @@
+---
+title: Writing Pages in Desk
+order: 3
+roles:
+  - System Manager
+  - Compendium Contributor
+---
+
+Besides the pages that apps ship, you can write your own pages in Desk, saved in the Database of your Site.
+You need permission to create a **Compendium Page**. By default, the
+**Compendium Contributor** and **System Manager** roles have it.
+
+## Add a page
+
+Click **+ Add new Page** at the bottom of the documentation sidebar.
+
+To add a page below a group or a page, move the pointer over it in the sidebar
+and click **+**. The path of the new page starts with the path of the group.
+
+## Groups and index pages
+
+A page with pages below it is a group. The page itself is the index page of
+the group. To start a new group, add a page below an existing page.
+
+A group without an index page shows a list of its pages. To write the index
+page, open the group and click **Edit** at the bottom of the page.
+
+## Path
+
+The path is filled from the title, e.g. `Getting Started` becomes
+`getting-started`. Use slashes to place the page in a folder, e.g.
+`wiki/onboarding`. Each language can hold only one page per path.
+
+A page at the same path as an app's page replaces it on this site, for example
+to correct instructions that do not fit your setup.
+
+To replace an app's page:
+
+1. Open the page and click **Edit** at the bottom of the page.
+2. Click **Override with Compendium Page**. A new form opens with the content,
+   path and roles of the app's page.
+3. Change the content and save.
+
+If the app has a GitHub repository, the same dialog also has **Edit on GitHub**.
+Use it to change the page for all sites.
+
+> [!NOTE]
+> Images with relative paths in the app's page do not show in your copy.
+> Attach the images to your page and change the links.
+
+> [!WARNING]
+> While your page replaces it, later updates of the app's page are not shown.
+> Delete your page or clear **Published** to show the app's page again.
+
+## Translations
+
+A page with the same path in another language is a translation. It takes
+**Sort Order** and **Roles** from the page in the main language — English
+wherever one exists — and ignores its own. Set them on the main page.
+
+## Images
+
+You can embed attachments in your own page if they are public or attached to the **Compendium Page**. Other private files are not rendered in Compendium to avoid Permission Bypassing.
+
+Dragging an image into the editor inserts the Markdown for you. For any other
+file, attach it with **Attachments** in the form sidebar and link to its URL:
+
+```md
+![Warehouse layout](/private/files/warehouse-layout.png)
+
+[Price list (PDF)](/private/files/price-list.pdf)
+
+![Company logo](/files/logo.png)
+```
diff --git a/compendium/docs/en/compendium/docs/index.md b/compendium/docs/en/compendium/docs/index.md
index fe262de..fc5e596 100644
--- a/compendium/docs/en/compendium/docs/index.md
+++ b/compendium/docs/en/compendium/docs/index.md
@@ -16,6 +16,7 @@ Compendium lets Frappe apps ship user documentation as Markdown files under a `d
 - Optional frontmatter keys: `title`, `order`, `roles`
 - Omit `roles` to allow all **Desk User** accounts
 - Later installed apps override pages at the same logical path
+- Pages written in Desk come on top of all apps — see [Writing Pages in Desk](/app/docs/compendium/docs/desk-pages)
 
 See [Getting Started](/app/docs/en/compendium/docs/getting-started) for a walkthrough,
 or [Search](/app/docs/en/compendium/docs/search) to find a page from the Awesome Bar.
diff --git a/compendium/docs/en/compendium/docs/search.md b/compendium/docs/en/compendium/docs/search.md
index d9d1c02..5e46591 100644
--- a/compendium/docs/en/compendium/docs/search.md
+++ b/compendium/docs/en/compendium/docs/search.md
@@ -34,5 +34,6 @@ The results only contain pages that you are allowed to open. A page that is
 restricted with `roles` stays hidden for all other users.
 
 > [!NOTE]
-> The index updates itself when a Markdown file changes. After you edit a page,
-> search again to see the new content. A restart is not needed.
+> The index updates itself when a Markdown file changes or a page written in
+> Desk is saved or deleted. After you edit a page, search again to see the new
+> content. A restart is not needed.
diff --git a/compendium/docs/en/compendium/index.md b/compendium/docs/en/compendium/index.md
index 32539fd..19e646a 100644
--- a/compendium/docs/en/compendium/index.md
+++ b/compendium/docs/en/compendium/index.md
@@ -7,4 +7,5 @@ roles:
 
 Compendium is a standalone Frappe app that serves in-app documentation from Markdown files shipped by any installed app.
 
-Browse the aggregated docs at `/desk/docs` in Desk. Each app can contribute pages from its own `docs/{language}/` tree.
+Browse the aggregated docs at `/desk/docs` in Desk. Each app can contribute pages from its own `docs/{language}/` tree, and you can
+write your own pages in Desk on top.
diff --git a/compendium/locale/de.po b/compendium/locale/de.po
index ca8a64a..ddfb2e3 100644
--- a/compendium/locale/de.po
+++ b/compendium/locale/de.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Compendium VERSION\n"
 "Report-Msgid-Bugs-To: hallo@alyf.de\n"
-"POT-Creation-Date: 2026-08-12 18:42+0053\n"
+"POT-Creation-Date: 2026-09-29 23:05+0053\n"
 "PO-Revision-Date: 2026-08-12 18:40+0053\n"
 "Last-Translator: hallo@alyf.de\n"
 "Language: de\n"
@@ -18,73 +18,135 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.13.1\n"
 
+#: compendium/compendium/page/docs/docs.js:265
+msgid "Add new Page"
+msgstr "Neue Seite hinzufügen"
+
+#: compendium/compendium/page/docs/docs.js:316
+msgid "Add page to {0}"
+msgstr "Seite zu {0} hinzufügen"
+
 #. Label of a standard help item
 #. Type: Route
 #: compendium/hooks.py
 msgid "Compendium"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:50
+#. Name of a role
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Compendium Contributor"
+msgstr "Compendium-Mitwirkender"
+
+#. Name of a DocType
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Compendium Page"
+msgstr "Compendium-Seite"
+
+#. Name of a DocType
+#: compendium/compendium/doctype/compendium_page_role/compendium_page_role.json
+msgid "Compendium Page Role"
+msgstr "Compendium-Seitenrolle"
+
+#: compendium/compendium/page/docs/docs.js:589
 msgid "Copy as Markdown"
 msgstr "Als Markdown kopieren"
 
-#: compendium/compendium/page/docs/docs.js:443
+#: compendium/compendium/page/docs/docs.js:461
 msgid "Copy link"
 msgstr "Link kopieren"
 
-#: compendium/docs.py:734
+#: compendium/docs.py:885 compendium/docs.py:902
 msgid "Documentation asset not found"
 msgstr "Dokumentationsressource nicht gefunden"
 
-#: compendium/docs.py:524
+#: compendium/docs.py:579
 msgid "Documentation page not found"
 msgstr "Dokumentationsseite nicht gefunden"
 
-#: compendium/compendium/page/docs/docs.js:432
+#: compendium/compendium/page/docs/docs.js:619
+msgid "Edit Page"
+msgstr "Seite bearbeiten"
+
+#: compendium/compendium/page/docs/docs.js:633
 msgid "Edit on GitHub"
 msgstr "Auf GitHub bearbeiten"
 
-#: compendium/docs.py:731 compendium/docs.py:741 compendium/docs.py:745
+#. Description of the 'Path' (Data) field in DocType 'Compendium Page'
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Filled from the title when empty. Use slashes to nest pages, e.g. guides/setup. A page at the path of an app page replaces it."
+msgstr "Wird aus dem Titel gefüllt, wenn leer. Seiten lassen sich mit Schrägstrichen verschachteln, z. B. guides/setup. Eine Seite mit dem Pfad einer App-Seite ersetzt diese."
+
+#: compendium/docs.py:882 compendium/docs.py:909 compendium/docs.py:913
 msgid "Invalid asset path"
 msgstr "Ungültiger Ressourcenpfad"
 
-#: compendium/docs.py:454
+#: compendium/docs.py:509
 msgid "Invalid documentation locale"
 msgstr "Ungültige Dokumentationssprache"
 
-#: compendium/docs.py:514
+#: compendium/docs.py:569
 msgid "Invalid documentation path"
 msgstr "Ungültiger Dokumentationspfad"
 
-#: compendium/compendium/page/docs/docs.js:623
+#: compendium/compendium/page/docs/docs.js:715
 msgid "No documentation is available for your account."
 msgstr "Für Ihr Konto ist keine Dokumentation verfügbar."
 
-#: compendium/docs.py:527
+#: compendium/docs.py:582
 msgid "No read permission for documentation page {0}"
 msgstr "Keine Leseberechtigung für Dokumentationsseite {0}"
 
-#: compendium/compendium/page/docs/docs.js:52
+#: compendium/compendium/page/docs/docs.js:53
 msgid "On this page"
 msgstr "Auf dieser Seite"
 
-#: compendium/compendium/page/docs/docs.js:544
+#: compendium/compendium/page/docs/docs.js:626
+msgid "Override with Compendium Page"
+msgstr "Mit Compendium-Seite überschreiben"
+
+#: compendium/compendium/doctype/compendium_page/compendium_page.py:17
+msgid "Please set a path for this page"
+msgstr "Bitte legen Sie einen Pfad für diese Seite fest"
+
+#: compendium/compendium/doctype/compendium_page/compendium_page.js:13
+msgid "Save the page before adding images."
+msgstr "Speichern Sie die Seite, bevor Sie Bilder hinzufügen."
+
+#: compendium/compendium/page/docs/docs.js:612
+msgid "This page comes with an installed app. You can override it on this site with a Compendium Page, or change its source on GitHub."
+msgstr "Diese Seite stammt aus einer installierten App. Sie können sie auf dieser Site mit einer Compendium-Seite überschreiben oder ihre Quelle auf GitHub ändern."
+
+#: compendium/compendium/page/docs/docs.js:615
+msgid "This page comes with an installed app. You can override it on this site with a Compendium Page."
+msgstr "Diese Seite stammt aus einer installierten App. Sie können sie auf dieser Site mit einer Compendium-Seite überschreiben."
+
+#: compendium/compendium/page/docs/docs.js:562
 msgid "This page is only available in {0}."
 msgstr "Diese Seite ist nur auf {0} verfügbar."
 
-#: compendium/compendium/page/docs/docs.js:269
+#: compendium/compendium/page/docs/docs.js:292
 msgid "Toggle {0}"
 msgstr "{0} umschalten"
 
-#: compendium/compendium/page/docs/docs.js:647
+#: compendium/compendium/page/docs/docs.js:737
 msgid "Unable to load documentation page {0}"
 msgstr "Dokumentationsseite {0} konnte nicht geladen werden"
 
-#: compendium/compendium/page/docs/docs.js:558
+#. Description of the 'Roles' (Table MultiSelect) field in DocType 'Compendium
+#. Page'
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Who can read the page. Empty means Desk User. Ignored for a translation: it takes the roles of the page in the canonical language (English where one exists)."
+msgstr "Wer die Seite lesen darf. Leer bedeutet Desk User. Wird bei einer Übersetzung ignoriert: Sie übernimmt die Rollen der Seite in der kanonischen Sprache (Englisch, sofern vorhanden)."
+
+#: compendium/compendium/page/docs/docs.js:576
 msgid "You can see this page because you have the role {0}."
 msgstr "Sie können diese Seite sehen, weil Sie die Rolle {0} haben."
 
-#: compendium/compendium/page/docs/docs.js:559
+#: compendium/compendium/page/docs/docs.js:577
 msgid "You can see this page because you have the roles {0}."
 msgstr "Sie können diese Seite sehen, weil Sie die Rollen {0} haben."
 
+#: compendium/compendium/doctype/compendium_page/compendium_page.py:24
+msgid "{0} already documents the path {1} in this language"
+msgstr "{0} dokumentiert den Pfad {1} bereits in dieser Sprache"
+
diff --git a/compendium/locale/main.pot b/compendium/locale/main.pot
index 1407dc3..b84f170 100644
--- a/compendium/locale/main.pot
+++ b/compendium/locale/main.pot
@@ -7,8 +7,8 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Compendium VERSION\n"
 "Report-Msgid-Bugs-To: hallo@alyf.de\n"
-"POT-Creation-Date: 2026-08-12 18:42+0053\n"
-"PO-Revision-Date: 2026-08-12 18:42+0053\n"
+"POT-Creation-Date: 2026-09-29 23:05+0053\n"
+"PO-Revision-Date: 2026-09-29 23:05+0053\n"
 "Last-Translator: hallo@alyf.de\n"
 "Language-Team: hallo@alyf.de\n"
 "MIME-Version: 1.0\n"
@@ -16,73 +16,135 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.13.1\n"
 
+#: compendium/compendium/page/docs/docs.js:265
+msgid "Add new Page"
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:316
+msgid "Add page to {0}"
+msgstr ""
+
 #. Label of a standard help item
 #. Type: Route
 #: compendium/hooks.py
 msgid "Compendium"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:50
+#. Name of a role
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Compendium Contributor"
+msgstr ""
+
+#. Name of a DocType
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Compendium Page"
+msgstr ""
+
+#. Name of a DocType
+#: compendium/compendium/doctype/compendium_page_role/compendium_page_role.json
+msgid "Compendium Page Role"
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:589
 msgid "Copy as Markdown"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:443
+#: compendium/compendium/page/docs/docs.js:461
 msgid "Copy link"
 msgstr ""
 
-#: compendium/docs.py:734
+#: compendium/docs.py:885 compendium/docs.py:902
 msgid "Documentation asset not found"
 msgstr ""
 
-#: compendium/docs.py:524
+#: compendium/docs.py:579
 msgid "Documentation page not found"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:432
+#: compendium/compendium/page/docs/docs.js:619
+msgid "Edit Page"
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:633
 msgid "Edit on GitHub"
 msgstr ""
 
-#: compendium/docs.py:731 compendium/docs.py:741 compendium/docs.py:745
+#. Description of the 'Path' (Data) field in DocType 'Compendium Page'
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Filled from the title when empty. Use slashes to nest pages, e.g. guides/setup. A page at the path of an app page replaces it."
+msgstr ""
+
+#: compendium/docs.py:882 compendium/docs.py:909 compendium/docs.py:913
 msgid "Invalid asset path"
 msgstr ""
 
-#: compendium/docs.py:454
+#: compendium/docs.py:509
 msgid "Invalid documentation locale"
 msgstr ""
 
-#: compendium/docs.py:514
+#: compendium/docs.py:569
 msgid "Invalid documentation path"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:623
+#: compendium/compendium/page/docs/docs.js:715
 msgid "No documentation is available for your account."
 msgstr ""
 
-#: compendium/docs.py:527
+#: compendium/docs.py:582
 msgid "No read permission for documentation page {0}"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:52
+#: compendium/compendium/page/docs/docs.js:53
 msgid "On this page"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:544
+#: compendium/compendium/page/docs/docs.js:626
+msgid "Override with Compendium Page"
+msgstr ""
+
+#: compendium/compendium/doctype/compendium_page/compendium_page.py:17
+msgid "Please set a path for this page"
+msgstr ""
+
+#: compendium/compendium/doctype/compendium_page/compendium_page.js:13
+msgid "Save the page before adding images."
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:612
+msgid "This page comes with an installed app. You can override it on this site with a Compendium Page, or change its source on GitHub."
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:615
+msgid "This page comes with an installed app. You can override it on this site with a Compendium Page."
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:562
 msgid "This page is only available in {0}."
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:269
+#: compendium/compendium/page/docs/docs.js:292
 msgid "Toggle {0}"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:647
+#: compendium/compendium/page/docs/docs.js:737
 msgid "Unable to load documentation page {0}"
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:558
+#. Description of the 'Roles' (Table MultiSelect) field in DocType 'Compendium
+#. Page'
+#: compendium/compendium/doctype/compendium_page/compendium_page.json
+msgid "Who can read the page. Empty means Desk User. Ignored for a translation: it takes the roles of the page in the canonical language (English where one exists)."
+msgstr ""
+
+#: compendium/compendium/page/docs/docs.js:576
 msgid "You can see this page because you have the role {0}."
 msgstr ""
 
-#: compendium/compendium/page/docs/docs.js:559
+#: compendium/compendium/page/docs/docs.js:577
 msgid "You can see this page because you have the roles {0}."
 msgstr ""
 
+#: compendium/compendium/doctype/compendium_page/compendium_page.py:24
+msgid "{0} already documents the path {1} in this language"
+msgstr ""
+
diff --git a/compendium/search.py b/compendium/search.py
index 8189f78..0e43565 100644
--- a/compendium/search.py
+++ b/compendium/search.py
@@ -11,7 +11,7 @@
 from frappe.utils import escape_html
 
 from compendium import docs
-from compendium.docs import DEFAULT_LANG, DOCS_FOLDER, is_permitted, normalize_locale
+from compendium.docs import DEFAULT_LANG, DOCS_FOLDER, PAGE_DOCTYPE, is_permitted, normalize_locale
 
 RESULT_LIMIT = 20
 TOKEN_PATTERN = re.compile(r"\w+")
@@ -133,11 +133,13 @@ def build_index(locale):
 
 @frappe.request_cache
 def get_docs_fingerprint():
-	"""Staleness check for the index: every Markdown file with its mtime and size.
+	"""Staleness check for the index: every Markdown file with its mtime and size, plus
+	the count and newest change of the Compendium Pages.
 
 	Stat-only, so it costs a fraction of the reading and parsing an index build does.
 	A file count and a newest mtime would be cheaper but would miss a deployment that
 	restores the timestamps it found, leaving an edited page unsearchable until restart.
+	Records carry no such risk: every save moves `modified`, every delete the count.
 	"""
 	stamps = []
 
@@ -152,7 +154,8 @@ def get_docs_fingerprint():
 				stat = os.stat(filepath)
 				stamps.append((filepath, stat.st_mtime_ns, stat.st_size))
 
-	return tuple(sorted(stamps))
+	pages = frappe.get_all(PAGE_DOCTYPE, fields=["count(name) as count", "max(modified) as modified"])[0]
+	return (*sorted(stamps), (pages.count, str(pages.modified)))
 
 
 def to_plain_text(markdown):
diff --git a/compendium/tests/test_docs.py b/compendium/tests/test_docs.py
index b557783..0cf1b0a 100644
--- a/compendium/tests/test_docs.py
+++ b/compendium/tests/test_docs.py
@@ -641,6 +641,28 @@ def test_get_view_keeps_tree_when_page_is_missing(self):
 			self.assertEqual([node["path"] for node in view["tree"]], ["guide"])
 			self.assertEqual(view["first_path"], "guide")
 
+	def test_get_view_shows_overview_for_group_without_index_page(self):
+		with self.docs_environment(
+			{
+				"en/guides/setup.md": "---\ntitle: Setup\n---\n# Setup",
+				"en/guides/secret.md": "---\ntitle: Secret\nroles: Nobody\n---\n# Secret",
+				"en/hidden/only.md": "---\ntitle: Only\nroles: Nobody\n---\n# Only",
+			}
+		):
+			frappe.set_user("Guest")
+			with patch("compendium.docs.get_user_roles", return_value=["Desk User"]):
+				view = get_view("guides", locale="en")
+				hidden = get_view("hidden", locale="en")
+
+		self.assertIsNone(view["exc_type"])
+		self.assertTrue(view["page"]["is_overview"])
+		self.assertEqual(view["page"]["title"], "Guides")
+		self.assertIn('href="/app/docs/en/guides/setup"', view["page"]["content"])
+		self.assertNotIn("Secret", view["page"]["content"])
+		# a group whose pages the reader cannot see stays hidden
+		self.assertIsNone(hidden["page"])
+		self.assertEqual(hidden["exc_type"], "DoesNotExistError")
+
 	def test_get_view_resolve_first_selects_opening_page(self):
 		with self.docs_environment(
 			{
@@ -747,8 +769,9 @@ def docs_environment(self, files, repository=None, docs_branch=None):
 
 
 class DocsTestEnvironment:
-	def __init__(self, files, repository=None, docs_branch=None):
+	def __init__(self, files, repository=None, docs_branch=None, db_pages=False):
 		self.files = files
+		self.db_pages = db_pages
 		self.repository = repository
 		self.docs_branch = docs_branch
 		self.tmpdir = None
@@ -782,6 +805,9 @@ def __enter__(self):
 			patch("compendium.docs.get_installed_apps", return_value=["frappe"]),
 			patch("compendium.docs.get_app_path", return_value=app_root),
 		]
+		if not self.db_pages:
+			# keep the site's own Compendium Pages out of file-based tests
+			self._patches.append(patch("compendium.docs.get_compendium_pages", return_value=[]))
 		for patcher in self._patches:
 			patcher.start()
 		if hasattr(frappe.local, "request_cache"):
diff --git a/cypress/integration/docs.js b/cypress/integration/docs.js
index 5dd5cb1..aa35c85 100644
--- a/cypress/integration/docs.js
+++ b/cypress/integration/docs.js
@@ -86,13 +86,27 @@ context("Documentation Browser", () => {
 		cy.get("@clipboardWrite").should("have.been.calledWithMatch", /#code-blocks$/);
 	});
 
-	it("shows Edit on GitHub for Administrator when repository is set", () => {
-		cy.visit("/desk/docs/en/compendium/docs/authoring");
-		cy.get(".docs-page-footer .docs-edit-link")
-			.should("be.visible")
-			.and("contain", "Edit on GitHub")
-			.and("have.attr", "href")
-			.and("include", "github.com/alyf-de/compendium");
+	it("offers override or Edit on GitHub for an app page", () => {
+		cy.visit("/app/docs/en/compendium/docs/authoring");
+		cy.window().then((win) => {
+			cy.stub(win, "open").as("windowOpen");
+		});
+		cy.get(".docs-page-footer .docs-edit-button").click();
+		cy.get(".modal:visible").should("contain", "Override with Compendium Page");
+		cy.get(".modal:visible .btn-secondary").should("contain", "Edit on GitHub").click();
+		cy.get("@windowOpen").should(
+			"have.been.calledWithMatch",
+			/github\.com\/alyf-de\/compendium\/edit\//,
+		);
+	});
+
+	it("shows Add new Page below the tree and a + on groups", () => {
+		cy.visit("/app/docs/en/compendium/docs/authoring");
+		cy.get(".docs-tree > .docs-tree-add").should("contain", "Add new Page");
+		cy.get(".docs-tree-list .docs-tree-add").should("not.exist");
+		cy.get('.docs-tree-item[data-has-children="1"] > .docs-tree-row > .docs-tree-add-child')
+			.first()
+			.should("exist");
 	});
 
 	it("keeps the breadcrumbs when the locale is switched", () => {

From fff3c008505c3ffcb0877367cf206ffe613bb2e1 Mon Sep 17 00:00:00 2001
From: barredterra <14891507+barredterra@users.noreply.github.com>
Date: Wed, 30 Sep 2026 00:29:20 +0200
Subject: [PATCH 2/2] fix: SQL functions

---
 compendium/search.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/compendium/search.py b/compendium/search.py
index 0e43565..aaddfb7 100644
--- a/compendium/search.py
+++ b/compendium/search.py
@@ -154,7 +154,9 @@ def get_docs_fingerprint():
 				stat = os.stat(filepath)
 				stamps.append((filepath, stat.st_mtime_ns, stat.st_size))
 
-	pages = frappe.get_all(PAGE_DOCTYPE, fields=["count(name) as count", "max(modified) as modified"])[0]
+	pages = frappe.get_all(
+		PAGE_DOCTYPE, fields=[{"COUNT": "name", "as": "count"}, {"MAX": "modified", "as": "modified"}]
+	)[0]
 	return (*sorted(stamps), (pages.count, str(pages.modified)))