Add introduction page and enhance MDX component support

Added a new introduction page at content/docs/index.mdx describing ObjectDocs and its philosophy. Updated MDX rendering in page.tsx and mdx-components.tsx to support Card, Cards, and Callout components. Updated objectdocs.json branding and metadata to use 'ObjectDocs' instead of 'ObjectStack', fixed GitHub URL, and updated repoBaseUrl.

Author: hotlong

content/docs/index.mdx

@@ -0,0 +1,79 @@
+---
+title: Introduction
+description: The Metadata-Driven Documentation Engine for the Low-Code Era.
+---
+
+import { FileJson, Layers, Cpu, Zap } from 'lucide-react';
+
+# What is ObjectDocs?
+
+**ObjectDocs** is a modern, opinionated documentation site generator built on top of **Next.js 14** and **Fumadocs**.
+
+It was created to solve a specific problem in the **ObjectStack** ecosystem: *How do we document complex, multi-product low-code platforms without drowning in frontend maintenance?*
+
+Unlike general-purpose static site generators (SSGs), ObjectDocs treats documentation structure as **data**, not code.
+
+## Core Philosophy
+
+<Cards>
+  <Card
+    icon={<FileJson />}
+    title="Metadata-Driven"
+    href="/docs/getting-started/configuration"
+  >
+    Control sidebars, navigation, and page ordering entirely through local `meta.json` files. No React knowledge required for content updates.
+  </Card>
+  <Card
+    icon={<Cpu />}
+    title="ObjectUI Native"
+    href="/docs/components/objectui-embed"
+  >
+    First-class support for embedding **ObjectUI** JSON schemas directly into Markdown. Render live, interactive components powered by your ObjectQL definitions.
+  </Card>
+</Cards>
+
+## Why ObjectDocs?
+
+### 1. Separation of Concerns
+In traditional documentation sites, adding a new section often requires editing a global `sidebar.js` config or touching React components. In ObjectDocs, we strictly separate roles:
+
+* **Technical Writers**: Write `.mdx` content and manage local `meta.json` for sorting.
+* **Platform Architects**: Configure global `site.json` (branding, nav links).
+* **Frontend Developers**: Maintain the `app/` directory (layout, logic) only when strictly necessary.
+
+### 2. Multi-Product Architecture
+ObjectDocs is designed for monorepos that host multiple products (e.g., **ObjectQL**, **ObjectUI**, **ObjectOS**). It supports a "Root Toggle" mode that allows users to switch product contexts easily while staying on the same domain.
+
+### 3. Interactive by Default
+Static text isn't enough for low-code platforms. ObjectDocs allows you to mount live **ObjectUI** components directly in your docs to demonstrate protocol capabilities:
+
+```json title="example-objectui.json"
+{
+  "component": "ObjectGrid",
+  "props": {
+    "object": "contracts",
+    "columns": ["name", "amount", "status", "created_by"],
+    "filters": [
+      { "field": "status", "operator": "=", "value": "active" }
+    ]
+  }
+}
+
+```
+
+<Callout type="info">
+The actual rendering of the above JSON happens via our custom `ObjectUIRenderer` component. Check the [Components Guide](https://www.google.com/search?q=/docs/components) to learn more about schema validation and previewing.
+</Callout>
+
+## Next Steps
+
+Ready to build your documentation?
+
+<Cards>
+<Card title="Quick Start" href="/docs/getting-started/installation" icon={<Zap />}>
+Install ObjectDocs and create your first page in under 5 minutes.
+</Card>
+<Card title="Architecture" href="/docs/getting-started/architecture" icon={<Layers />}>
+Deep dive into the directory structure and data flow.
+</Card>
+</Cards>

packages/site/app/[lang]/docs/[[...slug]]/page.tsx

@@ -3,6 +3,10 @@ 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 { Steps, Step } from 'fumadocs-ui/components/steps';
+import { Card, Cards } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
 
 interface PageProps {
   params: Promise<{
@@ -39,7 +43,7 @@ export default async function Page({ params }: PageProps) {
       } : undefined}
     >
       <DocsBody>
-        <MDX />
+        <MDX components={{ ...defaultComponents, Steps, Step, Card, Cards, Callout }} />
       </DocsBody>
     </DocsPage>
   );

packages/site/mdx-components.tsx

@@ -1,12 +1,17 @@
 import defaultComponents from 'fumadocs-ui/mdx';
 import type { MDXComponents } from 'mdx/types';
 import { Steps, Step } from 'fumadocs-ui/components/steps';
+import { Card, Cards } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
 
 export function useMDXComponents(components: MDXComponents): MDXComponents {
   return {
     ...defaultComponents,
     Steps,
     Step,
+    Card,
+    Cards,
+    Callout,
     ...components,
   };
 }

packages/site/objectdocs.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "ObjectStack Docs",
+    "title": "ObjectDocs",
     "description": "Enterprise-grade low-code platform documentation",
     "url": "https://docs.objectstack.ai",
     "favicon": "/favicon.ico"
@@ -13,7 +13,7 @@
   },
   "branding": {
     "logo": {
-      "text": "ObjectStack",
+      "text": "ObjectDocs",
       "light": "/logo.svg",
       "dark": "/logo.svg"
     },
@@ -34,7 +34,7 @@
         }
       ],
       "socials": [
-        { "platform": "github", "url": "https://github.com/objectstack-ai/" }
+        { "platform": "github", "url": "https://github.com/objectstack-ai" }
       ]
     },
     "sidebar": {
@@ -56,7 +56,7 @@
   "page": {
     "showLastUpdate": true,
     "showEditLink": true,
-    "repoBaseUrl": "https://github.com/objectstack-ai/docs"
+    "repoBaseUrl": "https://github.com/objectstack-ai/objectdocs"
   },
   "content": {
     "math": false,