prod deployment

.gitignore

@@ -71,5 +71,8 @@ coverage/
 .jest/
 
 ._*.mdx
+._*.md
+._*.json
 ._*.ts
+._*.tsx
 out/

app/docs/[[...slug]]/page.tsx → app/[[...slug]]/page.tsx

@@ -1,12 +1,15 @@
 import type { Metadata } from 'next';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
 import { DocsPage, DocsBody } from 'fumadocs-ui/page';
 import { notFound } from 'next/navigation';
 import { source } from '@/lib/source';
 import { generatePageMetadata, getCanonicalUrl } from '@/lib/seo-utils';
-import { CustomNavbar } from '@/lib/components/CustomNavbar';
 import { getFinalPageTitle } from '@/lib/h1-extractor';
 import { readFile } from 'fs/promises';
 import { getMDXComponents } from '@/mdx-components';
+import { homeOptions, docsOptions } from '../layout.config';
+import { docs } from '@/.source/index';
 
 export default async function Page({
   params,
@@ -22,18 +25,56 @@ export default async function Page({
 
   const MDX = page.data.body;
 
+  // Determine if this is the root page (no sidebar needed)
+  const isRootPage = !slug || slug.length === 0;
+
+  // Use HomeLayout for root page (no sidebar), DocsLayout for all other pages
+  if (isRootPage) {
+    return (
+      <HomeLayout {...homeOptions}>
+        <div className="container max-w-6xl mx-auto px-4 py-8">
+          <article className="prose prose-neutral dark:prose-invert max-w-none">
+            <MDX components={getMDXComponents()} />
+          </article>
+        </div>
+      </HomeLayout>
+    );
+  }
+
   return (
-    <DocsPage toc={page.data.toc} full={page.data.full}>
-      <CustomNavbar />
-      <DocsBody>
-        <MDX components={getMDXComponents()} />
-      </DocsBody>
-    </DocsPage>
+    <DocsLayout
+      {...docsOptions}
+      tree={source.pageTree}
+      nav={{
+        title: 'DeployStack Docs',
+        url: '/',
+      }}
+      sidebar={{
+        defaultOpenLevel: 1
+      }}
+    >
+      <DocsPage toc={page.data.toc} full={page.data.full}>
+        <DocsBody>
+          <MDX components={getMDXComponents()} />
+        </DocsBody>
+      </DocsPage>
+    </DocsLayout>
   );
 }
 
 export async function generateStaticParams() {
-  return source.generateParams();
+  const params = source.generateParams();
+
+  const result = [
+    ...params,
+    ...docs.docs
+      .filter((page: any) => page._file.flattenedPath)
+      .map((page: any) => ({
+        slug: page._file.flattenedPath.split('/'),
+      })),
+  ];
+
+  return result;
 }
 
 export async function generateMetadata({

app/layout.config.tsx

@@ -1,12 +1,47 @@
 import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
 
-export const baseOptions: BaseLayoutProps = {
-  // Navigation bar configuration (now handled by CustomNavbar)
+// Base configuration shared between both layouts
+const baseConfig = {
   nav: {
     title: 'DeployStack Docs',
-    url: '/docs',
+    url: '/',
   },
-
-  // GitHub repository for edit links
   githubUrl: 'https://github.com/deploystackio/documentation',
 };
+
+// Configuration for the home page (root URL) with all links visible
+export const homeOptions: BaseLayoutProps = {
+  ...baseConfig,
+  links: [
+    {
+      text: 'MCP Server',
+      url: 'https://deploystack.io/mcp',
+      external: true,
+    },
+    {
+      text: 'Changelog',
+      url: 'https://deploystack.io/changelog',
+      external: true,
+    },
+    {
+      type: 'custom',
+      secondary: true,
+      children: (
+        <a
+          href="https://cloud.deploystack.io/login"
+          target="_blank"
+          rel="noopener noreferrer"
+          className="text-slate-100 bg-slate-800 border border-slate-700 ml-1.5 focus:outline-none hover:bg-slate-900 hover:text-slate-50 focus:ring-4 focus:ring-gray-100 font-medium rounded-full text-sm px-5 py-2 me-2 dark:bg-gray-800 dark:text-white dark:border-gray-600 dark:hover:bg-gray-700 dark:hover:border-gray-600 dark:focus:ring-gray-700 transition-colors"
+        >
+          Login
+        </a>
+      ),
+    },
+  ],
+};
+
+export const docsOptions: BaseLayoutProps = {
+  ...baseConfig
+};
+
+export const baseOptions = docsOptions;

app/sitemap.ts

@@ -0,0 +1,30 @@
+import { MetadataRoute } from 'next';
+import { source } from '@/lib/source';
+
+export const dynamic = 'force-static';
+
+function getPages(tree: any): any[] {
+  const pages: any[] = [];
+
+  function traverse(nodes: any[]) {
+    for (const node of nodes) {
+      if (node.type === 'page') {
+        pages.push(node);
+      } else if ('children' in node) {
+        traverse(node.children);
+      }
+    }
+  }
+
+  traverse(tree.children);
+  return pages;
+}
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const pages = getPages(source.pageTree).map((page) => ({
+    url: new URL(page.url, 'https://docs.deploystack.io').toString(),
+    lastModified: page.lastModified,
+  }));
+
+  return pages;
+}

check-links.js

@@ -25,19 +25,35 @@ const extractLinks = (content) => {
 
 // Check if a local file exists
 const checkLocalFile = (linkPath, filePath) => {
-    if (linkPath.startsWith('/docs/')) {
+    // Check for internal links (starting with / but not external URLs)
+    if (linkPath.startsWith('/') && !linkPath.startsWith('//') && !linkPath.startsWith('http')) {
         // Remove hash fragment before checking file existence
         const [baseUrl] = linkPath.split('#');
-        const localPath = path.join(process.cwd(), baseUrl);
 
-        try {
-            fs.accessSync(localPath, fs.constants.F_OK);
-            console.log(`  ✅ ${linkPath}`);
-            return true;
-        } catch (err) {
-            console.log(`  ❌ ${linkPath} → File not found`);
-            return false;
+        // Map the URL to the actual file location
+        // Since our URLs are now root-level but files are in docs/
+        const actualFilePath = path.join(process.cwd(), 'docs', baseUrl.substring(1));
+
+        // Try both .mdx and .md extensions
+        const possiblePaths = [
+            actualFilePath + '.mdx',
+            actualFilePath + '.md',
+            path.join(actualFilePath, 'index.mdx'),
+            path.join(actualFilePath, 'index.md')
+        ];
+
+        for (const possiblePath of possiblePaths) {
+            try {
+                fs.accessSync(possiblePath, fs.constants.F_OK);
+                console.log(`  ✅ ${linkPath}`);
+                return true;
+            } catch (err) {
+                // Continue to next possible path
+            }
         }
+
+        console.log(`  ❌ ${linkPath} → File not found (checked: ${possiblePaths.map(p => path.relative(process.cwd(), p)).join(', ')})`);
+        return false;
     }
     return null; // not a local file
 };
@@ -79,7 +95,8 @@ const processFile = async (filePath) => {
 
     let allValid = true;
     for (const link of links) {
-        if (link.url.startsWith('/docs/')) {
+        if (link.url.startsWith('/') && !link.url.startsWith('//') && !link.url.startsWith('http')) {
+            // Internal link (root-level)
             const isValid = checkLocalFile(link.url, filePath);
             if (!isValid) allValid = false;
         } else if (link.url.startsWith('http')) {
@@ -109,7 +126,7 @@ const processDirectory = async (dir) => {
         if (stat.isDirectory()) {
             const isValid = await processDirectory(filePath);
             if (!isValid) allValid = false;
-        } else if (file.endsWith('.md')) {
+        } else if (file.endsWith('.md') || file.endsWith('.mdx')) {
             const isValid = await processFile(filePath);
             if (!isValid) allValid = false;
         }