client-handover 1.0.6 → 1.1.0

package/README.md

@@ -200,6 +200,12 @@ client-handover/
 
 ## Changelog
 
+### 1.1.0
+- Complete CLI redesign: all section commands replaced with a single `handover /create` command
+- Now generates two separate documents per run — a technical handover (for the incoming developer) and a non-technical client guide (for the business owner)
+- First-run developer info prompt — saves your name, company, email, and phone to config so every document is personalised
+- CSS colour detection — automatically extracts hex colours and CSS custom properties from `.css`, `.scss`, `.less` files and Tailwind config
+
 ### 1.0.6
 - Auto-scans your actual project files on every run — reads package.json, config files, env variable keys, deploy configs, folder structure, and more
 - Generated documents are now tailored to your real project, not generic templates

package/cli.js

@@ -1,73 +1,103 @@
 #!/usr/bin/env node
 
-import { setup } from './setup.js'
-import { deploy } from './deploy.js'
-import { credentials } from './credentials.js'
-import { handover } from './handover.js'
-import { license } from './license.js'
-import { generateDoc, saveApiKey } from './generator.js'
+import { generateDoc, loadDeveloperInfo, saveApiKey } from './generator.js'
+import { technicalHandoverPrompt, nonTechnicalHandoverPrompt } from './prompts.js'
 import { scanProject } from './scanner.js'
 import chalk from 'chalk'
+import readline from 'readline'
 import fs from 'fs'
 import path from 'path'
-
-const COMMANDS = {
-  'setup':       { fn: setup,       label: 'Project Setup & Dependencies' },
-  'deploy':      { fn: deploy,      label: 'Deployment & Hosting' },
-  'credentials': { fn: credentials, label: 'Credentials & Access' },
-  'handover':    { fn: handover,    label: 'Full Handover Document' },
-  'license':     { fn: license,     label: 'Licensing & Attribution' },
-}
+import os from 'os'
 
 function normalizeCommand(cmd) {
-  // Git Bash converts /handover → C:\Program Files\Git\handover before Node sees it
-  // path.basename extracts just the last segment regardless of what form it arrives in
   return path.basename(cmd).replace(/^\/+/, '')
 }
 
 function printHelp() {
-  console.log(chalk.bold('\n🚀 handover-cli — Frontend Website Handover - by Scott AK (sabrkei)\n'))
+  console.log(chalk.bold('\n handover — Website Handover Document Generator\n'))
   console.log(chalk.dim('Usage:'))
-  console.log('  handover <command> [project-info-file] [output-name]\n')
-  console.log(chalk.dim('Commands:'))
-  Object.entries(COMMANDS).forEach(([cmd, { label }]) => {
-    console.log(`  ${chalk.cyan(cmd.padEnd(16))} ${label}`)
-  })
-  console.log(`  ${chalk.cyan('all'.padEnd(16))} All sections in a single folder`)
-  console.log(`  ${chalk.cyan('key <api-key>'.padEnd(16))} Save your Anthropic API key (one-time setup)`)
-  console.log('\n' + chalk.dim('Examples:'))
-  console.log('  handover handover                               # Full doc with placeholders')
-  console.log('  handover setup project-info.txt                # Setup section using your notes')
-  console.log('  handover handover project-info.txt my-client   # Full doc, custom filename')
-  console.log('  handover all project-info.txt acme-client      # Every section in output/acme-client/')
+  console.log('  handover /create       Generate technical & non-technical handover documents')
+  console.log('  handover key <key>     Save your Anthropic API key\n')
+  console.log(chalk.dim('Example:'))
+  console.log('  cd my-client-project')
+  console.log('  handover /create\n')
+}
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, answer => resolve(answer.trim())))
+}
+
+async function ensureDeveloperInfo() {
+  const configDir = path.join(os.homedir(), '.handover')
+  const configPath = path.join(configDir, 'config.json')
+
+  let config = {}
+  try {
+    if (fs.existsSync(configPath)) config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+  } catch {}
+
+  if (config.developerName) {
+    return {
+      name: config.developerName,
+      company: config.developerCompany || '',
+      email: config.developerEmail || '',
+      phone: config.developerPhone || '',
+    }
+  }
+
+  console.log(chalk.bold('\n Your developer details will appear in the handover documents.\n'))
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  const name = await ask(rl, ' Your full name: ')
+  const company = await ask(rl, ' Your company name (or press Enter if not applicable): ')
+  const email = await ask(rl, ' Your email address: ')
+  const phone = await ask(rl, ' Your phone number (optional): ')
+  rl.close()
+
+  if (name) config.developerName = name
+  if (company) config.developerCompany = company
+  if (email) config.developerEmail = email
+  if (phone) config.developerPhone = phone
+
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
   console.log()
+
+  return { name: name || '', company: company || '', email: email || '', phone: phone || '' }
 }
 
-async function runAll(projectInfo, folderName, outputName) {
-  const sections = [
-    { key: 'handover',     fn: handover,     label: 'Full Handover Document' },
-    { key: 'setup',        fn: setup,        label: 'Project Setup & Dependencies' },
-    { key: 'deploy',       fn: deploy,       label: 'Deployment & Hosting' },
-    { key: 'credentials',  fn: credentials,  label: 'Credentials & Access' },
-    { key: 'license',      fn: license,      label: 'Licensing & Attribution' },
-  ]
+async function runCreate() {
+  const developerInfo = await ensureDeveloperInfo()
 
-  const outputDir = `./output/${folderName}`
+  console.log(chalk.dim(' Scanning project files...'))
+  const projectInfo = scanProject(process.cwd())
 
-  console.log(chalk.bold(`\n📁 Generating all sections into: ${outputDir}\n`))
+  const techDir = './technical-handover'
+  const clientDir = './handover'
 
-  for (const section of sections) {
-    console.log(chalk.bold(`📝 Generating: ${section.label}`))
-    const prompt = section.fn(projectInfo)
-    await generateDoc(prompt, section.key, outputDir)
-    console.log()
-  }
+  console.log(chalk.bold('\n Generating Technical Handover Document...'))
+  const techPrompt = technicalHandoverPrompt(projectInfo, developerInfo)
+  await generateDoc(techPrompt, 'technical-handover', techDir)
+
+  console.log(chalk.bold('\n Generating Client Handover Document...'))
+  const nonTechPrompt = nonTechnicalHandoverPrompt(projectInfo, developerInfo)
+  await generateDoc(nonTechPrompt, 'handover', clientDir)
 
-  console.log(chalk.green.bold(`✅ All sections saved to ${outputDir}\n`))
+  console.log(chalk.green.bold('\n ✅ Handover documents created successfully!\n'))
+  console.log(`   ${chalk.cyan('./technical-handover/')}`)
+  console.log(`     technical-handover.md`)
+  console.log(`     technical-handover.txt`)
+  console.log(`     technical-handover.docx`)
+  console.log()
+  console.log(`   ${chalk.cyan('./handover/')}`)
+  console.log(`     handover.md`)
+  console.log(`     handover.txt`)
+  console.log(`     handover.docx`)
+  console.log()
 }
 
 async function main() {
-  const [,, rawCommand, infoFile, outputName] = process.argv
+  const [,, rawCommand, secondArg] = process.argv
 
   if (!rawCommand || rawCommand === '--help' || rawCommand === '-h') {
     printHelp()
@@ -77,68 +107,28 @@ async function main() {
   const command = normalizeCommand(rawCommand)
 
   if (command === 'key') {
-    const key = infoFile // second arg is the key
-    if (!key) {
-      console.error(chalk.red('\n❌ Usage: handover key <your-api-key>\n'))
+    if (!secondArg) {
+      console.error(chalk.red('\n ❌ Usage: handover key <your-api-key>\n'))
       process.exit(1)
     }
-    saveApiKey(key)
-    console.log(chalk.green('\n✅ API key saved. You\'re all set — run any handover command.\n'))
+    saveApiKey(secondArg)
+    console.log(chalk.green('\n ✅ API key saved. Run "handover /create" to get started.\n'))
     process.exit(0)
   }
 
-  // Scan the current project directory
-  console.log(chalk.dim('\n🔍 Scanning project...'))
-  const scannedContext = scanProject(process.cwd())
-
-  // Read optional extra project info file
-  let extraInfo = ''
-  if (infoFile) {
-    if (!fs.existsSync(infoFile)) {
-      console.error(chalk.red(`\n❌ File not found: ${infoFile}\n`))
-      process.exit(1)
-    }
-    extraInfo = fs.readFileSync(infoFile, 'utf-8')
-    console.log(chalk.green(`📄 Loaded extra info from: ${infoFile}`))
-  }
-
-  const projectInfo = [scannedContext, extraInfo].filter(Boolean).join('\n\n---\n\n')
-
-  if (command === 'all') {
-    const folderName = outputName || 'all'
-    try {
-      await runAll(projectInfo, folderName)
-    } catch (err) {
-      if (err.status === 401) {
-        console.error(chalk.red('\n❌ Authentication failed. Set ANTHROPIC_API_KEY or install Claude Code.\n'))
-      } else {
-        console.error(chalk.red(`\n❌ Error: ${err.message}\n`))
-      }
-      process.exit(1)
-    }
-    return
-  }
-
-  const entry = COMMANDS[command]
-  if (!entry) {
-    console.error(chalk.red(`\n❌ Unknown command: ${rawCommand}\n`))
+  if (command !== 'create') {
+    console.error(chalk.red(`\n ❌ Unknown command: ${rawCommand}\n`))
     printHelp()
     process.exit(1)
   }
 
-  const docName = outputName || command
-  const prompt = entry.fn(projectInfo)
-
-  console.log(chalk.bold(`\n📝 Generating: ${entry.label}`))
-  console.log(chalk.dim(`   Output: ./output/${docName}.{md,txt,html}\n`))
-
   try {
-    await generateDoc(prompt, docName, './output')
+    await runCreate()
   } catch (err) {
     if (err.status === 401) {
-      console.error(chalk.red('\n❌ Authentication failed. Set ANTHROPIC_API_KEY or install Claude Code.\n'))
+      console.error(chalk.red('\n ❌ Authentication failed. Run "handover key <your-api-key>" to set your API key.\n'))
     } else {
-      console.error(chalk.red(`\n❌ Error: ${err.message}\n`))
+      console.error(chalk.red(`\n ❌ Error: ${err.message}\n`))
     }
     process.exit(1)
   }

package/generator.js

@@ -1,5 +1,9 @@
 import Anthropic from '@anthropic-ai/sdk'
-import { marked } from 'marked'
+import {
+  Document, Packer, Paragraph, TextRun, HeadingLevel,
+  AlignmentType, BorderStyle, TableRow, TableCell, Table,
+  WidthType, ShadingType
+} from 'docx'
 import fs from 'fs'
 import path from 'path'
 import os from 'os'
@@ -7,15 +11,12 @@ import os from 'os'
 function resolveApiKey() {
   if (process.env.ANTHROPIC_API_KEY) return process.env.ANTHROPIC_API_KEY
 
-  // Check saved key from `handover key <your-key>`
   const configPath = path.join(os.homedir(), '.handover', 'config.json')
   if (fs.existsSync(configPath)) {
     try {
       const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
       if (config?.apiKey) return config.apiKey
-    } catch {
-      // ignore malformed config file
-    }
+    } catch {}
   }
 
   const credentialsPath = path.join(os.homedir(), '.claude', '.credentials.json')
@@ -24,42 +25,293 @@ function resolveApiKey() {
       const creds = JSON.parse(fs.readFileSync(credentialsPath, 'utf-8'))
       const token = creds?.claudeAiOauth?.accessToken
       const expiresAt = creds?.claudeAiOauth?.expiresAt
-      if (token && (!expiresAt || expiresAt > Date.now())) {
-        return token
-      }
-    } catch {
-      // ignore malformed credentials file
-    }
+      if (token && (!expiresAt || expiresAt > Date.now())) return token
+    } catch {}
   }
 
   return null
 }
 
+export function loadDeveloperInfo() {
+  const configPath = path.join(os.homedir(), '.handover', 'config.json')
+  try {
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+      return {
+        name: config.developerName || '',
+        company: config.developerCompany || '',
+        email: config.developerEmail || '',
+        phone: config.developerPhone || '',
+      }
+    }
+  } catch {}
+  return { name: '', company: '', email: '', phone: '' }
+}
+
 export function saveApiKey(key) {
   const configDir = path.join(os.homedir(), '.handover')
   const configPath = path.join(configDir, 'config.json')
   if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
-  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
+  let config = {}
+  try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')) } catch {}
+  config.apiKey = key
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
 }
 
 const apiKey = resolveApiKey()
 if (!apiKey) {
-  console.error('\n❌ No API key found. Set ANTHROPIC_API_KEY or install Claude Code (code.visualstudio.com/download).\n')
+  console.error('\n❌ No API key found. Run "handover key <your-api-key>" or install Claude Code.\n')
   process.exit(1)
 }
 
 const client = new Anthropic({ apiKey })
 
-/**
- * Generate a handover document using the Claude API
- * @param {string} prompt - The command prompt to send
- * @param {string} outputName - Base filename (without extension)
- * @param {string} outputDir - Directory to save files
- */
+// ---------------------------------------------------------------------------
+// Inline text parser — splits a line into TextRun segments handling **bold**,
+// *italic*, `code`, and [link text](url) → just the text
+// ---------------------------------------------------------------------------
+function parseInline(text) {
+  const runs = []
+  // Strip markdown links to plain text
+  text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+
+  const pattern = /(\*\*(.+?)\*\*|\*(.+?)\*|`(.+?)`)/g
+  let lastIndex = 0
+  let match
+
+  while ((match = pattern.exec(text)) !== null) {
+    if (match.index > lastIndex) {
+      runs.push(new TextRun({ text: text.slice(lastIndex, match.index) }))
+    }
+    if (match[2] !== undefined) {
+      runs.push(new TextRun({ text: match[2], bold: true }))
+    } else if (match[3] !== undefined) {
+      runs.push(new TextRun({ text: match[3], italics: true }))
+    } else if (match[4] !== undefined) {
+      runs.push(new TextRun({
+        text: match[4],
+        font: 'Courier New',
+        size: 18,
+        shading: { type: ShadingType.CLEAR, fill: 'F4F4F4' },
+      }))
+    }
+    lastIndex = match.index + match[0].length
+  }
+
+  if (lastIndex < text.length) {
+    runs.push(new TextRun({ text: text.slice(lastIndex) }))
+  }
+
+  return runs.length ? runs : [new TextRun({ text })]
+}
+
+// ---------------------------------------------------------------------------
+// Convert markdown string to an array of docx Paragraph/Table objects
+// ---------------------------------------------------------------------------
+function markdownToDocxChildren(markdown) {
+  const children = []
+  const lines = markdown.split('\n')
+  let i = 0
+
+  while (i < lines.length) {
+    const line = lines[i]
+
+    // Fenced code block
+    if (line.trim().startsWith('```')) {
+      const codeLines = []
+      i++
+      while (i < lines.length && !lines[i].trim().startsWith('```')) {
+        codeLines.push(lines[i])
+        i++
+      }
+      for (const codeLine of codeLines) {
+        children.push(new Paragraph({
+          children: [new TextRun({ text: codeLine || ' ', font: 'Courier New', size: 18 })],
+          shading: { type: ShadingType.CLEAR, fill: 'F4F4F4' },
+          spacing: { before: 0, after: 0 },
+          indent: { left: 360 },
+        }))
+      }
+      // Add small gap after code block
+      children.push(new Paragraph({ text: '' }))
+      i++
+      continue
+    }
+
+    // Horizontal rule
+    if (/^---+$/.test(line.trim())) {
+      children.push(new Paragraph({
+        text: '',
+        border: { bottom: { style: BorderStyle.SINGLE, size: 6, color: 'CCCCCC' } },
+        spacing: { before: 200, after: 200 },
+      }))
+      i++
+      continue
+    }
+
+    // Headings
+    const h1 = line.match(/^# (.+)/)
+    const h2 = line.match(/^## (.+)/)
+    const h3 = line.match(/^### (.+)/)
+    const h4 = line.match(/^#{4,6} (.+)/)
+
+    if (h1) {
+      children.push(new Paragraph({
+        children: parseInline(h1[1]),
+        heading: HeadingLevel.HEADING_1,
+        spacing: { before: 400, after: 160 },
+      }))
+      i++; continue
+    }
+    if (h2) {
+      children.push(new Paragraph({
+        children: parseInline(h2[1]),
+        heading: HeadingLevel.HEADING_2,
+        spacing: { before: 320, after: 120 },
+      }))
+      i++; continue
+    }
+    if (h3) {
+      children.push(new Paragraph({
+        children: parseInline(h3[1]),
+        heading: HeadingLevel.HEADING_3,
+        spacing: { before: 240, after: 80 },
+      }))
+      i++; continue
+    }
+    if (h4) {
+      children.push(new Paragraph({
+        children: [new TextRun({ text: h4[1], bold: true })],
+        spacing: { before: 160, after: 80 },
+      }))
+      i++; continue
+    }
+
+    // Checkbox list items  - [ ] or - [x]
+    const checkbox = line.match(/^(\s*)- \[(x| )\] (.+)/i)
+    if (checkbox) {
+      const checked = checkbox[2].toLowerCase() === 'x'
+      children.push(new Paragraph({
+        children: [
+          new TextRun({ text: checked ? '☑ ' : '☐ ' }),
+          ...parseInline(checkbox[3]),
+        ],
+        indent: { left: 360 },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Bullet list items  - or *
+    const bullet = line.match(/^(\s*)[-*+] (.+)/)
+    if (bullet) {
+      const indent = bullet[1].length > 0 ? 720 : 360
+      children.push(new Paragraph({
+        children: [new TextRun({ text: '• ' }), ...parseInline(bullet[2])],
+        indent: { left: indent },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Numbered list items
+    const numbered = line.match(/^\d+\. (.+)/)
+    if (numbered) {
+      children.push(new Paragraph({
+        children: parseInline(numbered[1]),
+        numbering: { reference: 'default-numbering', level: 0 },
+        indent: { left: 360 },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Bold-only line (often used as a label/key line like **Key:** value)
+    // Handled by parseInline already — fall through to normal paragraph
+
+    // Empty line
+    if (line.trim() === '') {
+      children.push(new Paragraph({ text: '', spacing: { before: 0, after: 80 } }))
+      i++; continue
+    }
+
+    // Normal paragraph
+    children.push(new Paragraph({
+      children: parseInline(line),
+      spacing: { before: 0, after: 80 },
+    }))
+    i++
+  }
+
+  return children
+}
+
+// ---------------------------------------------------------------------------
+// Build a docx Document from markdown
+// ---------------------------------------------------------------------------
+function buildDocx(markdown) {
+  const children = markdownToDocxChildren(markdown)
+
+  return new Document({
+    numbering: {
+      config: [{
+        reference: 'default-numbering',
+        levels: [{
+          level: 0,
+          format: 'decimal',
+          text: '%1.',
+          alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 360, hanging: 260 } } },
+        }],
+      }],
+    },
+    styles: {
+      default: {
+        document: {
+          run: { font: 'Calibri', size: 22 },
+          paragraph: { spacing: { line: 276 } },
+        },
+      },
+      paragraphStyles: [
+        {
+          id: 'Heading1',
+          name: 'Heading 1',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 36, color: '1a1a1a' },
+          paragraph: { spacing: { before: 400, after: 160 } },
+        },
+        {
+          id: 'Heading2',
+          name: 'Heading 2',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 28, color: '2c2c2c' },
+          paragraph: {
+            spacing: { before: 320, after: 120 },
+            border: { bottom: { style: BorderStyle.SINGLE, size: 4, color: 'E0E0E0' } },
+          },
+        },
+        {
+          id: 'Heading3',
+          name: 'Heading 3',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 24, color: '444444' },
+          paragraph: { spacing: { before: 240, after: 80 } },
+        },
+      ],
+    },
+    sections: [{ properties: {}, children }],
+  })
+}
+
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
 export async function generateDoc(prompt, outputName = 'handover', outputDir = './output') {
   console.log('⏳ Generating document with Claude...\n')
 
-  // Call Claude API
   const message = await client.messages.create({
     model: 'claude-sonnet-4-20250514',
     max_tokens: 4096,
@@ -68,105 +320,38 @@ export async function generateDoc(prompt, outputName = 'handover', outputDir = '
 
   const markdown = message.content[0].text
 
-  // Ensure output directory exists
   if (!fs.existsSync(outputDir)) {
     fs.mkdirSync(outputDir, { recursive: true })
   }
 
   const basePath = path.join(outputDir, outputName)
 
-  // --- 1. Save as Markdown ---
+  // Save as Markdown
   const mdPath = `${basePath}.md`
   fs.writeFileSync(mdPath, markdown, 'utf-8')
-  console.log(`✅ Markdown saved:  ${mdPath}`)
+  console.log(`✅ Markdown saved:   ${mdPath}`)
 
-  // --- 2. Save as Plain Text ---
+  // Save as plain text
   const plainText = markdown
-    .replace(/#{1,6}\s+/g, '')         // Remove headings
-    .replace(/\*\*(.*?)\*\*/g, '$1')   // Remove bold
-    .replace(/\*(.*?)\*/g, '$1')       // Remove italic
-    .replace(/`{1,3}[^`]*`{1,3}/g, (m) => m.replace(/`/g, '')) // Remove code ticks
-    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Remove links, keep text
-    .replace(/[-*+] /g, '• ')          // Convert bullets
-    .replace(/\n{3,}/g, '\n\n')        // Clean extra blank lines
+    .replace(/#{1,6}\s+/g, '')
+    .replace(/\*\*(.*?)\*\*/g, '$1')
+    .replace(/\*(.*?)\*/g, '$1')
+    .replace(/`{1,3}[^`]*`{1,3}/g, m => m.replace(/`/g, ''))
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+    .replace(/[-*+] /g, '• ')
+    .replace(/\n{3,}/g, '\n\n')
     .trim()
 
   const txtPath = `${basePath}.txt`
   fs.writeFileSync(txtPath, plainText, 'utf-8')
   console.log(`✅ Plain text saved: ${txtPath}`)
 
-  // --- 3. Save as HTML ---
-  const htmlBody = marked(markdown)
-  const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Handover Document</title>
-  <style>
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      max-width: 860px;
-      margin: 0 auto;
-      padding: 2rem;
-      color: #1a1a1a;
-      line-height: 1.7;
-    }
-    h1 { border-bottom: 2px solid #e0e0e0; padding-bottom: 0.5rem; }
-    h2 { margin-top: 2.5rem; color: #2c2c2c; }
-    h3 { color: #444; }
-    code {
-      background: #f4f4f4;
-      padding: 0.2em 0.4em;
-      border-radius: 4px;
-      font-size: 0.9em;
-    }
-    pre {
-      background: #f4f4f4;
-      padding: 1rem;
-      border-radius: 6px;
-      overflow-x: auto;
-    }
-    pre code { background: none; padding: 0; }
-    table {
-      width: 100%;
-      border-collapse: collapse;
-      margin: 1rem 0;
-    }
-    th, td {
-      border: 1px solid #ddd;
-      padding: 0.6rem 0.8rem;
-      text-align: left;
-    }
-    th { background: #f0f0f0; font-weight: 600; }
-    blockquote {
-      border-left: 4px solid #ccc;
-      margin: 0;
-      padding-left: 1rem;
-      color: #555;
-    }
-    .badge {
-      display: inline-block;
-      background: #e8f4fd;
-      color: #0969da;
-      padding: 0.2em 0.6em;
-      border-radius: 4px;
-      font-size: 0.8em;
-      font-weight: 600;
-    }
-    input[type="checkbox"] { margin-right: 0.4rem; }
-  </style>
-</head>
-<body>
-${htmlBody}
-</body>
-</html>`
-
-  const htmlPath = `${basePath}.html`
-  fs.writeFileSync(htmlPath, html, 'utf-8')
-  console.log(`✅ HTML saved:       ${htmlPath}`)
-
-  console.log('\n🎉 All formats generated successfully!\n')
+  // Save as Word document
+  const doc = buildDocx(markdown)
+  const docxBuffer = await Packer.toBuffer(doc)
+  const docxPath = `${basePath}.docx`
+  fs.writeFileSync(docxPath, docxBuffer)
+  console.log(`✅ Word doc saved:   ${docxPath}`)
 
-  return { markdown, plainText, html }
+  return { markdown, plainText }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "client-handover",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "AI-powered handover document generator for frontend developers handing off client websites",
   "type": "module",
   "main": "index.js",
@@ -11,13 +11,9 @@
     "cli.js",
     "index.js",
     "generator.js",
-    "handover.js",
-    "setup.js",
-    "deploy.js",
-    "credentials.js",
-    "license.js",
-    "postinstall.js",
+    "prompts.js",
     "scanner.js",
+    "postinstall.js",
     "README.md"
   ],
   "scripts": {
@@ -41,7 +37,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "chalk": "^5.3.0",
-    "client-handover": "^1.0.2",
-    "marked": "^12.0.0"
+    "client-handover": "^1.0.6",
+    "docx": "^8.5.0"
   }
 }

package/postinstall.js

@@ -9,56 +9,87 @@ const configDir = path.join(os.homedir(), '.handover')
 const configPath = path.join(configDir, 'config.json')
 const claudeCredsPath = path.join(os.homedir(), '.claude', '.credentials.json')
 
-function alreadyConfigured() {
-  if (process.env.ANTHROPIC_API_KEY) return true
+function loadConfig() {
+  try {
+    if (fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+    }
+  } catch {}
+  return {}
+}
 
-  if (fs.existsSync(configPath)) {
-    try {
-      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
-      if (config?.apiKey) return true
-    } catch {}
-  }
+function saveConfig(config) {
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
+}
 
-  if (fs.existsSync(claudeCredsPath)) {
-    try {
+function hasApiKey(config) {
+  if (process.env.ANTHROPIC_API_KEY) return true
+  if (config?.apiKey) return true
+  try {
+    if (fs.existsSync(claudeCredsPath)) {
       const creds = JSON.parse(fs.readFileSync(claudeCredsPath, 'utf-8'))
       const token = creds?.claudeAiOauth?.accessToken
       const expiresAt = creds?.claudeAiOauth?.expiresAt
       if (token && (!expiresAt || expiresAt > Date.now())) return true
-    } catch {}
-  }
-
+    }
+  } catch {}
   return false
 }
 
-function saveKey(key) {
-  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
-  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
-}
+if (!process.stdin.isTTY) process.exit(0)
 
-// Skip if already set up or not in an interactive terminal
-if (alreadyConfigured() || !process.stdin.isTTY) {
-  process.exit(0)
-}
+const config = loadConfig()
+const needsApiKey = !hasApiKey(config)
+const needsDeveloperInfo = !config.developerName
+
+if (!needsApiKey && !needsDeveloperInfo) process.exit(0)
 
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
 
+function ask(question) {
+  return new Promise(resolve => rl.question(question, answer => resolve(answer.trim())))
+}
+
 console.log('\n──────────────────────────────────────────')
 console.log(' client-handover setup')
 console.log('──────────────────────────────────────────')
-console.log(' To generate documents, you need an Anthropic API key.')
-console.log(' Get one free at: https://console.anthropic.com\n')
+console.log(' This tool generates professional handover documents for client websites.\n')
 
-rl.question(' Enter your Anthropic API key (or press Enter to skip): ', (answer) => {
-  rl.close()
-  const key = answer.trim()
+async function run() {
+  if (needsApiKey) {
+    console.log(' To generate documents you need an Anthropic API key.')
+    console.log(' Get one free at: https://console.anthropic.com\n')
+    const key = await ask(' Enter your Anthropic API key (or press Enter to skip): ')
+    if (key) {
+      config.apiKey = key
+      console.log(' ✓ API key saved.\n')
+    } else {
+      console.log(' Skipped. Run "handover key <your-api-key>" at any time.\n')
+    }
+  }
+
+  if (needsDeveloperInfo) {
+    console.log(' Developer details will appear in all generated handover documents.\n')
+    const name = await ask(' Your full name (developer): ')
+    if (name) config.developerName = name
 
-  if (!key) {
-    console.log('\n Skipped. Run "handover key <your-api-key>" at any time to set it.\n')
-    process.exit(0)
+    const company = await ask(' Your company name (or press Enter if not applicable): ')
+    if (company) config.developerCompany = company
+
+    const email = await ask(' Your email address: ')
+    if (email) config.developerEmail = email
+
+    const phone = await ask(' Your phone number (optional, press Enter to skip): ')
+    if (phone) config.developerPhone = phone
+
+    console.log()
   }
 
-  saveKey(key)
-  console.log('\n✅ API key saved. Run "handover handover" to get started.\n')
+  rl.close()
+  saveConfig(config)
+  console.log(' ✅ Setup complete. Run "handover /create" in any project folder to generate handover documents.\n')
   process.exit(0)
-})
+}
+
+run()

package/prompts.js

@@ -0,0 +1,185 @@
+export function technicalHandoverPrompt(projectInfo, developerInfo) {
+  const { name, company, email, phone } = developerInfo
+  const date = new Date().toLocaleDateString('en-GB', { day: 'numeric', month: 'long', year: 'numeric' })
+
+  return `
+You are an expert technical writer generating a TECHNICAL HANDOVER DOCUMENT for a developer taking over a client website project.
+
+This document is written for a DEVELOPER (future maintainer) — be precise, thorough, and technically complete. They need to be able to pick this project up cold with no prior knowledge.
+
+Developer who built this project:
+- Name: ${name || '[Developer Name]'}
+${company ? `- Company: ${company}` : ''}
+- Email: ${email || '[Developer Email]'}
+${phone ? `- Phone: ${phone}` : ''}
+- Handover date: ${date}
+
+The following context has been automatically scanned from the project files (package.json, config files, folder structure, environment variable keys, deploy configs, README, CSS colors, etc.). Use this to generate a document specific to THIS project. Do not invent or use generic placeholders — if a specific detail is not in the scanned data, note it as "[to be confirmed]".
+
+${projectInfo || '[No project data available]'}
+
+Generate a complete technical handover document with ALL of the following sections:
+
+---
+
+# [Project Name] — Technical Handover Document
+
+**Prepared by:** ${name || '[Developer Name]'}${company ? ` · ${company}` : ''}${email ? ` · ${email}` : ''}${phone ? ` · ${phone}` : ''}
+**Handover Date:** ${date}
+**Project URL:** [Live URL — to be confirmed]
+**Repository:** [Repo URL — to be confirmed]
+
+---
+
+## 1. Tech Stack
+- List every technology, framework, library, and tool used
+- Include versions where known
+- Briefly explain the role of each in the project
+
+## 2. Project Structure
+- Full folder/file structure with explanations of what each directory contains
+- Location of key config files and what they control
+- Entry points and routing overview
+
+## 3. Local Development Setup
+- Prerequisites (Node version, package manager, etc.)
+- Step-by-step install and run instructions using exact terminal commands in code blocks
+- All environment variables required (keys only, no values) — what each one does
+
+## 4. Build & Deployment
+- Build command and output directory
+- Hosting provider and deployment method
+- CI/CD pipeline if applicable
+- Domain, DNS, and SSL details
+- How to roll back a broken deployment
+
+## 5. Third-Party Integrations & Services
+- Every external service, API, or plugin used
+- What each one does and where it is configured
+- Which accounts own these services
+
+## 6. Credentials & Access
+- Table of all accounts needed (service, URL, account owner, how to request access)
+- Environment variable names and their purpose
+- Access transfer checklist
+
+## 7. Known Issues & Technical Debt
+- Any bugs, limitations, or workarounds in the current codebase
+- TODO items or deferred improvements
+- Performance or SEO considerations
+
+## 8. Maintenance Guide
+- How to update npm dependencies safely
+- What to check after deploying changes
+- Renewal dates for domain, hosting, or licences if known
+
+## 9. Developer Handover Checklist
+- [ ] Repository access transferred or shared
+- [ ] All environment variables documented
+- [ ] Hosting and domain access transferred
+- [ ] Third-party service accounts handed over
+- [ ] Local dev environment tested and documented
+- [ ] Live site tested across browsers and devices
+- [ ] Analytics verified working
+- [ ] README updated
+
+---
+
+Format the entire document in clean, well-structured Markdown.
+Use code blocks for all terminal commands and code snippets.
+Use tables where appropriate (especially for credentials and dependencies).
+Be thorough and precise — this document is the sole reference for the incoming developer.
+`.trim()
+}
+
+export function nonTechnicalHandoverPrompt(projectInfo, developerInfo) {
+  const { name, company, email, phone } = developerInfo
+  const date = new Date().toLocaleDateString('en-GB', { day: 'numeric', month: 'long', year: 'numeric' })
+
+  return `
+You are an expert writer generating a NON-TECHNICAL HANDOVER DOCUMENT for a CLIENT receiving their completed website.
+
+This document is written for the BUSINESS OWNER or CLIENT — use plain English, a warm and reassuring tone, and absolutely no technical jargon. The client should feel confident and informed about what they own.
+
+Developer contact details:
+- Name: ${name || '[Developer Name]'}
+${company ? `- Company: ${company}` : ''}
+- Email: ${email || '[Developer Email]'}
+${phone ? `- Phone: ${phone}` : ''}
+- Handover date: ${date}
+
+The following context has been automatically scanned from the project files. Use this to generate a document specific to THIS project. Focus on what the client needs to know — not how it was built. If a specific detail is not available, note it as "[to be confirmed]".
+
+${projectInfo || '[No project data available]'}
+
+Generate a complete non-technical handover document with ALL of the following sections:
+
+---
+
+# [Project Name] — Your Website Handover Guide
+
+**Prepared by:** ${name || '[Developer Name]'}${company ? ` · ${company}` : ''}${email ? ` · ${email}` : ''}${phone ? ` · ${phone}` : ''}
+**Date:** ${date}
+
+---
+
+## 1. About Your Website
+- What your website does and who it is for (1–2 paragraphs, plain English)
+- The main pages or sections and what each one is for
+- Any special features the site has (contact forms, booking, e-commerce, blog, etc.)
+
+## 2. Your Website's Look & Feel
+- The overall design style and visual identity
+- Colours used on the site (mention specific colours by name and hex code if detected in the project)
+- Fonts used
+- Any branding guidelines to keep in mind when making future updates
+
+## 3. What You Own
+- A plain-English summary of everything handed over: the website, domain, hosting, code, and content
+- Who owns what and what that means for you
+
+## 4. Logging Into Your Website
+- How to access and log in to any admin area or CMS (plain steps, no jargon)
+- What you can safely update yourself
+- What you should NOT change without speaking to a developer first
+
+## 5. How to Update Your Content
+- Step-by-step instructions for common tasks (e.g. updating text, adding images, publishing a blog post)
+- Keep instructions simple and numbered
+- Include a note about backing up before making changes
+
+## 6. Your Accounts & Passwords
+- List of all accounts the client now owns (hosting, domain, CMS, email, analytics, etc.)
+- Reminder to store passwords securely and change them after handover
+- Note: actual passwords should be shared separately and securely — not in this document
+
+## 7. Keeping Your Website Healthy
+- What needs renewing and approximately when (domain name, hosting plan, SSL certificate, any paid plugins)
+- How to tell if something on the site is broken
+- Simple monthly and yearly maintenance checklist
+
+## 8. Getting Help
+- When and how to contact your developer: ${name || '[Developer Name]'}${company ? ` (${company})` : ''}${email ? `, ${email}` : ''}${phone ? `, ${phone}` : ''}
+- What kinds of changes require a developer
+- Recommended process for requesting future updates
+
+## 9. Handover Sign-Off
+### Developer confirms:
+- [ ] All accounts and login details have been transferred
+- [ ] The live site has been reviewed and approved
+- [ ] This document has been discussed with the client
+
+### Client acknowledges:
+- [ ] I have received all login credentials securely
+- [ ] I understand how to update my website content
+- [ ] I know what I should not change without developer help
+- [ ] I know how to contact my developer for support
+
+---
+
+Write the entire document in plain, friendly English. Use short sentences and simple words.
+Avoid ALL technical jargon — if a technical term must be used, explain it in brackets immediately after.
+Use numbered lists for any step-by-step instructions.
+The tone should be warm, professional, and reassuring — the client should feel proud of their new website.
+`.trim()
+}

package/scanner.js

@@ -182,6 +182,13 @@ export function scanProject(dir = process.cwd()) {
     }
   }
 
+  // --- CSS color detection ---
+  const cssColors = extractColors(dir)
+  if (cssColors.length) {
+    sections.push(`\n## Detected colours (from CSS/config files)`)
+    cssColors.forEach(c => sections.push(`  ${c}`))
+  }
+
   // --- Folder structure ---
   const structure = getFolderStructure(dir)
   if (structure.length) {
@@ -191,3 +198,53 @@ export function scanProject(dir = process.cwd()) {
 
   return sections.join('\n')
 }
+
+function extractColors(dir) {
+  const colors = new Set()
+  const hexPattern = /#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})\b/g
+  const cssVarColorPattern = /(--[\w-]*color[\w-]*|--[\w-]*bg[\w-]*|--[\w-]*primary[\w-]*|--[\w-]*secondary[\w-]*):\s*([^;}\n]+)/gi
+  const cssExtensions = ['.css', '.scss', '.sass', '.less']
+
+  function scanFile(filePath) {
+    const content = readFileSafe(filePath)
+    if (!content) return
+    let match
+    while ((match = hexPattern.exec(content)) !== null) {
+      colors.add(`#${match[1].toUpperCase()}`)
+    }
+    while ((match = cssVarColorPattern.exec(content)) !== null) {
+      colors.add(`${match[1].trim()}: ${match[2].trim()}`)
+    }
+  }
+
+  function walkDir(d, depth = 0) {
+    if (depth > 3) return
+    const ignore = new Set(['node_modules', '.git', '.next', '.nuxt', 'dist', 'build', '.cache'])
+    try {
+      const items = fs.readdirSync(d, { withFileTypes: true })
+      for (const item of items) {
+        if (ignore.has(item.name) || item.name.startsWith('.')) continue
+        const full = path.join(d, item.name)
+        if (item.isDirectory()) {
+          walkDir(full, depth + 1)
+        } else if (cssExtensions.includes(path.extname(item.name).toLowerCase())) {
+          scanFile(full)
+        }
+      }
+    } catch {}
+  }
+
+  walkDir(dir)
+
+  // Also check tailwind config for color definitions
+  for (const twConfig of ['tailwind.config.js', 'tailwind.config.ts']) {
+    const content = readFileSafe(path.join(dir, twConfig))
+    if (!content) continue
+    let match
+    while ((match = hexPattern.exec(content)) !== null) {
+      colors.add(`#${match[1].toUpperCase()}`)
+    }
+  }
+
+  return [...colors].slice(0, 40) // cap at 40 to avoid flooding context
+}

package/credentials.js

@@ -1,51 +0,0 @@
-export function credentials(projectInfo = '') {
-  return `
-You are a technical documentation writer creating a CREDENTIALS section for a frontend website handover document.
-
-⚠️ IMPORTANT: Never include real passwords, keys, or secrets. All sensitive values must use placeholder format: YOUR_VALUE_HERE or [REPLACE_WITH_ACTUAL_VALUE]
-
-The following context has been automatically scanned from the developer's actual project files. Use the real environment variable keys and detected services to build the credentials table for THIS specific project. Do not invent services that are not present. Mark values as "[to be filled in]".
-
-${projectInfo || '[No project data available — use placeholder examples]'}
-
-Generate a CREDENTIALS & ACCESS section that includes:
-
-## Credentials & Access
-
-### For the Client (Plain English)
-- What accounts exist and what each one is for
-- Who currently has admin access
-- How to reset a password if they get locked out
-- Reminder to store credentials in a password manager (suggest 1Password, Bitwarden, etc.)
-- What NOT to share over email
-
-### For the Developer (Technical)
-Generate a credentials table template with these categories (use placeholders for all values):
-
-| Service | Purpose | URL | Username/Email | Notes |
-|---------|---------|-----|----------------|-------|
-
-Include rows for:
-- Hosting provider (e.g. Vercel, Netlify, cPanel)
-- Domain registrar
-- CMS or admin panel (if applicable)
-- Database access (if applicable)
-- Third-party APIs (list each one)
-- Email/SMTP service
-- Analytics (e.g. Google Analytics)
-- Version control (GitHub/GitLab repo URL)
-- Any other relevant service
-
-### API Keys & Environment Variables
-List all .env variables used with placeholder values and a description of each.
-
-### Access Transfer Checklist
-- [ ] Client has been added as admin to hosting
-- [ ] Client has been added to domain registrar
-- [ ] Developer has been removed or downgraded after handover
-- [ ] 2FA has been set up for client accounts
-- [ ] All credentials have been shared via secure method (not email)
-
-Format as clean Markdown with tables.
-`.trim()
-}

package/deploy.js

@@ -1,35 +0,0 @@
-export function deploy(projectInfo = '') {
-  return `
-You are a technical documentation writer creating a DEPLOYMENT section for a frontend website handover document.
-
-The audience is TWO types of readers:
-1. A NON-TECHNICAL CLIENT — plain English, no jargon
-2. A DEVELOPER — exact technical steps
-
-The following context has been automatically scanned from the developer's actual project files (deploy configs, package.json scripts, workflow files, etc.). Use it to generate deployment documentation specific to THIS project — do not use generic placeholders. Mark any missing details as "[to be filled in]".
-
-${projectInfo || '[No project data available — use placeholder examples]'}
-
-Generate a DEPLOYMENT section that includes:
-
-## Deployment & Hosting
-
-### For the Client (Plain English)
-- Where the website is hosted and what that means
-- How updates get published (automatic or manual?)
-- What happens if the site goes down — who to call, what to check
-- Estimated monthly/yearly hosting costs if known
-
-### For the Developer (Technical)
-- Hosting provider and account details (use placeholders for sensitive info)
-- Deployment method (e.g. Vercel push-to-deploy, FTP, CI/CD pipeline)
-- Step-by-step deploy process with exact commands
-- Domain/DNS setup and where it's managed
-- SSL certificate info
-- Build command and output directory
-- Any environment-specific configs (staging vs production)
-- Rollback procedure if a deployment fails
-
-Format as clean Markdown. Use code blocks for terminal commands.
-`.trim()
-}

package/handover.js

@@ -1,97 +0,0 @@
-export function handover(projectInfo = '') {
-  return `
-You are an expert technical writer generating a COMPLETE CLIENT WEBSITE HANDOVER DOCUMENT.
-
-This document is for TWO audiences:
-1. NON-TECHNICAL CLIENT — plain English, reassuring tone, no jargon. They need to feel confident owning this site.
-2. DEVELOPER (future maintainer) — precise, technical, complete. They need to be able to pick this up cold.
-
-The following context has been automatically scanned from the developer's actual project files (package.json, config files, folder structure, environment variable keys, deploy configs, README, etc.). Use this to generate a document specific to THIS project — do not invent or use generic placeholder examples. If a specific detail is not available in the scanned data, note it as "[to be filled in]" rather than guessing.
-
-${projectInfo || '[No project data available — use placeholder examples throughout]'}
-
-Generate a full handover document with ALL of the following sections:
-
----
-
-# [Project Name] — Website Handover Document
-**Prepared by:** [Developer Name]
-**Handover Date:** [Date]
-**Project URL:** [Live URL]
-**Repository:** [Repo URL]
-
----
-
-## 1. Project Overview
-- What the site does (1 paragraph, plain English)
-- Tech stack summary (with one-line plain English explanation of each)
-- Key contacts (developer, hosting support, etc.)
-
-## 2. Project Setup & Dependencies
-*(Follow the dual-audience format: client section + developer section)*
-- Prerequisites, install steps, local dev commands, environment variables
-
-## 3. Deployment & Hosting
-*(Dual-audience format)*
-- Hosting provider, deploy method, domain/DNS, SSL, build config, rollback steps
-
-## 4. Credentials & Access
-*(Dual-audience format)*
-- All accounts, credentials table with placeholders, .env variables, access transfer checklist
-
-## 5. Site Structure & Content Management
-### For the Client
-- How to update content (CMS, direct file edits, or contact developer)
-- What they should NEVER touch without developer help
-- How to add new pages or blog posts (if applicable)
-
-### For the Developer
-- Folder structure overview
-- Where key config files live
-- Component/template structure
-- Any custom hooks, stores, or utilities worth knowing about
-
-## 6. Maintenance & Updates
-### For the Client
-- What needs renewing and when (domain, hosting, licences)
-- How to know if something is broken
-- Recommended monthly/yearly maintenance tasks
-
-### For the Developer
-- How to update npm dependencies safely
-- Any known technical debt or TODO items
-- Performance and SEO considerations
-
-## 7. Licensing & Attribution
-*(Dual-audience format)*
-- Ownership summary, third-party licences table, attribution requirements, portfolio rights
-
-## 8. Handover Checklist
-A final sign-off checklist for both parties:
-
-### Developer Checklist (before handover)
-- [ ] All credentials transferred securely
-- [ ] Client added to hosting & domain accounts
-- [ ] Repository access transferred or shared
-- [ ] Live site tested across browsers and devices
-- [ ] Analytics verified working
-- [ ] All placeholder content replaced
-- [ ] .env.example file committed to repo
-- [ ] README updated
-- [ ] Handover document reviewed with client
-
-### Client Acknowledgement
-- [ ] I have received all login credentials
-- [ ] I understand how to update content
-- [ ] I know who to contact for technical support
-- [ ] I have been shown the live site and approve it
-
----
-
-Format the entire document in clean, well-structured Markdown.
-Use code blocks for all terminal commands.
-Use tables where appropriate.
-Keep client sections warm, clear, and jargon-free.
-Keep developer sections precise and thorough.
-`.trim()
-}

package/setup.js

@@ -1,32 +0,0 @@
-export function setup(projectInfo = '') {
-  return `
-You are a technical documentation writer creating a SETUP section for a frontend website handover document.
-
-The audience is TWO types of readers:
-1. A NON-TECHNICAL CLIENT — who needs plain-English explanations of what everything is and why it matters
-2. A DEVELOPER — who needs exact commands, file paths, and technical detail
-
-The following context has been automatically scanned from the developer's actual project files. Use it to generate documentation specific to THIS project — do not use generic placeholders. If something is unclear from the scanned data, mark it as "[to be filled in]".
-
-${projectInfo || '[No project data available — use placeholder examples]'}
-
-Generate a SETUP section that includes:
-
-## Project Setup & Dependencies
-
-### For the Client (Plain English)
-- What tech stack is used and a simple one-line explanation of each part
-- What they'll need to pay for or maintain (hosting, domain, licences)
-- Who to contact if something breaks
-
-### For the Developer (Technical)
-- Prerequisites (Node version, package manager, etc.)
-- Step-by-step install instructions with exact terminal commands
-- Environment variables needed (use placeholder values like YOUR_VALUE_HERE)
-- How to run locally (dev server command, expected URL)
-- Any known gotchas or first-time setup issues
-
-Format this as clean, well-structured Markdown with clear headings.
-Keep the client section jargon-free. Keep the developer section precise.
-`.trim()
-}