Consolidate documentation to /content/docs

apps/site/source.config.ts

@@ -5,7 +5,7 @@ import { rehypeCodeDefaultOptions } from 'fumadocs-core/mdx-plugins';
 import { transformerTwoslash } from 'fumadocs-twoslash';
 
 export const { docs, meta } = defineDocs({
-  dir: 'content/docs',
+  dir: '../../content/docs',
 });
 
 export const blog = defineCollections({
@@ -27,10 +27,7 @@ export default defineConfig({
         light: 'github-light',
         dark: 'github-dark',
       },
-      transformers: [
-        ...(rehypeCodeDefaultOptions.transformers ?? []),
-        transformerTwoslash(),
-      ],
+      transformers: [...(rehypeCodeDefaultOptions.transformers ?? []), transformerTwoslash()],
     },
   },
 });

docs/adr/001-vitest-standardization.md → content/docs/adr/001-vitest-standardization.mdx

@@ -1,4 +1,7 @@
-# ADR-001: Standardize on Vitest for Test Framework
+---
+title: "ADR-001: Standardize on Vitest for Test Framework"
+---
+
 
 **Status:** Accepted
 **Date:** February 12, 2026

content/docs/adr/index.mdx

@@ -0,0 +1,11 @@
+---
+title: Architecture Decision Records
+---
+
+This section documents important architectural decisions made during the development of ObjectOS.
+
+Architecture Decision Records (ADRs) capture the context, options considered, and rationale behind key technical decisions.
+
+## Records
+
+- [ADR-001: Vitest Standardization](./001-vitest-standardization) - Decision to standardize on Vitest as the testing framework

content/docs/adr/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Architecture Decision Records",
+  "pages": ["index", "001-vitest-standardization"]
+}

docs/guide/api-reference.md → content/docs/guide/api-reference.mdx

@@ -1,4 +1,7 @@
-# 📡 API Reference
+---
+title: 📡 API Reference
+---
+
 
 This guide documents the ObjectOS REST API, GraphQL endpoint, and WebSocket interface. All endpoints are served by the ObjectStack Hono server and follow a consistent request/response contract.
 

docs/guide/cli-usage.md → content/docs/guide/cli-usage.mdx

@@ -1,4 +1,7 @@
-# ObjectStack CLI Usage Guide
+---
+title: ObjectStack CLI Usage Guide
+---
+
 
 This guide covers how to use the `@objectstack/cli` commands to develop and manage your ObjectOS applications.
 

apps/site/content/docs/guide/meta.json → content/docs/guide/meta.json

@@ -2,6 +2,7 @@
   "title": "Guide",
   "pages": [
     "index",
+    "quickstart",
     "architecture",
     "platform-components",
     "data-modeling",
@@ -10,7 +11,13 @@
     "logic-hooks",
     "logic-actions",
     "ui-framework",
+    "cli-usage",
+    "api-reference",
+    "plugin-development",
+    "migration-from-kernel",
+    "troubleshooting",
     "development-plan",
-    "contributing-development"
+    "contributing-development",
+    "technical-debt-resolution"
   ]
 }

docs/guide/migration-from-kernel.md → content/docs/guide/migration-from-kernel.mdx

@@ -1,4 +1,7 @@
-# Migration Guide: From Kernel/Server to Runtime
+---
+title: "Migration Guide: From Kernel/Server to Runtime"
+---
+
 
 This guide helps you migrate from the deprecated `@objectos/kernel` and `@objectos/server` packages to the new microkernel architecture using `@objectstack/runtime`.
 

docs/guide/plugin-development.md → content/docs/guide/plugin-development.mdx

@@ -1,4 +1,7 @@
-# Plugin Development Guide
+---
+title: Plugin Development Guide
+---
+
 
 This guide explains how to develop plugins for ObjectOS using the `@objectstack/runtime` microkernel.
 

docs/guide/quickstart.md → content/docs/guide/quickstart.mdx

@@ -1,4 +1,7 @@
-# 🚀 Quickstart Guide
+---
+title: 🚀 Quickstart Guide
+---
+
 
 Welcome to ObjectOS! This guide gets first-time contributors from zero to a running dev environment in minutes.
 

docs/guide/technical-debt-resolution.md → content/docs/guide/technical-debt-resolution.mdx

@@ -1,4 +1,7 @@
-# Technical Debt Resolution
+---
+title: Technical Debt Resolution
+---
+
 
 > **Version**: 1.0.0
 > **Date**: February 12, 2026

docs/guide/troubleshooting.md → content/docs/guide/troubleshooting.mdx

@@ -1,4 +1,7 @@
-# 🔧 Troubleshooting Guide
+---
+title: 🔧 Troubleshooting Guide
+---
+
 
 Common issues and solutions for developing in the ObjectOS monorepo. If you're stuck, start here before opening an issue.
 

apps/site/content/docs/index.mdx → content/docs/index.mdx

@@ -3,8 +3,6 @@ title: ObjectOS Documentation
 description: The Business Operating System - Orchestrate Identity, Workflows, and Local-First Sync in one unified runtime. The Kernel for your Enterprise.
 ---
 
-import { Card, Cards } from 'fumadocs-ui/components/card';
-
 ObjectOS is the **Business Operating System** for the ObjectStack ecosystem, providing:
 
 - 🛡️ **Identity & Governance** - Built-in RBAC, SSO (OIDC/SAML), and granular field-level security. Not just a login library, but a complete governance engine.
@@ -52,25 +50,6 @@ pnpm dev
 
 ## Next Steps
 
-<Cards>
-  <Card 
-    title="Getting Started" 
-    href="/docs/getting-started"
-  >
-    Get up and running with ObjectOS quickly
-  </Card>
-
-  <Card 
-    title="Architecture" 
-    href="/docs/guide/architecture"
-  >
-    Deep dive into the kernel design
-  </Card>
-
-  <Card 
-    title="Specifications" 
-    href="/docs/spec"
-  >
-    Learn about protocols and formats
-  </Card>
-</Cards>
+- [Getting Started](/docs/getting-started) - Get up and running with ObjectOS quickly
+- [Architecture](/docs/guide/architecture) - Deep dive into the kernel design  
+- [Specifications](/docs/spec) - Learn about protocols and formats

content/docs/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Documentation",
+  "pages": ["index", "getting-started", "guide", "spec", "adr"]
+}

content/docs/spec/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Specifications",
+  "pages": ["index", "metadata-format", "query-language", "http-protocol"]
+}