fix: view as markdown

Author: NathanWalker

.vitepress/config.mts

@@ -60,6 +60,8 @@ export default defineConfig({
         title: 'NativeScript',
         description:
           'NativeScript empowers you to access native platform APIs from JavaScript directly. Develop iOS, Android and visionOS apps with TypeScript, Angular, Vue, React, Svelte or Solid.',
+        // also emit /index.md for the home page (default skips it)
+        excludeIndexPage: false,
       }),
     ],
   },

.vitepress/theme/CopyPageButton.vue

@@ -11,7 +11,15 @@ const open = ref(false)
 const copied = ref(false)
 const root = ref<HTMLElement | null>(null)
 
-const mdPath = computed(() => '/' + page.value.relativePath)
+// mirrors the vitepress-plugin-llms output layout: "dir/index.md" twins are
+// written to "/dir.md"; the root "index.md" keeps its name
+const mdPath = computed(() => {
+  const rel = '/' + page.value.relativePath
+  if (rel !== '/index.md' && rel.endsWith('/index.md')) {
+    return rel.slice(0, -'/index.md'.length) + '.md'
+  }
+  return rel
+})
 const mdUrl = computed(() => SITE_ORIGIN + mdPath.value)
 
 const chatGptUrl = computed(

functions/mcp.ts

@@ -171,14 +171,13 @@ async function getPage(context: any, path: string) {
     clean = clean.replace(/\/$/, '') || '/index'
     clean += '.md'
   }
-  // root index special case
-  if (clean === '/.md') clean = '/index.md'
-
-  let res = await fetchAsset(context, clean)
-  if (!res.ok && clean.endsWith('.md')) {
-    // pages like /api/namespaces/Utils/ map to index.md in their directory
-    res = await fetchAsset(context, clean.replace(/\.md$/, '/index.md'))
+  // markdown twins follow the vitepress-plugin-llms layout:
+  // "dir/index.md" is written to "/dir.md"; the root "index.md" keeps its name
+  if (clean !== '/index.md' && clean.endsWith('/index.md')) {
+    clean = clean.slice(0, -'/index.md'.length) + '.md'
   }
+
+  const res = await fetchAsset(context, clean)
   if (!res.ok) {
     return textContent(
       `Page not found: ${clean}. Use search_docs or get_sitemap to find valid paths.`,

tools/smoke/smoke.mjs

@@ -95,6 +95,8 @@ report(
   '/api/classes/Button.md is raw markdown'
 )
 await checkPage('/guide/ai.md', ['MCP'])
+await checkPage('/index.md', ['NativeScript'])
+await checkPage('/guide/publishing.md', ['Publishing'])
 
 // ---- llms.txt + API index ----
 await checkPage('/llms.txt', ['# NativeScript', 'Table of Contents'])