diff --git a/CHANGELOG.md b/CHANGELOG.md
index b15ca6c0..50b8c6c6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+- docs: migrate Mintlify config from deprecated `mint.json` to `docs.json` v2 format; update navigation to use `{ "groups": [...] }` object structure; add logo, favicon, and theme fields
+
 ### Fixed
 - fix(ci): `update-screenshots` — add `pull-requests: write` permission and switch both `actions/checkout` and `peter-evans/create-pull-request` from `GITHUB_TOKEN` to `DOCS_REPO_TOKEN` (PAT with `repo` scope); `GITHUB_TOKEN` is blocked from creating PRs against protected branches
 - fix(ci): `sync-docs` — add `--exclude='.git'` to the rsync step; `rsync --delete` was deleting the `.git` directory cloned in the previous step because it doesn't exist in the source (`sencho/docs/`), causing `fatal: not in a git directory` in the commit step
diff --git a/docs/docs.json b/docs/docs.json
new file mode 100644
index 00000000..230e9e4e
--- /dev/null
+++ b/docs/docs.json
@@ -0,0 +1,56 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "theme": "mint",
+  "name": "Sencho",
+  "colors": {
+    "primary": "#0F172A",
+    "light": "#3B82F6",
+    "dark": "#0F172A"
+  },
+  "logo": {
+    "light": "/images/logo/logo-light.svg",
+    "dark": "/images/logo/logo-dark.svg",
+    "href": "/"
+  },
+  "favicon": "/images/logo/favicon.ico",
+  "navigation": {
+    "groups": [
+      {
+        "group": "Getting Started",
+        "pages": [
+          "getting-started/introduction",
+          "getting-started/quickstart",
+          "getting-started/configuration"
+        ]
+      },
+      {
+        "group": "Features",
+        "pages": [
+          "features/overview",
+          "features/dashboard",
+          "features/stack-management",
+          "features/editor",
+          "features/resources",
+          "features/app-store",
+          "features/global-observability",
+          "features/host-console",
+          "features/multi-node",
+          "features/alerts-notifications"
+        ]
+      },
+      {
+        "group": "Reference",
+        "pages": [
+          "reference/settings"
+        ]
+      },
+      {
+        "group": "Operations",
+        "pages": [
+          "operations/troubleshooting",
+          "operations/backup"
+        ]
+      }
+    ]
+  }
+}
diff --git a/docs/mint.json b/docs/mint.json
deleted file mode 100644
index ba9fa041..00000000
--- a/docs/mint.json
+++ /dev/null
@@ -1,52 +0,0 @@
-{
-  "$schema": "https://mintlify.com/schema.json",
-  "name": "Sencho",
-  "logo": {
-    "light": "",
-    "dark": ""
-  },
-  "favicon": "",
-  "colors": {
-    "primary": "#0F172A",
-    "light": "#3B82F6",
-    "dark": "#0F172A"
-  },
-  "navigation": [
-    {
-      "group": "Getting Started",
-      "pages": [
-        "getting-started/introduction",
-        "getting-started/quickstart",
-        "getting-started/configuration"
-      ]
-    },
-    {
-      "group": "Features",
-      "pages": [
-        "features/overview",
-        "features/dashboard",
-        "features/stack-management",
-        "features/editor",
-        "features/resources",
-        "features/app-store",
-        "features/global-observability",
-        "features/host-console",
-        "features/multi-node",
-        "features/alerts-notifications"
-      ]
-    },
-    {
-      "group": "Reference",
-      "pages": [
-        "reference/settings"
-      ]
-    },
-    {
-      "group": "Operations",
-      "pages": [
-        "operations/troubleshooting",
-        "operations/backup"
-      ]
-    }
-  ]
-}