diff --git a/.github/workflows/test-lifecycle.yml b/.github/workflows/test-lifecycle.yml
new file mode 100644
index 0000000..9ecd95f
--- /dev/null
+++ b/.github/workflows/test-lifecycle.yml
@@ -0,0 +1,75 @@
+name: Test ObjectDocs Lifecycle
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  test-quick:
+    name: Quick Build Test
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: '10.x'
+      
+      - name: Install dependencies
+        run: pnpm install
+      
+      - name: Run quick build test
+        run: pnpm test:quick
+      
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: quick-test-results
+          path: /tmp/objectdocs-*.log
+          retention-days: 7
+          if-no-files-found: ignore
+
+  test-full:
+    name: Full Lifecycle Test
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: '10.x'
+      
+      - name: Install dependencies
+        run: pnpm install
+      
+      - name: Run full lifecycle test
+        run: pnpm test:site
+      
+      - name: Upload server logs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: full-test-results
+          path: /tmp/objectdocs-*.log
+          retention-days: 7
+          if-no-files-found: ignore
diff --git a/.gitignore b/.gitignore
index 9727bcb..b7cd8b6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -37,4 +37,9 @@ next-env.d.ts
 .next
 
 # objectdocs
-content/.objectdocs
\ No newline at end of file
+content/.objectdocs
+
+# test artifacts
+/tmp/objectdocs-test-*
+/tmp/dev-server.log
+/tmp/start-server.log
\ No newline at end of file
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..75566da
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,46 @@
+# ObjectDocs Development Tasks
+# Run with: make <target> or pnpm run <script>
+
+.PHONY: help install dev build test test-quick test-full clean
+
+# Default target
+help:
+	@echo "ObjectDocs Development Tasks"
+	@echo ""
+	@echo "Available targets:"
+	@echo "  install     - Install all dependencies"
+	@echo "  dev         - Start development server"
+	@echo "  build       - Build the site"
+	@echo "  test        - Run all tests"
+	@echo "  test-quick  - Run quick build test"
+	@echo "  test-full   - Run full lifecycle test"
+	@echo "  clean       - Clean build artifacts"
+	@echo ""
+
+install:
+	pnpm install
+
+dev:
+	pnpm dev
+
+build:
+	pnpm build
+
+test: test-quick test-full
+
+test-quick:
+	@echo "Running quick build test..."
+	bash test-quick.sh
+
+test-full:
+	@echo "Running full lifecycle test..."
+	bash test-site.sh
+
+clean:
+	rm -rf node_modules
+	rm -rf .next
+	rm -rf content/.objectdocs
+	rm -rf packages/*/node_modules
+	rm -rf examples/*/node_modules
+	find . -name ".next" -type d -exec rm -rf {} + 2>/dev/null || true
+	find . -name "*.tsbuildinfo" -delete 2>/dev/null || true
diff --git a/README.md b/README.md
index 6f06663..3edf5e6 100644
--- a/README.md
+++ b/README.md
@@ -198,6 +198,20 @@ This repository is a monorepo managed by pnpm workspaces:
 
 - **[examples/starter](./examples/starter)**: A complete starter template demonstrating the recommended project structure. Includes comprehensive documentation on architecture, testing, and deployment guides. Ready for production use on Vercel and other platforms.
 
+## 🧪 Testing
+
+ObjectDocs includes comprehensive test scripts to validate the complete lifecycle:
+
+```bash
+# Quick build test (recommended for CI)
+pnpm test:quick
+
+# Full lifecycle test (includes server startup tests)
+pnpm test:site
+```
+
+See [TESTING.md](./TESTING.md) for detailed testing documentation.
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
diff --git a/TESTING.md b/TESTING.md
new file mode 100644
index 0000000..3775577
--- /dev/null
+++ b/TESTING.md
@@ -0,0 +1,329 @@
+# ObjectDocs Testing Guide
+
+This document describes how to test ObjectDocs across different scenarios and environments.
+
+## Test Scripts Overview
+
+ObjectDocs provides multiple test scripts to validate the complete lifecycle of documentation site creation, from initialization to production deployment.
+
+### Available Test Scripts
+
+#### 1. `test-site.sh` - Complete Lifecycle Test
+
+**Purpose**: Comprehensive end-to-end test covering the entire ObjectDocs workflow.
+
+**What it tests**:
+- ✅ Project initialization (`pnpm init`)
+- ✅ CLI installation (`@objectdocs/cli`)
+- ✅ ObjectDocs initialization (`objectdocs init`)
+- ✅ Content creation (MDX files, configuration)
+- ✅ Development server startup and accessibility
+- ✅ Production build compilation
+- ✅ Production server startup and accessibility
+
+**Usage**:
+```bash
+./test-site.sh
+```
+
+**Duration**: ~2-5 minutes (includes server startup tests)
+
+**Requirements**:
+- Node.js
+- pnpm
+- curl (for HTTP testing)
+- Available port 7777
+- `timeout` command (Linux) or `gtimeout` (macOS via homebrew: `brew install coreutils`)
+  - Note: Test will run without timeout protection if command is not available
+
+**Output**: Detailed step-by-step progress with color-coded success/failure indicators.
+
+#### 2. `test-quick.sh` - Quick Build Test
+
+**Purpose**: Fast CI/CD-friendly test that validates build process without running servers.
+
+**What it tests**:
+- ✅ Project initialization
+- ✅ CLI installation
+- ✅ ObjectDocs initialization
+- ✅ Content creation
+- ✅ Build compilation
+- ✅ Build output verification
+
+**Usage**:
+```bash
+./test-quick.sh
+```
+
+**Duration**: ~1-2 minutes
+
+**Requirements**:
+- Node.js
+- pnpm
+
+**Output**: Minimal output focused on build success.
+
+#### 3. `examples/starter/validate.sh` - Starter Template Validation
+
+**Purpose**: Validates the example starter template structure and configuration.
+
+**What it tests**:
+- ✅ package.json configuration
+- ✅ Content directory structure
+- ✅ Configuration files (docs.site.json, meta.json)
+- ✅ MDX frontmatter validity
+- ✅ Dependencies installation
+- ✅ Vercel configuration
+- ✅ .gitignore setup
+
+**Usage**:
+```bash
+cd examples/starter
+./validate.sh
+```
+
+**Duration**: < 10 seconds
+
+**Requirements**: None (static file validation only)
+
+## Testing Scenarios
+
+### 1. Local Development Testing
+
+When working on ObjectDocs itself:
+
+```bash
+# In the monorepo root
+pnpm install
+pnpm build
+
+# Run comprehensive test
+./test-site.sh
+```
+
+### 2. CI/CD Testing
+
+For automated testing in CI/CD pipelines:
+
+```bash
+# Quick test (recommended for CI)
+./test-quick.sh
+
+# Or full test if time permits
+./test-site.sh
+```
+
+Add to your CI configuration:
+```yaml
+# .github/workflows/test.yml
+- name: Run ObjectDocs tests
+  run: |
+    chmod +x ./test-quick.sh
+    ./test-quick.sh
+```
+
+### 3. Testing Standalone Installation
+
+To test as an end user would experience it (outside monorepo):
+
+```bash
+# Create a temporary directory
+mkdir /tmp/objectdocs-standalone-test
+cd /tmp/objectdocs-standalone-test
+
+# Initialize project
+pnpm init -y
+
+# Install CLI from npm (or local tarball)
+pnpm add -D @objectdocs/cli
+
+# Configure scripts
+cat > package.json << 'EOF'
+{
+  "name": "test-site",
+  "scripts": {
+    "dev": "objectdocs dev",
+    "build": "objectdocs build",
+    "start": "objectdocs start"
+  },
+  "devDependencies": {
+    "@objectdocs/cli": "latest"
+  }
+}
+EOF
+
+# Initialize ObjectDocs
+pnpm objectdocs init
+
+# Create content
+mkdir -p content/docs
+# ... add your content files
+
+# Test
+pnpm build
+pnpm start
+```
+
+### 4. Testing with npm pack
+
+For pre-release testing:
+
+```bash
+# In the monorepo
+cd packages/cli
+pnpm pack
+# Creates objectdocs-cli-X.X.X.tgz
+
+# In a test directory
+mkdir /tmp/test-tarball
+cd /tmp/test-tarball
+pnpm init -y
+pnpm add -D ../../packages/cli/objectdocs-cli-X.X.X.tgz
+
+# Continue with normal setup
+```
+
+## Manual Testing Checklist
+
+When preparing for a release, manually verify:
+
+### Development Workflow
+- [ ] `pnpm objectdocs init` creates `.objectdocs` directory
+- [ ] `pnpm dev` starts development server on port 7777
+- [ ] Hot reload works when editing MDX files
+- [ ] Hot reload works when editing `meta.json`
+- [ ] Hot reload works when editing `docs.site.json`
+
+### Build Process
+- [ ] `pnpm build` completes without errors
+- [ ] Build output is created in `content/.objectdocs/.next`
+- [ ] No TypeScript errors
+- [ ] No ESLint errors (if configured)
+
+### Production Server
+- [ ] `pnpm start` runs the production build
+- [ ] All pages are accessible
+- [ ] Navigation works correctly
+- [ ] Search functionality works (if enabled)
+- [ ] Dark mode toggle works
+
+### Content Features
+- [ ] MDX frontmatter is parsed correctly
+- [ ] Code blocks render with syntax highlighting
+- [ ] Callouts and custom components render
+- [ ] Internal links work
+- [ ] External links work
+- [ ] Images load correctly
+
+### Configuration
+- [ ] Branding (name, logo) appears correctly
+- [ ] Navigation links appear in header
+- [ ] Sidebar structure matches `meta.json`
+- [ ] SEO meta tags are generated
+
+## Troubleshooting
+
+### Common Test Failures
+
+#### "Port 7777 already in use"
+
+**Solution**:
+```bash
+# Kill any process using port 7777
+lsof -ti:7777 | xargs kill -9
+
+# Or use a different port
+PORT=8888 ./test-site.sh
+```
+
+#### "Build timeout"
+
+**Cause**: Build taking longer than 5 minutes.
+
+**Solution**: Increase `BUILD_TIMEOUT` in test script or check for build errors:
+```bash
+cd /tmp/objectdocs-test-*
+pnpm build
+```
+
+#### "Cannot find module '@objectdocs/site'"
+
+**Cause**: CLI not finding the site package.
+
+**Solution**: Ensure you've built the monorepo first:
+```bash
+cd /home/runner/work/objectdocs/objectdocs
+pnpm install
+pnpm build
+```
+
+#### "Dev server failed to start"
+
+**Cause**: Port conflict or build error.
+
+**Solution**: Check the server logs:
+```bash
+cat /tmp/dev-server.log
+```
+
+### Debug Mode
+
+Run tests with verbose output:
+
+```bash
+# Enable bash debug mode
+bash -x ./test-site.sh
+
+# Or add set -x to the script temporarily
+```
+
+## Test Coverage
+
+### What is Tested
+- ✅ CLI installation and initialization
+- ✅ Content creation workflow
+- ✅ Development server functionality
+- ✅ Production build process
+- ✅ Production server functionality
+- ✅ Configuration file validation
+- ✅ MDX file parsing
+
+### What is NOT Tested (Yet)
+- ⚠️ Translation features (`objectdocs translate`)
+- ⚠️ Interactive UI components
+- ⚠️ Search functionality
+- ⚠️ Browser-based E2E tests
+- ⚠️ Multiple language support
+- ⚠️ Theme customization
+
+## Contributing Test Improvements
+
+When adding new features to ObjectDocs, please:
+
+1. **Update test scripts** if the feature affects the core workflow
+2. **Add manual test steps** to this document
+3. **Document new configuration** that should be validated
+4. **Add edge cases** to the test suite
+
+### Adding a New Test Script
+
+1. Create the script in the root directory
+2. Make it executable: `chmod +x test-name.sh`
+3. Document it in this file
+4. Add it to CI configuration if appropriate
+
+### Test Script Standards
+
+All test scripts should:
+- Use `set -e` to exit on errors
+- Include color-coded output
+- Clean up temporary files on exit
+- Provide clear success/failure messages
+- Include a summary section
+- Be idempotent (can run multiple times safely)
+
+## References
+
+- [examples/starter/TESTING.md](./examples/starter/TESTING.md) - Standalone testing guide
+- [examples/starter/validate.sh](./examples/starter/validate.sh) - Template validation script
+- [README.md](./README.md) - Main project documentation
diff --git a/package.json b/package.json
index 62f784b..66f3b93 100644
--- a/package.json
+++ b/package.json
@@ -10,6 +10,8 @@
     "translate": "objectdocs translate",
     "translate:all": "objectdocs translate --all",
     "test": "pnpm -r test",
+    "test:site": "bash test-site.sh",
+    "test:quick": "bash test-quick.sh",
     "changeset": "changeset",
     "release": "changeset publish"
   },
diff --git a/test-quick.sh b/test-quick.sh
new file mode 100755
index 0000000..b6830f6
--- /dev/null
+++ b/test-quick.sh
@@ -0,0 +1,116 @@
+#!/bin/bash
+# Quick test script for CI/CD environments
+# Tests basic build functionality without running servers
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_section() {
+    echo ""
+    echo "================================================"
+    echo -e "${BLUE}$1${NC}"
+    echo "================================================"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+TEST_DIR=$(mktemp -d -t objectdocs-quick-test.XXXXXXXXXX)
+
+# Cleanup on exit
+cleanup() {
+    if [ -d "$TEST_DIR" ]; then
+        rm -rf "$TEST_DIR" 2>/dev/null || true
+    fi
+}
+trap cleanup EXIT
+
+main() {
+    print_section "ObjectDocs Quick Build Test"
+    
+    # Create test project
+    mkdir -p "$TEST_DIR"
+    cd "$TEST_DIR"
+    
+    echo "{}" > package.json
+    print_success "Initialized project"
+    
+    # Install CLI from workspace (detect monorepo root)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    MONOREPO_ROOT="${SCRIPT_DIR}"
+    
+    if [ -d "$MONOREPO_ROOT/packages/cli" ]; then
+        pnpm add -D "$MONOREPO_ROOT/packages/cli"
+        print_success "Installed @objectdocs/cli from local workspace"
+    else
+        # Fallback to npm if not in monorepo
+        pnpm add -D @objectdocs/cli
+        print_success "Installed @objectdocs/cli from npm"
+    fi
+    
+    # Configure scripts
+    pnpm pkg set scripts.build="objectdocs build"
+    
+    # Initialize ObjectDocs
+    pnpm objectdocs init
+    print_success "Initialized ObjectDocs"
+    
+    # Create minimal content
+    mkdir -p content/docs
+    
+    cat > content/docs.site.json << 'EOF'
+{
+  "branding": {
+    "name": "Test Site"
+  }
+}
+EOF
+    
+    cat > content/docs/meta.json << 'EOF'
+{
+  "pages": ["index"]
+}
+EOF
+    
+    cat > content/docs/index.mdx << 'EOF'
+---
+title: Test
+description: Test page
+---
+# Test Page
+EOF
+    
+    print_success "Created content"
+    
+    # Run build
+    print_section "Running Build"
+    if pnpm build; then
+        print_success "Build completed successfully"
+    else
+        print_error "Build failed"
+        exit 1
+    fi
+    
+    # Check build output
+    if [ -d "content/.objectdocs/.next" ] || [ -d ".next" ]; then
+        print_success "Build output exists"
+    else
+        print_error "Build output not found"
+        exit 1
+    fi
+    
+    print_section "Summary"
+    echo -e "${GREEN}✅ Quick build test passed!${NC}"
+}
+
+main "$@"
diff --git a/test-site.sh b/test-site.sh
new file mode 100755
index 0000000..b5336e8
--- /dev/null
+++ b/test-site.sh
@@ -0,0 +1,431 @@
+#!/bin/bash
+# ObjectDocs Site Testing Script
+# Tests the complete lifecycle: init -> create -> startup -> build -> run
+# 测试站点完整流程：初始化 -> 创建 -> 启动 -> 编译 -> 运行
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+TEST_DIR=$(mktemp -d -t objectdocs-test.XXXXXXXXXX)
+LOG_DIR=$(mktemp -d -t objectdocs-logs.XXXXXXXXXX)
+PORT="${PORT:-7777}"  # Allow override via environment variable
+BUILD_TIMEOUT="${BUILD_TIMEOUT:-300}"  # 5 minutes for build
+DEV_TIMEOUT="${DEV_TIMEOUT:-30}"       # 30 seconds for dev server to start
+
+# Cleanup function
+cleanup() {
+    echo ""
+    echo -e "${BLUE}Cleaning up...${NC}"
+    
+    # Kill any running dev/start servers (gracefully first, then forcefully)
+    if [ ! -z "$DEV_PID" ]; then
+        kill $DEV_PID 2>/dev/null || true
+        sleep 2
+        kill -9 $DEV_PID 2>/dev/null || true
+    fi
+    if [ ! -z "$START_PID" ]; then
+        kill $START_PID 2>/dev/null || true
+        sleep 2
+        kill -9 $START_PID 2>/dev/null || true
+    fi
+    
+    # Kill any process using the test port (gracefully)
+    if lsof -ti:$PORT >/dev/null 2>&1; then
+        lsof -ti:$PORT | xargs kill 2>/dev/null || true
+        sleep 1
+        if lsof -ti:$PORT >/dev/null 2>&1; then
+            lsof -ti:$PORT | xargs kill -9 2>/dev/null || true
+        fi
+    fi
+    
+    # Remove test directory (force recursive delete)
+    if [ -d "$TEST_DIR" ]; then
+        rm -rf "$TEST_DIR" 2>/dev/null || true
+    fi
+    
+    # Remove log directory
+    if [ -d "$LOG_DIR" ]; then
+        rm -rf "$LOG_DIR" 2>/dev/null || true
+    fi
+    
+    echo -e "${BLUE}Cleanup complete${NC}"
+}
+
+# Register cleanup on exit
+trap cleanup EXIT
+
+# Print section header
+print_section() {
+    echo ""
+    echo "================================================"
+    echo -e "${BLUE}$1${NC}"
+    echo "================================================"
+}
+
+# Print success message
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+# Print error message
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+# Print warning message
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+# Print info message
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+# Check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Wait for server to be ready
+wait_for_server() {
+    local port=$1
+    local timeout=$2
+    local elapsed=0
+    
+    print_info "Waiting for server on port $port (timeout: ${timeout}s)..."
+    
+    while [ $elapsed -lt $timeout ]; do
+        if curl -s http://localhost:$port > /dev/null 2>&1; then
+            return 0
+        fi
+        sleep 2
+        elapsed=$((elapsed + 2))
+    done
+    
+    return 1
+}
+
+# Main test script
+main() {
+    print_section "ObjectDocs Complete Lifecycle Test"
+    echo "Test directory: $TEST_DIR"
+    echo "Log directory: $LOG_DIR"
+    echo "Port: $PORT"
+    echo ""
+    
+    # Create log directory
+    mkdir -p "$LOG_DIR"
+    
+    # Check prerequisites
+    print_section "Step 0: Checking Prerequisites"
+    
+    if ! command_exists node; then
+        print_error "Node.js is not installed"
+        exit 1
+    fi
+    print_success "Node.js installed: $(node --version)"
+    
+    if ! command_exists pnpm; then
+        print_error "pnpm is not installed"
+        exit 1
+    fi
+    print_success "pnpm installed: $(pnpm --version)"
+    
+    if ! command_exists curl; then
+        print_error "curl is not installed"
+        exit 1
+    fi
+    print_success "curl installed"
+    
+    # Step 1: Create test directory and initialize project
+    print_section "Step 1: Initializing New Project"
+    
+    mkdir -p "$TEST_DIR"
+    cd "$TEST_DIR"
+    print_success "Created test directory: $TEST_DIR"
+    
+    # Initialize package.json
+    print_info "Creating package.json..."
+    echo "{}" > package.json
+    print_success "package.json created"
+    
+    # Install @objectdocs/cli as dev dependency
+    print_info "Installing @objectdocs/cli..."
+    
+    # Get the absolute path to the monorepo root (where script is located)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    MONOREPO_ROOT="${SCRIPT_DIR}"
+    
+    # Install CLI from workspace or npm
+    if [ -d "$MONOREPO_ROOT/packages/cli" ]; then
+        print_info "Installing CLI from local workspace..."
+        pnpm add -D "$MONOREPO_ROOT/packages/cli"
+        print_success "@objectdocs/cli installed from local workspace"
+    else
+        print_info "Installing CLI from npm..."
+        pnpm add -D @objectdocs/cli
+        print_success "@objectdocs/cli installed from npm"
+    fi
+    
+    # Step 2: Configure scripts
+    print_section "Step 2: Configuring Package Scripts"
+    
+    # Add scripts to package.json using pnpm pkg
+    pnpm pkg set scripts.dev="objectdocs dev"
+    pnpm pkg set scripts.build="objectdocs build"
+    pnpm pkg set scripts.start="objectdocs start"
+    
+    print_success "Scripts configured in package.json"
+    
+    # Step 3: Initialize ObjectDocs
+    print_section "Step 3: Running ObjectDocs Init"
+    
+    print_info "Running: pnpm objectdocs init"
+    if pnpm objectdocs init; then
+        print_success "ObjectDocs initialized successfully"
+    else
+        print_error "ObjectDocs init failed"
+        exit 1
+    fi
+    
+    # Verify init created necessary files
+    if [ -d "content/.objectdocs" ]; then
+        print_success "Site engine copied to content/.objectdocs"
+    else
+        print_warning "content/.objectdocs not found (might use different structure)"
+    fi
+    
+    # Step 4: Create content
+    print_section "Step 4: Creating Documentation Content"
+    
+    mkdir -p content/docs
+    print_success "Created content/docs directory"
+    
+    # Create docs.site.json
+    cat > content/docs.site.json << 'EOF'
+{
+  "branding": {
+    "name": "Test Site",
+    "description": "ObjectDocs Test Site"
+  },
+  "links": [
+    { "text": "Home", "url": "/" },
+    { "text": "Docs", "url": "/docs" }
+  ]
+}
+EOF
+    print_success "Created content/docs.site.json"
+    
+    # Create meta.json
+    cat > content/docs/meta.json << 'EOF'
+{
+  "title": "Documentation",
+  "pages": ["index", "getting-started"]
+}
+EOF
+    print_success "Created content/docs/meta.json"
+    
+    # Create index.mdx
+    cat > content/docs/index.mdx << 'EOF'
+---
+title: Welcome to ObjectDocs
+description: Getting started with ObjectDocs
+---
+
+# Welcome to ObjectDocs
+
+This is a test documentation site created to validate the ObjectDocs setup process.
+
+## Features
+
+- Fast and modern documentation engine
+- Built on Next.js 14
+- Powered by Fumadocs
+- Configuration as Code
+
+## Next Steps
+
+Check out the [Getting Started](/docs/getting-started) guide to learn more.
+EOF
+    print_success "Created content/docs/index.mdx"
+    
+    # Create getting-started.mdx
+    cat > content/docs/getting-started.mdx << 'EOF'
+---
+title: Getting Started
+description: Quick start guide for ObjectDocs
+---
+
+# Getting Started
+
+Welcome to the ObjectDocs quick start guide!
+
+## Installation
+
+```bash
+pnpm add -D @objectdocs/cli
+```
+
+## Usage
+
+Start the development server:
+
+```bash
+pnpm dev
+```
+
+Build for production:
+
+```bash
+pnpm build
+```
+
+Start production server:
+
+```bash
+pnpm start
+```
+EOF
+    print_success "Created content/docs/getting-started.mdx"
+    
+    # Step 5: Test development server
+    print_section "Step 5: Testing Development Server"
+    
+    print_info "Starting dev server..."
+    pnpm dev > "$LOG_DIR/dev-server.log" 2>&1 &
+    DEV_PID=$!
+    
+    if wait_for_server $PORT $DEV_TIMEOUT; then
+        print_success "Dev server started successfully on http://localhost:$PORT"
+        
+        # Test if we can fetch the homepage
+        if curl -s http://localhost:$PORT > /dev/null; then
+            print_success "Homepage is accessible"
+        else
+            print_warning "Homepage returned unexpected response"
+        fi
+        
+        # Test if we can fetch a docs page
+        if curl -s http://localhost:$PORT/docs > /dev/null; then
+            print_success "Docs page is accessible"
+        else
+            print_warning "Docs page returned unexpected response"
+        fi
+    else
+        print_error "Dev server failed to start within ${DEV_TIMEOUT}s"
+        print_info "Server log output:"
+        cat "$LOG_DIR/dev-server.log" || true
+        exit 1
+    fi
+    
+    # Stop dev server
+    print_info "Stopping dev server..."
+    kill $DEV_PID 2>/dev/null || true
+    sleep 2
+    kill -9 $DEV_PID 2>/dev/null || true
+    wait $DEV_PID 2>/dev/null || true
+    DEV_PID=""
+    sleep 2
+    print_success "Dev server stopped"
+    
+    # Step 6: Test build process
+    print_section "Step 6: Testing Build Process"
+    
+    print_info "Running build (this may take a few minutes)..."
+    
+    # Check if timeout command is available
+    if command_exists timeout; then
+        if timeout $BUILD_TIMEOUT pnpm build; then
+            print_success "Build completed successfully"
+        else
+            print_error "Build failed or timed out"
+            exit 1
+        fi
+    else
+        # Fallback without timeout (macOS compatibility)
+        print_warning "timeout command not available, running without timeout protection"
+        if pnpm build; then
+            print_success "Build completed successfully"
+        else
+            print_error "Build failed"
+            exit 1
+        fi
+    fi
+    
+    # Check if build output exists
+    if [ -d "content/.objectdocs/.next" ] || [ -d ".next" ]; then
+        print_success "Build output directory created"
+    else
+        print_warning "Build output directory not found in expected locations"
+    fi
+    
+    # Step 7: Test production server
+    print_section "Step 7: Testing Production Server"
+    
+    print_info "Starting production server..."
+    pnpm start > "$LOG_DIR/start-server.log" 2>&1 &
+    START_PID=$!
+    
+    if wait_for_server $PORT $DEV_TIMEOUT; then
+        print_success "Production server started successfully on http://localhost:$PORT"
+        
+        # Test if we can fetch the homepage
+        if curl -s http://localhost:$PORT > /dev/null; then
+            print_success "Production homepage is accessible"
+        else
+            print_warning "Production homepage returned unexpected response"
+        fi
+        
+        # Test if we can fetch a docs page
+        if curl -s http://localhost:$PORT/docs > /dev/null; then
+            print_success "Production docs page is accessible"
+        else
+            print_warning "Production docs page returned unexpected response"
+        fi
+    else
+        print_error "Production server failed to start within ${DEV_TIMEOUT}s"
+        print_info "Server log output:"
+        cat "$LOG_DIR/start-server.log" || true
+        exit 1
+    fi
+    
+    # Stop production server
+    print_info "Stopping production server..."
+    kill $START_PID 2>/dev/null || true
+    sleep 2
+    kill -9 $START_PID 2>/dev/null || true
+    wait $START_PID 2>/dev/null || true
+    START_PID=""
+    sleep 2
+    print_success "Production server stopped"
+    
+    # Final summary
+    print_section "Test Summary"
+    
+    echo ""
+    echo -e "${GREEN}✅ All tests passed successfully!${NC}"
+    echo ""
+    echo "Tested lifecycle stages:"
+    echo "  ✓ Project initialization (pnpm init)"
+    echo "  ✓ CLI installation (@objectdocs/cli)"
+    echo "  ✓ ObjectDocs initialization (objectdocs init)"
+    echo "  ✓ Content creation (MDX files, configuration)"
+    echo "  ✓ Development server (pnpm dev)"
+    echo "  ✓ Production build (pnpm build)"
+    echo "  ✓ Production server (pnpm start)"
+    echo ""
+    echo "Test directory: $TEST_DIR"
+    echo ""
+    print_info "Test directory will be cleaned up on exit"
+}
+
+# Run main function
+main "$@"