@objectdocs/site 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# @objectdocs/site
+
+## 0.2.1
+
+### Patch Changes
+
+- Bug fixes and improvements for ObjectDocs
+
+## 0.2.0
+
+### Minor Changes
+
+- Initial release of ObjectDocs - A modern documentation engine built on Next.js 14 and Fumadocs
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release of ObjectDocs
+
+  - Modern documentation engine built on Next.js 14 and Fumadocs
+  - Metadata-driven architecture with configuration as code
+  - Support for low-code component embedding
+  - Enterprise-grade UI with dark mode support
+  - Multi-product documentation support

package/README.md

@@ -0,0 +1,42 @@
+# @objectdocs/site
+
+The Next.js application foundation for the ObjectStack documentation.
+
+## Overview
+
+This package provides the actual Next.js application structure, configuration, and UI components used to render the documentation. It is designed to be encapsulated and run via the `@objectdocs/cli`.
+
+## Tech Stack
+
+- **Concepts**: Next.js 16 (App Router)
+- **Documentation**: Fumadocs
+- **Styling**: Tailwind CSS
+- **Deployment**: Static Export (`output: 'export'`)
+
+## Development
+
+Typically you won't run this package directly. Instead, you should use the CLI from the root workspace:
+
+```bash
+pnpm dev
+# or
+pnpm objectdocs dev
+```
+
+However, for internal development of the site theme or logic, you can run:
+
+```bash
+cd packages/site
+pnpm dev
+```
+
+## Structure
+
+- `app/`: Next.js App Router pages and layouts.
+- `lib/`: Utility functions (i18n, etc).
+- `source.config.ts`: Fumadocs configuration.
+- `next.config.mjs`: Next.js configuration (configured for static export).
+
+## Build output
+
+When built, the static assets are generated in the `out/` directory.

package/app/[lang]/docs/[[...slug]]/page.tsx

@@ -0,0 +1,84 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { source } from '@/lib/source';
+import type { Metadata } from 'next';
+import { DocsPage, DocsBody } from 'fumadocs-ui/page';
+import { notFound } from 'next/navigation';
+import { siteConfig } from '@/lib/site-config';
+import defaultComponents from 'fumadocs-ui/mdx';
+import { Callout } from 'fumadocs-ui/components/callout';
+import { Card, Cards } from 'fumadocs-ui/components/card';
+import { Steps, Step } from 'fumadocs-ui/components/steps';
+
+const components = {
+  ...defaultComponents,
+  Callout,
+  Card,
+  Cards,
+  Steps,
+  Step,
+};
+
+interface PageProps {
+  params: Promise<{
+    lang: string;
+    slug?: string[];
+  }>;
+}
+
+export default async function Page({ params }: PageProps) {
+  const { lang, slug = [] } = await params;
+  
+  const page = source.getPage(slug, lang);
+  
+  if (!page) {
+    notFound();
+  }
+
+  const MDX = page.data.body as any;
+
+  return (
+    <DocsPage 
+      toc={page.data.toc as any} 
+      full={page.data.full as any}
+      lastUpdate={siteConfig.page.showLastUpdate ? (page.data as any).lastModified : undefined}
+      tableOfContent={{
+        enabled: siteConfig.layout.toc.enabled,
+        style: siteConfig.layout.toc.depth > 2 ? 'clerk' : 'normal',
+      }}
+      editOnGithub={siteConfig.page.showEditLink ? {
+        owner: siteConfig.page.repoBaseUrl.split('/')[3],
+        repo: siteConfig.page.repoBaseUrl.split('/')[4],
+        sha: 'main', // Defaulting to main, could be extracted
+        path: siteConfig.page.repoBaseUrl.split('/').slice(7).join('/') // simplistic parsing
+      } : undefined}
+    >
+      <DocsBody>
+        <MDX components={components} />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { lang, slug = [] } = await params;
+  const page = source.getPage(slug, lang);
+
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}

package/app/[lang]/docs/layout.tsx

@@ -0,0 +1,61 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/app/layout.config';
+import { siteConfig } from '@/lib/site-config';
+
+export default async function Layout({
+  params,
+  children,
+}: {
+  params: Promise<{ lang: string }>;
+  children: ReactNode;
+}) {
+  const { lang } = await params;
+  
+  return (
+    <DocsLayout
+      tree={source.getPageTree(lang)}
+      {...baseOptions}
+      sidebar={{
+        enabled: siteConfig.layout.sidebar.enabled,
+        prefetch: siteConfig.layout.sidebar.prefetch,
+        collapsible: siteConfig.layout.sidebar.collapsible,
+        defaultOpenLevel: siteConfig.layout.sidebar.defaultOpenLevel,
+        footer: siteConfig.layout.sidebar.footer ? (
+           <div className="p-4 text-xs text-muted-foreground border-t">
+             {siteConfig.layout.sidebar.footer.html ? (
+                <div dangerouslySetInnerHTML={{ __html: siteConfig.layout.sidebar.footer.html }} />
+             ) : (
+                siteConfig.layout.sidebar.footer.text
+             )}
+           </div>
+        ) : undefined,
+        tabs: siteConfig.layout.sidebar.tabs && siteConfig.layout.sidebar.tabs.length > 0 ? 
+          siteConfig.layout.sidebar.tabs.map(tab => ({
+            title: tab.title,
+            url: tab.url,
+            description: tab.description,
+          })) : undefined,
+        banner: siteConfig.layout.sidebar.banner ? (
+          <div className="-mx-2 -mt-2 rounded-lg border bg-card p-4 transition-colors hover:bg-accent/50 text-card-foreground text-sm">
+            <a href={siteConfig.layout.sidebar.banner.url} className="block font-medium">
+              {siteConfig.layout.sidebar.banner.text}
+            </a>
+          </div>
+        ) : undefined
+      }}
+    >
+      {children}
+    </DocsLayout>
+  );
+}
+

package/app/[lang]/layout.tsx

@@ -0,0 +1,35 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import 'fumadocs-ui/style.css';
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import { defineI18nUI } from 'fumadocs-ui/i18n';
+import { i18n } from '@/lib/i18n';
+import { getTranslations } from '@/lib/translations';
+
+
+const { provider } = defineI18nUI(i18n, {
+  translations: getTranslations(),
+});
+
+export default async function Layout({ params, children }: LayoutProps<'/[lang]'>) {
+  const { lang } = await params;
+  return (
+    <html lang={lang} suppressHydrationWarning>
+      <body
+        style={{
+          display: 'flex',
+          flexDirection: 'column',
+          minHeight: '100vh',
+        }}
+      >
+        <RootProvider i18n={provider(lang)}>{children}</RootProvider>
+      </body>
+    </html>
+  );
+}

package/app/[lang]/page.tsx

@@ -0,0 +1,20 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { redirect, notFound } from 'next/navigation';
+
+
+export default async function LangPage({
+  params,
+}: {
+  params: Promise<{ lang: string }>;
+}) {
+  const { lang } = await params;
+
+  redirect(`/${lang}/docs`);
+}

package/app/api/search/route.ts

@@ -0,0 +1,20 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { source } from '@/lib/source';
+import { createSearchAPI } from 'fumadocs-core/search/server';
+
+export const { GET } = createSearchAPI('advanced', {
+  indexes: source.getPages().map((page) => ({
+    title: page.data.title,
+    description: page.data.description,
+    url: page.url,
+    id: page.url,
+    structuredData: page.data.structuredData,
+  })),
+});

package/app/layout.config.tsx

@@ -0,0 +1,49 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { type BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { siteConfig } from '@/lib/site-config';
+import Image from 'next/image';
+
+export const baseOptions: BaseLayoutProps = {
+  nav: {
+    title: (
+      <div className="flex items-center gap-2">
+        {siteConfig.branding.logo.light && (
+          <Image
+            src={siteConfig.branding.logo.light}
+            alt={siteConfig.branding.logo.text || 'Logo'}
+            width={30}
+            height={30}
+            className={siteConfig.branding.logo.dark ? 'dark:hidden' : ''}
+          />
+        )}
+        {siteConfig.branding.logo.dark && (
+          <Image
+            src={siteConfig.branding.logo.dark}
+            alt={siteConfig.branding.logo.text || 'Logo'}
+            width={30}
+            height={30}
+            className="hidden dark:block"
+          />
+        )}
+        <span className="font-bold">{siteConfig.branding.logo.text || 'ObjectStack'}</span>
+      </div>
+    ),
+    transparentMode: siteConfig.layout.navbar.transparentMode,
+  },
+  links: siteConfig.layout.navbar.links.map(link => ({
+    text: link.text,
+    url: link.url,
+    active: link.active || 'nested-url',
+    external: link.external,
+  })),
+  githubUrl: siteConfig.layout.navbar.socials.find(s => s.platform === 'github')?.url,
+  i18n: siteConfig.i18n.enabled,
+};
+

package/app/layout.tsx

@@ -0,0 +1,34 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import 'fumadocs-ui/style.css';
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import { defineI18nUI } from 'fumadocs-ui/i18n';
+import { i18n } from '@/lib/i18n';
+import { getTranslations } from '@/lib/translations';
+
+
+const { provider } = defineI18nUI(i18n, {
+  translations: getTranslations(),
+});
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body
+        style={{
+          display: 'flex',
+          flexDirection: 'column',
+          minHeight: '100vh',
+        }}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}

package/app/page.tsx

@@ -0,0 +1,19 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { redirect } from 'next/navigation';
+
+/**
+ * Root page - redirects are handled by proxy.ts middleware
+ * This page should never actually render as the middleware intercepts and redirects
+ * But Next.js requires a page component for the route to be recognized
+ */
+export default function RootPage() {
+  // Fallback redirect if middleware didn't handle it
+  redirect('/en/docs');
+}

package/docs.site.json

@@ -0,0 +1,69 @@
+{
+  "meta": {
+    "title": "ObjectDocs",
+    "description": "The Metadata-Driven Documentation Engine for the Low-Code Era.",
+    "url": "https://docs.objectstack.ai",
+    "favicon": "/favicon.ico"
+  },
+  "i18n": {
+    "enabled": true,
+    "defaultLanguage": "en",
+    "languages": ["en", "cn"
+    ]
+  },
+  "branding": {
+    "logo": {
+      "text": "ObjectDocs",
+      "light": "/logo.svg",
+      "dark": "/logo.svg"
+    },
+    "theme": {
+      "accentColor": "blue", 
+      "radius": "0.5rem"
+    }
+  },
+  "layout": {
+    "navbar": {
+      "enabled": true,
+      "transparentMode": "top",
+      "links": [
+        {
+          "text": "Home",
+          "url": "https://www.objectstack.ai",
+          "external": true
+        }
+      ],
+      "socials": [
+        { "platform": "github", "url": "https://github.com/objectstack-ai" }
+      ]
+    },
+    "sidebar": {
+      "enabled": true,
+      "prefetch": true,
+      "defaultOpenLevel": 1,
+      "collapsible": true,
+      "tabs": []
+    },
+    "toc": {
+      "enabled": true,
+      "depth": 3
+    },
+    "footer": {
+      "enabled": false,
+      "copyright": "© 2026 ObjectStack Inc."
+    }
+  },
+  "page": {
+    "showLastUpdate": true,
+    "showEditLink": true,
+    "repoBaseUrl": "https://github.com/objectstack-ai/objectdocs"
+  },
+  "content": {
+    "math": false,
+    "imageZoom": true,
+    "codeBlock": {
+      "theme": "vesper",
+      "showLineNumbers": true
+    }
+  }
+}

package/lib/deep-merge.ts

@@ -0,0 +1,31 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export function isObject(item: any): item is Record<string, any> {
+  return (item && typeof item === 'object' && !Array.isArray(item));
+}
+
+export function deepMerge<T extends Record<string, any>>(target: T, source: Record<string, any>): T {
+  const output = { ...target };
+  
+  if (isObject(target) && isObject(source)) {
+    Object.keys(source).forEach(key => {
+      if (isObject(source[key])) {
+        if (!(key in target)) {
+          Object.assign(output, { [key]: source[key] });
+        } else {
+          (output as any)[key] = deepMerge(target[key], source[key]);
+        }
+      } else {
+        Object.assign(output, { [key]: source[key] });
+      }
+    });
+  }
+  
+  return output;
+}

package/lib/i18n.ts

@@ -0,0 +1,16 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { siteConfig } from './site-config';
+import { defineI18n } from 'fumadocs-core/i18n';
+
+export const i18n = defineI18n({
+  defaultLanguage: siteConfig.i18n.defaultLanguage,
+  languages: siteConfig.i18n.languages,
+  parser: 'dot',  
+});

package/lib/site-config.ts

@@ -0,0 +1,154 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { deepMerge } from './deep-merge';
+import objectDocsConfig from '@/docs.site.json';
+
+export interface SiteConfig {
+  meta: {
+    title: string;
+    description: string;
+    url: string;
+    favicon: string;
+  };
+  i18n: {
+    enabled: boolean;
+    defaultLanguage: string;
+    languages: Array<string>;
+  };
+  build?: {
+    output?: 'export' | 'standalone' | undefined;
+  };
+  branding: {
+    logo: {
+      light?: string;
+      dark?: string;
+      text?: string;
+    };
+    theme: {
+      accentColor: string;
+      radius: string;
+    };
+  };
+  layout: {
+    navbar: {
+      enabled: boolean;
+      transparentMode?: 'none' | 'top' | 'always';
+      links: Array<{ 
+        text: string; 
+        url: string; 
+        active?: 'url' | 'nested-url';
+        external?: boolean; 
+      }>;
+      socials: Array<{ platform: string; url: string }>;
+    };
+    sidebar: {
+      enabled?: boolean;
+      defaultOpenLevel: number;
+      collapsible: boolean;
+      prefetch?: boolean;
+      banner?: {
+        text: string;
+        url: string;
+      };
+      footer?: {
+         text?: string;
+         html?: string;
+      };
+      tabs?: Array<{
+        title: string;
+        url: string;
+        description?: string;
+      }>;
+    };
+    toc: {
+      enabled: boolean;
+      depth: number;
+    };
+    footer: {
+      copyright: string;
+    };
+  };
+  page: {
+    showLastUpdate: boolean;
+    showEditLink: boolean;
+    repoBaseUrl: string;
+  };
+  content: {
+    math: boolean;
+    imageZoom: boolean;
+    codeBlock: {
+      theme: string;
+      showLineNumbers: boolean;
+    };
+  };
+}
+
+const defaultConfig: SiteConfig = {
+  meta: {
+    title: 'ObjectStack ',
+    description: 'Documentation',
+    url: 'https://objectstack.com',
+    favicon: '/favicon.ico',
+  },
+  i18n: {
+    enabled: true,
+    defaultLanguage: 'en',
+    languages: ["en", "cn"
+    ],
+  },
+  branding: {
+    logo: {
+      text: 'ObjectStack',
+    },
+    theme: {
+      accentColor: 'blue',
+      radius: '0.5rem',
+    },
+  },
+  layout: {
+    navbar: {
+      enabled: true,
+      transparentMode: 'top',
+      links: [],
+      socials: [],
+    },
+    sidebar: {
+      enabled: true,
+      defaultOpenLevel: 1,
+      collapsible: true,
+      prefetch: true,
+    },
+    toc: {
+      enabled: true,
+      depth: 3,
+    },
+    footer: {
+      copyright: '© 2026',
+    },
+  },
+  page: {
+    showLastUpdate: true,
+    showEditLink: true,
+    repoBaseUrl: '',
+  },
+  content: {
+    math: false,
+    imageZoom: true,
+    codeBlock: {
+      theme: 'vesper',
+      showLineNumbers: true,
+    },
+  },
+};
+
+export function getSiteConfig(): SiteConfig {
+  return deepMerge(defaultConfig, objectDocsConfig);
+}
+
+export const siteConfig = getSiteConfig();

package/lib/source.ts

@@ -0,0 +1,24 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { loader } from 'fumadocs-core/source';
+import { docs, meta } from '@/.source/server';
+import { toFumadocsSource } from 'fumadocs-mdx/runtime/server';
+import { i18n } from './i18n';
+
+const mainSource = toFumadocsSource(docs, meta);
+
+export const source = loader({
+  baseUrl: '/docs',
+  source: {
+    files: [
+      ...mainSource.files,
+    ],
+  },
+  i18n,
+});

package/lib/translations.ts

@@ -0,0 +1,110 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { siteConfig } from './site-config';
+
+/**
+ * Translation strings for different languages
+ * These are the UI strings used by fumadocs-ui
+ */
+interface LanguageTranslations {
+  displayName: string;
+  toc?: string;
+  search?: string;
+  lastUpdate?: string;
+  searchNoResult?: string;
+  previousPage?: string;
+  nextPage?: string;
+  chooseLanguage?: string;
+}
+
+/**
+ * Default translations for supported languages
+ * Add new language translations here as needed
+ */
+const defaultTranslations: Record<string, LanguageTranslations> = {
+  en: {
+    displayName: 'English',
+  },
+  cn: {
+    displayName: '简体中文',
+    toc: '目录',
+    search: '搜索文档',
+    lastUpdate: '最后更新于',
+    searchNoResult: '没有结果',
+    previousPage: '上一页',
+    nextPage: '下一页',
+    chooseLanguage: '选择语言',
+  },
+  ja: {
+    displayName: '日本語',
+    toc: '目次',
+    search: 'ドキュメントを検索',
+    lastUpdate: '最終更新',
+    searchNoResult: '結果がありません',
+    previousPage: '前のページ',
+    nextPage: '次のページ',
+    chooseLanguage: '言語を選択',
+  },
+  fr: {
+    displayName: 'Français',
+    toc: 'Table des matières',
+    search: 'Rechercher dans la documentation',
+    lastUpdate: 'Dernière mise à jour',
+    searchNoResult: 'Aucun résultat',
+    previousPage: 'Page précédente',
+    nextPage: 'Page suivante',
+    chooseLanguage: 'Choisir la langue',
+  },
+  de: {
+    displayName: 'Deutsch',
+    toc: 'Inhaltsverzeichnis',
+    search: 'Dokumentation durchsuchen',
+    lastUpdate: 'Zuletzt aktualisiert',
+    searchNoResult: 'Keine Ergebnisse',
+    previousPage: 'Vorherige Seite',
+    nextPage: 'Nächste Seite',
+    chooseLanguage: 'Sprache wählen',
+  },
+  es: {
+    displayName: 'Español',
+    toc: 'Tabla de contenidos',
+    search: 'Buscar documentación',
+    lastUpdate: 'Última actualización',
+    searchNoResult: 'Sin resultados',
+    previousPage: 'Página anterior',
+    nextPage: 'Página siguiente',
+    chooseLanguage: 'Elegir idioma',
+  },
+};
+
+/**
+ * Get translations for configured languages
+ * Returns only the translations for languages specified in docs.site.json
+ */
+export function getTranslations(): Record<string, LanguageTranslations> {
+  const configuredLanguages = siteConfig.i18n.languages;
+  const translations: Record<string, LanguageTranslations> = {};
+
+  for (const lang of configuredLanguages) {
+    if (defaultTranslations[lang]) {
+      translations[lang] = defaultTranslations[lang];
+    } else {
+      // If no translation exists for a configured language, provide a minimal fallback
+      // Only log warning in development
+      if (process.env.NODE_ENV === 'development') {
+        console.warn(`Warning: No translations found for language "${lang}". Using minimal fallback.`);
+      }
+      translations[lang] = {
+        displayName: lang.toUpperCase(),
+      };
+    }
+  }
+
+  return translations;
+}

package/mdx-components.tsx

@@ -0,0 +1,20 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import defaultComponents from 'fumadocs-ui/mdx';
+import type { MDXComponents } from 'mdx/types';
+import { Steps, Step } from 'fumadocs-ui/components/steps';
+
+export function useMDXComponents(components: MDXComponents): MDXComponents {
+  return {
+    ...defaultComponents,
+    Steps,
+    Step,
+    ...components,
+  };
+}

package/next.config.mjs

@@ -0,0 +1,20 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { createMDX } from 'fumadocs-mdx/next';
+
+const withMDX = createMDX();
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  distDir: '.next',
+  images: { unoptimized: true },
+};
+
+export default withMDX(nextConfig);

package/objectdocs.json

@@ -0,0 +1,69 @@
+{
+  "meta": {
+    "title": "ObjectStack Docs",
+    "description": "Enterprise-grade low-code platform documentation",
+    "url": "https://docs.objectstack.ai",
+    "favicon": "/favicon.ico"
+  },
+  "i18n": {
+    "enabled": true,
+    "defaultLanguage": "en",
+    "languages": ["en", "cn"
+    ]
+  },
+  "branding": {
+    "logo": {
+      "text": "ObjectStack",
+      "light": "/logo.svg",
+      "dark": "/logo.svg"
+    },
+    "theme": {
+      "accentColor": "blue", 
+      "radius": "0.5rem"
+    }
+  },
+  "layout": {
+    "navbar": {
+      "enabled": true,
+      "transparentMode": "top",
+      "links": [
+        {
+          "text": "Home",
+          "url": "https://www.objectstack.ai",
+          "external": true
+        }
+      ],
+      "socials": [
+        { "platform": "github", "url": "https://github.com/objectstack-ai/" }
+      ]
+    },
+    "sidebar": {
+      "enabled": true,
+      "prefetch": true,
+      "defaultOpenLevel": 1,
+      "collapsible": true,
+      "tabs": []
+    },
+    "toc": {
+      "enabled": true,
+      "depth": 3
+    },
+    "footer": {
+      "enabled": false,
+      "copyright": "© 2026 ObjectStack Inc."
+    }
+  },
+  "page": {
+    "showLastUpdate": true,
+    "showEditLink": true,
+    "repoBaseUrl": "https://github.com/objectstack-ai/docs"
+  },
+  "content": {
+    "math": false,
+    "imageZoom": true,
+    "codeBlock": {
+      "theme": "vesper",
+      "showLineNumbers": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@objectdocs/site",
+  "version": "0.2.1",
+  "dependencies": {
+    "@fumadocs/ui": "^16.4.7",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.0.8",
+    "@types/react": "^19.2.8",
+    "autoprefixer": "^10.4.23",
+    "client-only": "^0.0.1",
+    "dotenv": "^16.4.5",
+    "lucide-react": "^0.562.0",
+    "fumadocs-core": "^16.4.7",
+    "fumadocs-mdx": "^14.2.5",
+    "fumadocs-ui": "^16.4.7",
+    "next": "^16.1.2",
+    "openai": "^4.0.0",
+    "postcss": "^8.5.6",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "remark-directive": "^4.0.0",
+    "server-only": "^0.0.1",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "test": "echo \"No test specified\" && exit 0"
+  }
+}

package/proxy.ts

@@ -0,0 +1,44 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
+import { i18n } from '@/lib/i18n';
+import { NextResponse, NextRequest, NextFetchEvent } from 'next/server';
+
+// Create fumadocs middleware
+const fumadocsMiddleware = createI18nMiddleware(i18n);
+
+export default function proxy(request: NextRequest, event: NextFetchEvent) {
+  const path = request.nextUrl.pathname;
+  
+  // Handle root path separately with custom language detection
+  if (path === '/') {
+    const acceptLanguage = request.headers.get('accept-language') || '';
+    
+    // Simple language detection: check if zh is in Accept-Language
+    if (acceptLanguage.toLowerCase().includes('zh')) {
+      // Redirect to Chinese docs
+      const url = request.nextUrl.clone();
+      url.pathname = '/cn/docs';
+      return NextResponse.redirect(url);
+    } else {
+      // Redirect to default language (English)
+      const url = request.nextUrl.clone();
+      url.pathname = '/en/docs';
+      return NextResponse.redirect(url);
+    }
+  }
+  
+  // For all other paths, pass through to fumadocs middleware
+  return fumadocsMiddleware(request, event);
+}
+
+export const config = {
+  // Matcher ignoring `/_next/` and `/api/`
+  matcher: ['/((?!api|_next/static|_next/image|favicon.ico|logo.svg).*)'],
+};

package/public/logo.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" width="512" height="512">
+  <defs>
+    <linearGradient id="logo-gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#818cf8" />
+      <stop offset="100%" stop-color="#c084fc" />
+    </linearGradient>
+  </defs>
+  <path d="M12 22.5L2 17.5L12 12.5L22 17.5L12 22.5Z" fill="url(#logo-gradient)" fill-opacity="0.6" />
+  <path d="M12 17.5L2 12.5L12 7.5L22 12.5L12 17.5Z" fill="url(#logo-gradient)" fill-opacity="0.8" />
+  <path d="M12 12.5L2 7.5L12 2.5L22 7.5L12 12.5Z" fill="url(#logo-gradient)" fill-opacity="1" />
+</svg>

package/source.config.ts

@@ -0,0 +1,43 @@
+/**
+ * ObjectDocs
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { defineConfig, defineDocs } from 'fumadocs-mdx/config';
+import { siteConfig } from './lib/site-config';
+import path from 'node:path';
+import fs from 'node:fs';
+import remarkDirective from 'remark-directive';
+import { remarkDirectiveAdmonition } from 'fumadocs-core/mdx-plugins';
+
+function resolveContentDir(dir: string) {
+  if (process.env.DOCS_DIR && dir === 'content/docs') return process.env.DOCS_DIR;
+
+  // Try local first (Root deployment)
+  if (fs.existsSync(path.resolve(dir))) return dir;
+  
+  // Try parent (Monorepo/Vercel deployment where CWD is packages/site)
+  const parentDir = path.join('../..', dir);
+  if (fs.existsSync(path.resolve(parentDir))) return parentDir;
+
+  return dir;
+}
+
+const docsDir = resolveContentDir('content/docs');
+
+export const { docs, meta } = defineDocs({
+  dir: docsDir,
+});
+
+export default defineConfig({
+  mdxOptions: {
+    remarkPlugins: [remarkDirective, remarkDirectiveAdmonition],
+    rehypeCodeOptions: {
+      theme: siteConfig.content.codeBlock.theme,
+    }
+  }
+});
+

package/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
+    "target": "ES2017"
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "/Users/steedos/Documents/GitHub/docs/packages/site/.next/types/**/*.ts",
+    "/Users/steedos/Documents/GitHub/docs/packages/site/.next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}