Merge pull request #85 from objectstack-ai/copilot/update-documentation-site-to-fumadocs

Author: hotlong

.github/workflows/check-links.yml

@@ -6,11 +6,11 @@ on:
       - main
     paths:
       - '**/*.md'
-      - 'docs/**/*'
+      - 'apps/site/content/**/*.mdx'
   pull_request:
     paths:
       - '**/*.md'
-      - 'docs/**/*'
+      - 'apps/site/content/**/*.mdx'
   schedule:
     # Run weekly on Sundays at 00:00 UTC
     - cron: '0 0 * * 0'
@@ -25,7 +25,7 @@ jobs:
       - name: Check links in Markdown files
         uses: lycheeverse/lychee-action@v2
         with:
-          args: --verbose --no-progress '**/*.md' 'docs/**/*.md'
+          args: --verbose --no-progress '**/*.md' 'apps/site/content/**/*.mdx'
           fail: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pr-title-check.yml

@@ -0,0 +1,37 @@
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+.env
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# fumadocs
+.source

apps/site/.gitignore

@@ -0,0 +1,45 @@
+import { source } from '@/lib/source';
+import { DocsBody, DocsPage } from 'fumadocs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import type { Metadata } from 'next';
+
+export default async function Page(props: {
+  params: Promise<{ slug?: string[] }>;
+}) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+
+  if (!page) notFound();
+
+  const MDX = (page.data as any)._exports?.default || (page.data as any).exports?.default;
+
+  return (
+    <DocsPage 
+      toc={(page.data as any).toc ?? []}
+      full={false}
+    >
+      <DocsBody>
+        <h1>{page.data.title}</h1>
+        {MDX && <MDX />}
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(props: {
+  params: Promise<{ slug?: string[] }>;
+}): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description ?? '',
+  };
+}

apps/site/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,24 @@
+import { docs } from '../../.source/server';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { pageTree } from '@/lib/page-tree';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout
+      tree={pageTree}
+      nav={{
+        title: 'ObjectOS',
+        url: '/',
+      }}
+      links={[
+        {
+          text: 'GitHub',
+          url: 'https://github.com/objectstack-ai/objectos',
+        },
+      ]}
+    >
+      {children}
+    </DocsLayout>
+  );
+}

apps/site/app/docs/layout.tsx

@@ -0,0 +1,49 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    --background: 0 0% 100%;
+    --foreground: 222.2 84% 4.9%;
+    --card: 0 0% 100%;
+    --card-foreground: 222.2 84% 4.9%;
+    --popover: 0 0% 100%;
+    --popover-foreground: 222.2 84% 4.9%;
+    --primary: 222.2 47.4% 11.2%;
+    --primary-foreground: 210 40% 98%;
+    --secondary: 210 40% 96.1%;
+    --secondary-foreground: 222.2 47.4% 11.2%;
+    --muted: 210 40% 96.1%;
+    --muted-foreground: 215.4 16.3% 46.9%;
+    --accent: 210 40% 96.1%;
+    --accent-foreground: 222.2 47.4% 11.2%;
+    --destructive: 0 84.2% 60.2%;
+    --destructive-foreground: 210 40% 98%;
+    --border: 214.3 31.8% 91.4%;
+    --input: 214.3 31.8% 91.4%;
+    --ring: 222.2 84% 4.9%;
+  }
+ 
+  .dark {
+    --background: 222.2 84% 4.9%;
+    --foreground: 210 40% 98%;
+    --card: 222.2 84% 4.9%;
+    --card-foreground: 210 40% 98%;
+    --popover: 222.2 84% 4.9%;
+    --popover-foreground: 210 40% 98%;
+    --primary: 210 40% 98%;
+    --primary-foreground: 222.2 47.4% 11.2%;
+    --secondary: 217.2 32.6% 17.5%;
+    --secondary-foreground: 210 40% 98%;
+    --muted: 217.2 32.6% 17.5%;
+    --muted-foreground: 215 20.2% 65.1%;
+    --accent: 217.2 32.6% 17.5%;
+    --accent-foreground: 210 40% 98%;
+    --destructive: 0 62.8% 30.6%;
+    --destructive-foreground: 210 40% 98%;
+    --border: 217.2 32.6% 17.5%;
+    --input: 217.2 32.6% 17.5%;
+    --ring: 212.7 26.8% 83.9%;
+  }
+}

apps/site/app/global.css

@@ -0,0 +1,26 @@
+import './global.css';
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import { Inter } from 'next/font/google';
+import type { ReactNode } from 'react';
+
+const inter = Inter({
+  subsets: ['latin'],
+});
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en" className={inter.className} suppressHydrationWarning>
+      <body>
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  );
+}
+
+export const metadata = {
+  title: {
+    default: 'ObjectOS',
+    template: '%s | ObjectOS',
+  },
+  description: 'The Business Operating System - Orchestrate Identity, Workflows, and Local-First Sync',
+};

apps/site/app/layout.tsx

@@ -0,0 +1,34 @@
+import Link from 'next/link';
+
+export default function HomePage() {
+  return (
+    <main className="flex flex-col items-center justify-center min-h-screen p-8 bg-gradient-to-b from-background to-muted/20">
+      <div className="max-w-4xl mx-auto text-center space-y-8">
+        <h1 className="text-6xl font-bold tracking-tight">
+          Object<span className="text-primary">OS</span>
+        </h1>
+        <p className="text-2xl text-muted-foreground font-medium">
+          The Business Operating System
+        </p>
+        <p className="text-xl text-muted-foreground max-w-2xl mx-auto">
+          Orchestrate Identity, Workflows, and Local-First Sync in one unified runtime. 
+          The Kernel for your Enterprise.
+        </p>
+        <div className="flex gap-4 justify-center pt-8">
+          <Link
+            href="/docs"
+            className="px-8 py-3 rounded-lg bg-primary text-primary-foreground font-semibold hover:bg-primary/90 transition-colors"
+          >
+            Get Started
+          </Link>
+          <Link
+            href="/docs/guide/architecture"
+            className="px-8 py-3 rounded-lg border border-border font-semibold hover:bg-accent transition-colors"
+          >
+            Architecture
+          </Link>
+        </div>
+      </div>
+    </main>
+  );
+}

apps/site/app/page.tsx

@@ -0,0 +1,30 @@
+---
+title: Getting Started
+description: Get started with ObjectOS
+---
+
+# Getting Started with ObjectOS
+
+Welcome to ObjectOS! This guide will help you get up and running quickly.
+
+## What is ObjectOS?
+
+ObjectOS is the **Business Operating System** for the ObjectStack ecosystem. It provides:
+
+- **Centralized State Management**
+- **Identity and Access Control** 
+- **Workflow Automation**
+- **Plugin Architecture**
+- **Offline-First Synchronization**
+
+## Prerequisites
+
+Before you begin, ensure you have:
+
+- Node.js 18+ installed
+- pnpm package manager
+- Basic understanding of TypeScript
+
+## Next Steps
+
+Continue to [Installation](/getting-started/installation) to set up your development environment.