Add init command and update dev/build/start to use content/.objectdocs

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>

Author: Copilot

.gitignore

@@ -34,4 +34,7 @@ next-env.d.ts
 
 # fumadocs
 .source
-.next
+.next
+
+# objectdocs
+content/.objectdocs

examples/starter/.gitignore

@@ -34,3 +34,6 @@ pnpm-debug.log*
 # TypeScript
 *.tsbuildinfo
 next-env.d.ts
+
+# ObjectDocs
+content/.objectdocs

packages/cli/bin/cli.mjs

@@ -9,13 +9,15 @@
 
 import { cac } from 'cac';
 import 'dotenv/config';
+import { registerInitCommand } from '../src/commands/init.mjs';
 import { registerTranslateCommand } from '../src/commands/translate.mjs';
 import { registerDevCommand } from '../src/commands/dev.mjs';
 import { registerBuildCommand } from '../src/commands/build.mjs';
 import { registerStartCommand } from '../src/commands/start.mjs';
 
 const cli = cac('objectdocs');
 
+registerInitCommand(cli);
 registerTranslateCommand(cli);
 registerDevCommand(cli);
 registerBuildCommand(cli);

packages/cli/src/commands/build.mjs

@@ -23,13 +23,13 @@ export function registerBuildCommand(cli) {
       // 1. Resolve user's docs directory
       const docsDir = dir ? path.resolve(process.cwd(), dir) : path.resolve(process.cwd(), 'content/docs');
 
-      // 2. Resolve the Next.js App directory
-      let nextAppDir;
-      try {
-        nextAppDir = path.dirname(require.resolve('@objectdocs/site/package.json'));
-      } catch (e) {
-        // Fallback for local development
-         nextAppDir = path.resolve(__dirname, '../../../site');
+      // 2. Resolve the Next.js App directory - use local .objectdocs first
+      let nextAppDir = path.resolve(process.cwd(), 'content/.objectdocs');
+      
+      if (!fs.existsSync(nextAppDir)) {
+        console.log('⚠️  ObjectDocs site not found at content/.objectdocs');
+        console.log('   Run "objectdocs init" first to initialize the site.\n');
+        process.exit(1);
       }
 
       // Copy user config and assets to nextAppDir

packages/cli/src/commands/dev.mjs

@@ -24,13 +24,13 @@ export function registerDevCommand(cli) {
       // 1. Resolve user's docs directory (Absolute path)
       const docsDir = dir ? path.resolve(process.cwd(), dir) : path.resolve(process.cwd(), 'content/docs');
 
-      // 2. Resolve the Next.js App directory
-      let nextAppDir;
-      try {
-        nextAppDir = path.dirname(require.resolve('@objectdocs/site/package.json'));
-      } catch (e) {
-        // Fallback for local development
-         nextAppDir = path.resolve(__dirname, '../../../site');
+      // 2. Resolve the Next.js App directory - use local .objectdocs first
+      let nextAppDir = path.resolve(process.cwd(), 'content/.objectdocs');
+      
+      if (!fs.existsSync(nextAppDir)) {
+        console.log('⚠️  ObjectDocs site not found at content/.objectdocs');
+        console.log('   Run "objectdocs init" first to initialize the site.\n');
+        process.exit(1);
       }
 
       console.log(`Starting docs server...`);

packages/cli/src/commands/init.mjs

@@ -0,0 +1,89 @@
+/**
+ * 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 { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+
+export function registerInitCommand(cli) {
+  cli
+    .command('init', 'Initialize ObjectDocs site in content/.objectdocs')
+    .action(async (options) => {
+      console.log('Initializing ObjectDocs...\n');
+      
+      const targetDir = path.resolve(process.cwd(), 'content/.objectdocs');
+      
+      // Check if already initialized
+      if (fs.existsSync(targetDir)) {
+        console.log(`⚠️  ObjectDocs already initialized at ${targetDir}`);
+        console.log('   Delete the directory if you want to reinitialize.\n');
+        return;
+      }
+      
+      // Resolve the site package directory
+      let siteDir;
+      try {
+        siteDir = path.dirname(require.resolve('@objectdocs/site/package.json'));
+      } catch (e) {
+        // Fallback for local development
+        siteDir = path.resolve(__dirname, '../../../site');
+      }
+      
+      console.log(`📦 Copying site from: ${siteDir}`);
+      console.log(`📁 Target directory: ${targetDir}\n`);
+      
+      // Create target directory
+      fs.mkdirSync(targetDir, { recursive: true });
+      
+      // Copy site files to target directory
+      fs.cpSync(siteDir, targetDir, { 
+        recursive: true,
+        filter: (source) => {
+          const basename = path.basename(source);
+          // Skip node_modules, .next, and other build artifacts
+          if (basename === 'node_modules' || 
+              basename === '.next' || 
+              basename === 'out' ||
+              basename === '.turbo' ||
+              basename === 'dist') {
+            return false;
+          }
+          return true;
+        }
+      });
+      
+      console.log('✅ ObjectDocs site copied successfully!\n');
+      
+      // Install dependencies in the target directory
+      console.log('📦 Installing dependencies...\n');
+      
+      const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+      const installProcess = spawn(npmCmd, ['install'], {
+        cwd: targetDir,
+        stdio: 'inherit'
+      });
+      
+      installProcess.on('close', (code) => {
+        if (code === 0) {
+          console.log('\n✅ Dependencies installed successfully!');
+          console.log('\n🎉 ObjectDocs initialized! You can now run:');
+          console.log('   pnpm dev    - Start development server');
+          console.log('   pnpm build  - Build for production\n');
+        } else {
+          console.error('\n❌ Failed to install dependencies');
+          process.exit(code);
+        }
+      });
+    });
+}

packages/cli/src/commands/start.mjs

@@ -19,12 +19,13 @@ const require = createRequire(import.meta.url);
 export function registerStartCommand(cli) {
   cli.command('start [dir]', 'Start the production server')
     .action((dir) => {
-      // 1. Resolve Next.js App directory
-      let nextAppDir;
-      try {
-        nextAppDir = path.dirname(require.resolve('@objectdocs/site/package.json'));
-      } catch (e) {
-         nextAppDir = path.resolve(__dirname, '../../../site');
+      // 1. Resolve Next.js App directory - use local .objectdocs first
+      let nextAppDir = path.resolve(process.cwd(), 'content/.objectdocs');
+      
+      if (!fs.existsSync(nextAppDir)) {
+        console.log('⚠️  ObjectDocs site not found at content/.objectdocs');
+        console.log('   Run "objectdocs init" first to initialize the site.\n');
+        process.exit(1);
       }
 
       // 2. Check config