Restore apps/site directory - keep for documentation site

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

.github/workflows/check-links.yml

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

CONTRIBUTING.md

@@ -19,11 +19,13 @@ objectos/
 │   ├── kernel/          # @objectos/kernel - Core runtime engine
 │   ├── server/          # @objectos/server - NestJS HTTP server
 │   └── presets/         # @objectos/preset-* - Standard metadata
+├── apps/
+│   └── site/            # @objectos/site - Documentation site
 ├── examples/            # Example applications
 └── docs/                # VitePress documentation
 ```
 
-**Note**: The UI package (`@objectos/ui`) and applications (`apps/web`, `apps/site`) have been moved to separate repositories and are developed independently.
+**Note**: The UI package (`@objectos/ui`) has been moved to a separate repository and is developed independently.
 
 ### Package Responsibilities
 

apps/site/.gitignore

@@ -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/app/blog/[slug]/page.tsx

@@ -0,0 +1,59 @@
+import { blog } from '@/lib/source';
+import { notFound } from 'next/navigation';
+import { DocsBody } from 'fumadocs-ui/layouts/docs/page';
+import Link from 'next/link';
+import { ArrowLeft } from 'lucide-react';
+
+export default async function BlogPostPage({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const post = blog.find((post) => post.slug === slug);
+
+  if (!post) notFound();
+
+  // Handle MDX content retrieval safely
+  const MDX = (post as any).body;
+
+  return (
+    <main className="container max-w-3xl mx-auto py-12 px-4">
+      <Link 
+        href="/blog" 
+        className="inline-flex items-center gap-2 text-sm text-muted-foreground hover:text-foreground mb-8 transition-colors"
+      >
+        <ArrowLeft className="w-4 h-4" />
+        Back to Blog
+      </Link>
+
+      <article>
+        <header className="mb-8 space-y-4">
+          <h1 className="text-4xl font-bold tracking-tight">{(post as any).title}</h1>
+          <div className="flex items-center gap-4 text-sm text-muted-foreground">
+            {(post as any).date && (
+               <time dateTime={new Date((post as any).date).toISOString()}>
+                  {new Date((post as any).date).toLocaleDateString('en-US', {
+                      year: 'numeric',
+                      month: 'long',
+                      day: 'numeric',
+                  })}
+              </time>
+            )}
+            {(post as any).author && <span>• By {(post as any).author}</span>}
+          </div>
+        </header>
+        
+        <DocsBody className="text-foreground">
+          {MDX ? <MDX /> : <p>No content found</p>}
+        </DocsBody>
+      </article>
+    </main>
+  );
+}
+
+export function generateStaticParams() {
+    return blog.map((post) => ({
+        slug: post.slug,
+    }));
+}

apps/site/app/blog/layout.tsx

@@ -0,0 +1,11 @@
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+import { baseOptions } from '../layout.config';
+import type { ReactNode } from 'react';
+
+export default function BlogLayout({ children }: { children: ReactNode }) {
+  return (
+    <HomeLayout {...baseOptions}>
+      {children}
+    </HomeLayout>
+  );
+}

apps/site/app/blog/page.tsx

@@ -0,0 +1,58 @@
+import Link from 'next/link';
+import { blog } from '@/lib/source';
+
+export default function BlogIndex() {
+  const posts = [...blog].sort((a, b) => {
+    const dateA = (a as any).date;
+    const dateB = (b as any).date;
+    if (!dateA || !dateB) return 0;
+    return new Date(dateB).getTime() - new Date(dateA).getTime();
+  });
+
+  return (
+    <main className="container max-w-4xl mx-auto py-12 px-4">
+      <div className="flex flex-col gap-8">
+        <div className="space-y-4">
+          <h1 className="text-4xl font-bold tracking-tight">Blog</h1>
+          <p className="text-muted-foreground text-lg">
+            Latest updates and insights from the ObjectOS team.
+          </p>
+        </div>
+
+        <div className="grid gap-8">
+          {posts.map((post) => (
+            <Link
+              key={post.url}
+              href={post.url}
+              className="flex flex-col gap-2 p-6 rounded-xl border border-border hover:bg-muted/50 transition-colors"
+            >
+              <h2 className="text-2xl font-bold">{(post as any).title}</h2>
+              {(post as any).description && (
+                <p className="text-muted-foreground">{(post as any).description}</p>
+              )}
+              <div className="flex items-center gap-4 text-sm text-muted-foreground mt-2">
+                {(post as any).date && (
+                  timeElement((post as any).date)
+                )}
+                {(post as any).author && <span>By {(post as any).author}</span>}
+              </div>
+            </Link>
+          ))}
+        </div>
+      </div>
+    </main>
+  );
+}
+
+function timeElement(date: string | Date) {
+    const d = new Date(date);
+    return (
+        <time dateTime={d.toISOString()}>
+            {d.toLocaleDateString('en-US', {
+                year: 'numeric',
+                month: 'long',
+                day: 'numeric',
+            })}
+        </time>
+    )
+}

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

@@ -0,0 +1,63 @@
+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;
+  const githubPath = params.slug 
+    ? `apps/site/content/docs/${params.slug.join('/')}.mdx`
+    : 'apps/site/content/docs/index.mdx';
+
+  return (
+    <DocsPage 
+      toc={(page.data as any).toc ?? []}
+      full={false}
+      footer={{
+        children: (
+          <a
+            href={`https://github.com/objectstack-ai/objectos/blob/main/${githubPath}`}
+            target="_blank"
+            rel="noreferrer noopener"
+            className="inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
+          >
+            <svg className="size-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+            </svg>
+            Edit this page on GitHub
+          </a>
+        ),
+      }}
+    >
+      <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/layout.tsx

@@ -0,0 +1,21 @@
+import { docs } from '../../.source/server';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { pageTree } from '@/lib/page-tree';
+import { baseOptions } from '../layout.config';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout
+      tree={pageTree}
+      {...baseOptions}
+      sidebar={{
+        collapsible: true,
+        defaultOpenLevel: 0,
+      }}
+    >
+      {children}
+    </DocsLayout>
+  );
+}
+

apps/site/app/global.css

@@ -0,0 +1,72 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/style.css';
+@import 'fumadocs-twoslash/twoslash.css';
+
+@theme {
+  /* Colors - using CSS custom properties */
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-destructive-foreground: hsl(var(--destructive-foreground));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+}
+
+@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%;
+  }
+}