From 964cd6f76d9b8b1eb8059bbe9a22685a978959ca Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Fri, 19 Jun 2026 01:22:08 -0500
Subject: [PATCH] page organization

---
 zensical.toml | 66 +++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 62 insertions(+), 4 deletions(-)

diff --git a/zensical.toml b/zensical.toml
index 3721108..916362c 100644
--- a/zensical.toml
+++ b/zensical.toml
@@ -44,10 +44,68 @@ Copyright &copy; 2026 The authors
 # can be defined using TOML syntax.
 #
 # Read more: https://zensical.org/docs/setup/navigation/
-# nav = [
-#   { "Get started" = "index.md" },
-#   { "Markdown in 5min" = "markdown.md" },
-# ]
+nav = [
+  { "Home" = "index.md" },
+  { "Guide" = [
+    { "Arch" = "architecture.md" },
+    { "MCP" = "mcp_layout.md" },
+    { "Copilot" = "copilot.md" },
+    { "Usage" = "usage.md" },
+    { "New Skill" = "new_skill.md" },
+    { "Security" = "securing.md" },
+  ] },
+  { "Skills" = [
+    { "Copilot" = [
+      { "Overview" = "skills/copilot-customization/SKILL.md" },
+      { "VS Code" = "skills/copilot-customization/references/vscode-customization.md" },
+    ] },
+    { "FastAPI UV" = [
+      { "Overview" = "skills/fastapi-uv-docker/SKILL.md" },
+      { "Best" = "skills/fastapi-uv-docker/references/fastapi-best-practices.md" },
+      { "Layout" = "skills/fastapi-uv-docker/references/uv-project-layout.md" },
+      { "Uvicorn" = "skills/fastapi-uv-docker/references/uvicorn-settings.md" },
+      { "Docker" = "skills/fastapi-uv-docker/references/docker-cloud-native.md" },
+    ] },
+    { "Async SQLA" = [
+      { "Overview" = "skills/fastapi-async-sqlalchemy-modernization/SKILL.md" },
+      { "Index" = "skills/fastapi-async-sqlalchemy-modernization/references/index.md" },
+      { "Engine" = "skills/fastapi-async-sqlalchemy-modernization/references/engine.md" },
+      { "Session" = "skills/fastapi-async-sqlalchemy-modernization/references/session.md" },
+      { "Tx" = "skills/fastapi-async-sqlalchemy-modernization/references/transactions.md" },
+      { "IO" = "skills/fastapi-async-sqlalchemy-modernization/references/implicit_io.md" },
+      { "Obs" = "skills/fastapi-async-sqlalchemy-modernization/references/observability.md" },
+      { "Template" = "skills/fastapi-async-sqlalchemy-modernization/references/template.md" },
+    ] },
+    { "NiceGUI" = [
+      { "Overview" = "skills/nicegui/SKILL.md" },
+      { "Arch" = "skills/nicegui/references/architecture.md" },
+      { "Sources" = "skills/nicegui/references/source-documentation.md" },
+    ] },
+    { "NiceGUI UI" = [
+      { "Overview" = "skills/nicegui-ui-customization/SKILL.md" },
+      { "Style" = "skills/nicegui-ui-customization/references/architecture-and-styling.md" },
+      { "Flows" = "skills/nicegui-ui-customization/references/interaction-patterns.md" },
+      { "Quality" = "skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md" },
+    ] },
+    { "Pytest" = [
+      { "Overview" = "skills/pytest-scaffolding/SKILL.md" },
+      { "Docs" = "skills/pytest-scaffolding/references/pytest-docs.md" },
+    ] },
+    { "Logging" = [
+      { "Overview" = "skills/python-logging-dictconfig/SKILL.md" },
+      { "Docs" = "skills/python-logging-dictconfig/references/python-logging-docs.md" },
+    ] },
+    { "Zensical" = [
+      { "Overview" = "skills/zensical-docs/SKILL.md" },
+      { "Map" = "skills/zensical-docs/references/index.md" },
+      { "Features" = "skills/zensical-docs/references/zensical-features.md" },
+      { "Theme" = "skills/zensical-docs/references/theme-customization-and-icons.md" },
+      { "Quality" = "skills/zensical-docs/references/documentation-quality.md" },
+      { "IA" = "skills/zensical-docs/references/discoverability-and-ia.md" },
+      { "API Docs" = "skills/zensical-docs/references/code-heavy-docs-and-mkdocstrings.md" },
+    ] },
+  ] },
+]
 
 # With the "extra_css" option you can add your own CSS styling to customize
 # your Zensical project according to your needs. You can add any number of