@inovus-medical/docs 0.8.1 → 0.10.0

package/README.md

@@ -17,22 +17,24 @@ npm install --save-dev @inovus-medical/docs
 Put markdown in `docs/`, add a `docs.config.json`, then:
 
 ```bash
-npx inovus-docs build    # docs/ -> dist/
+npx inovus-docs build    # content -> dist/ (or --out dist-docs)
 npx inovus-docs dev      # build + serve + watch (http://localhost:8788)
 npx inovus-docs serve    # serve an existing dist/
+npx inovus-docs init     # scaffold into the current repo (safe in app repos)
 ```
 
 Flags: `--root <dir>` `--in <docs>` `--out <dist>` `--port <n>` `--theme <name>`.
+`init` also accepts `--content <dir>` and merges without overwriting app `build` scripts.
 
 ## Themes
 
-Named themes each include light and dark variants. Built-ins: `default`, `totum`.
+Named themes each include light and dark variants. Built-ins: `totum` (default), `default`.
 
 Selection (first match wins): `--theme` > `DOCS_THEME` env var > `"theme"` in
-`docs.config.json` > `default`. On Cloudflare, set `DOCS_THEME` under Worker →
+`docs.config.json` > `totum`. On Cloudflare, set `DOCS_THEME` under Worker →
 **Settings → Build → Variables** (build-time).
 
-Local preview: `npx inovus-docs dev --theme totum`.
+Local preview: `npx inovus-docs dev` (Totum) or `--theme default`.
 
 ## What it does
 

package/bin/cli.js

@@ -29,35 +29,75 @@ const flags = parseFlags(cmd === argv[0] ? argv.slice(1) : argv)
 
 const root = path.resolve(flags.root || process.cwd())
 const inDir = flags.in // undefined -> build() auto-detects (docs/ or repo root)
-const outDir = flags.out || 'dist'
+const outDirFlag = typeof flags.out === 'string' ? flags.out : undefined
 const port = Number(flags.port || 8788)
 const theme = typeof flags.theme === 'string' ? flags.theme : undefined
 
 async function run() {
   if (cmd === 'init') {
-    const { created, skipped, name, title, visibility, repoUrl, home } = await init({ root, flags })
-    console.log(`Scaffolded "${title}" (worker: ${name}, ${visibility})${repoUrl ? ` — ${repoUrl}` : ''}`)
+    const result = await init({ root, flags })
+    const {
+      created,
+      skipped,
+      notes,
+      name,
+      title,
+      visibility,
+      repoUrl,
+      home,
+      content,
+      buildCommand,
+      deployCommand,
+      localInstall,
+      localDev,
+      packageManager,
+      coexisting
+    } = result
+    console.log(
+      `Scaffolded "${title}" (worker: ${name}, ${visibility})${repoUrl ? ` — ${repoUrl}` : ''}`
+    )
+    if (content && content !== '.') console.log(`  content: ${content}/`)
+    if (coexisting) console.log('  mode: coexisting with existing package.json (docs scripts are docs:*)')
+    if (packageManager) console.log(`  package manager: ${packageManager}`)
     if (created.length) console.log('  created: ' + created.join(', '))
     if (skipped.length) console.log('  kept existing (use --force to overwrite): ' + skipped.join(', '))
+    for (const n of notes || []) console.log('  ⚠ ' + n)
     if (!home) {
-      console.log('  ⚠ No home page (README.md / index.md) and --no-readme set — the site will have no page at /.')
+      console.log(
+        '  ⚠ No home page (README.md / index.md) in the content folder — add one or the site will have no page at /.'
+      )
     }
     console.log('\nNext:')
-    console.log('  npm install')
-    console.log('  npm run dev        # preview at http://localhost:8788')
+    console.log(`  ${localInstall}`)
+    console.log(`  ${localDev}     # preview at http://localhost:8788`)
     console.log('  git add -A && git commit -m "Add docs site config" && git push')
-    console.log('  then connect the repo in Cloudflare (build: npm install && npm run build)')
+    console.log('  (Commit the lockfile too — Cloudflare installs with --frozen-lockfile.)')
+    console.log('\nCloudflare Worker (same for every repo — copy exactly):')
+    console.log(`  Build command:  ${buildCommand}`)
+    console.log(`  Deploy command: ${deployCommand}`)
     return
   }
 
   if (cmd === 'build') {
-    const { pageCount, outPath, contentDir } = await build({ root, inDir, outDir, theme })
-    console.log(`✓ Built ${pageCount} page(s) from ${contentDir === '.' ? 'repo root' : contentDir + '/'} -> ${path.relative(process.cwd(), outPath) || outPath}`)
+    const { pageCount, outPath, contentDir, outDir } = await build({
+      root,
+      inDir,
+      outDir: outDirFlag,
+      theme
+    })
+    console.log(
+      `✓ Built ${pageCount} page(s) from ${contentDir === '.' ? 'repo root' : contentDir + '/'} -> ${path.relative(process.cwd(), outPath) || outDir}`
+    )
     return
   }
 
   if (cmd === 'dev') {
-    const { pageCount, outPath, contentDir } = await build({ root, inDir, outDir, theme })
+    const { pageCount, outPath, contentDir, outDir } = await build({
+      root,
+      inDir,
+      outDir: outDirFlag,
+      theme
+    })
     console.log(`✓ Built ${pageCount} page(s) from ${contentDir === '.' ? 'repo root' : contentDir + '/'}`)
     const { port: actual } = await serve({ dir: outPath, port })
     const busy = actual !== port ? `  (port ${port} was busy)` : ''
@@ -67,6 +107,9 @@ async function run() {
   }
 
   if (cmd === 'serve') {
+    const { loadConfig } = await import('../src/config.js')
+    const config = await loadConfig(root)
+    const outDir = outDirFlag || config.outDir || 'dist'
     const outPath = path.join(root, outDir)
     const { port: actual } = await serve({ dir: outPath, port })
     const busy = actual !== port ? `  (port ${port} was busy)` : ''

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inovus-medical/docs",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Turn a folder of markdown into a themed, Cloudflare-ready docs site.",
   "type": "module",
   "bin": {

package/src/build.js

@@ -31,18 +31,18 @@ async function listThemes() {
 }
 
 /**
- * Resolve theme: CLI --theme > DOCS_THEME env > docs.config.json > "default".
- * Unknown names warn and fall back to default.
+ * Resolve theme: CLI --theme > DOCS_THEME env > docs.config.json > "totum".
+ * Unknown names warn and fall back to totum.
  */
 async function resolveTheme({ themeFlag, config }) {
-  const raw = themeFlag ?? process.env.DOCS_THEME ?? config.theme ?? 'default'
-  const name = String(raw).trim().toLowerCase() || 'default'
+  const raw = themeFlag ?? process.env.DOCS_THEME ?? config.theme ?? 'totum'
+  const name = String(raw).trim().toLowerCase() || 'totum'
   const available = await listThemes()
   if (!available.has(name)) {
     console.warn(
-      `⚠ Unknown theme "${name}" — falling back to default. Available: ${[...available].sort().join(', ')}`
+      `⚠ Unknown theme "${name}" — falling back to totum. Available: ${[...available].sort().join(', ')}`
     )
-    return 'default'
+    return 'totum'
   }
   return name
 }
@@ -119,11 +119,12 @@ function routeToFile(outPath, route) {
   return path.join(outPath, rel, 'index.html')
 }
 
-export async function build({ root = process.cwd(), inDir, outDir = 'dist', theme: themeFlag } = {}) {
+export async function build({ root = process.cwd(), inDir, outDir, theme: themeFlag } = {}) {
   const config = await loadConfig(root)
   const theme = await resolveTheme({ themeFlag, config })
   config.theme = theme
-  const outPath = path.join(root, outDir)
+  const resolvedOut = outDir || config.outDir || 'dist'
+  const outPath = path.join(root, resolvedOut)
   const ignore = makeIgnore(config, path.basename(outPath))
 
   const contentDir = await resolveContentDir({ root, inDir, config, ignore })
@@ -235,5 +236,5 @@ export async function build({ root = process.cwd(), inDir, outDir = 'dist', them
     await fs.copyFile(file, dest)
   }
 
-  return { pageCount: pages.length, outPath, contentDir }
+  return { pageCount: pages.length, outPath, contentDir, outDir: resolvedOut }
 }

package/src/config.js

@@ -5,10 +5,12 @@ const DEFAULTS = {
   title: 'Documentation',
   description: '',
   logo: null,
-  // null = use the theme's accent (base styles.css sets --accent for default).
+  // null = use the theme's accent (theme CSS / base styles set --accent).
   accent: null,
   // Named theme (each has light + dark). Overridden by DOCS_THEME / --theme.
-  theme: 'default',
+  theme: 'totum',
+  // Build output directory. null → "dist". App repos usually use "dist-docs".
+  outDir: null,
   repo: null,
   editBase: null,
   visibility: 'private',

package/src/init.js

@@ -6,11 +6,18 @@ import { execSync } from 'node:child_process'
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
 async function fileExists(p) {
-  try { await fs.access(p); return true } catch { return false }
+  try {
+    await fs.access(p)
+    return true
+  } catch {
+    return false
+  }
 }
 
 async function readJsonIfExists(file) {
-  try { return JSON.parse(await fs.readFile(file, 'utf8')) } catch (e) {
+  try {
+    return JSON.parse(await fs.readFile(file, 'utf8'))
+  } catch (e) {
     if (e.code === 'ENOENT') return null
     throw e
   }
@@ -18,10 +25,14 @@ async function readJsonIfExists(file) {
 
 function gitRemote(root) {
   try {
-    return execSync('git config --get remote.origin.url', {
-      cwd: root,
-      stdio: ['ignore', 'pipe', 'ignore']
-    }).toString().trim() || null
+    return (
+      execSync('git config --get remote.origin.url', {
+        cwd: root,
+        stdio: ['ignore', 'pipe', 'ignore']
+      })
+        .toString()
+        .trim() || null
+    )
   } catch {
     return null
   }
@@ -44,35 +55,72 @@ function parseRemote(url) {
 
 function sanitizeName(s) {
   return (
-    String(s).toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 54) ||
-    'docs-site'
+    String(s)
+      .toLowerCase()
+      .replace(/[^a-z0-9-]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .slice(0, 54) || 'docs-site'
   )
 }
 
 function titleCase(s) {
-  return String(s).replace(/[-_]/g, ' ').replace(/\s+/g, ' ').trim().replace(/\b\w/g, (c) => c.toUpperCase())
+  return String(s)
+    .replace(/[-_]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/\b\w/g, (c) => c.toUpperCase())
+}
+
+/**
+ * Detect the repo's package manager from lockfiles / packageManager field.
+ * Cloudflare Workers Builds does the same (pnpm/yarn/npm from lockfile).
+ */
+async function detectPackageManager(root, pkg) {
+  if (await fileExists(path.join(root, 'pnpm-lock.yaml'))) return 'pnpm'
+  if (await fileExists(path.join(root, 'yarn.lock'))) return 'yarn'
+  if (
+    (await fileExists(path.join(root, 'bun.lockb'))) ||
+    (await fileExists(path.join(root, 'bun.lock')))
+  ) {
+    return 'bun'
+  }
+  const field = pkg && typeof pkg.packageManager === 'string' ? pkg.packageManager : ''
+  if (field.startsWith('pnpm@')) return 'pnpm'
+  if (field.startsWith('yarn@')) return 'yarn'
+  if (field.startsWith('bun@')) return 'bun'
+  if (await fileExists(path.join(root, 'package-lock.json'))) return 'npm'
+  return 'npm'
+}
+
+function runScript(pm, script) {
+  if (pm === 'yarn') return `yarn ${script}`
+  if (pm === 'bun') return `bun run ${script}`
+  if (pm === 'pnpm') return `pnpm run ${script}`
+  return `npm run ${script}`
 }
 
-const WRANGLER = (name) => `{
+const WRANGLER = (name, outDir) => `{
   "$schema": "node_modules/wrangler/config-schema.json",
   "name": "${name}",
   "compatibility_date": "2025-06-01",
   "assets": {
-    "directory": "./dist",
+    "directory": "./${outDir}",
     "html_handling": "auto-trailing-slash",
     "not_found_handling": "404-page"
   }
 }
 `
 
-async function ensureGitignore(root, created) {
+async function ensureGitignore(root, entries, created) {
   const file = path.join(root, '.gitignore')
   let body = ''
-  try { body = await fs.readFile(file, 'utf8') } catch {}
+  try {
+    body = await fs.readFile(file, 'utf8')
+  } catch {}
   const present = new Set(body.split(/\r?\n/).map((l) => l.trim()))
   let next = body
   let changed = false
-  for (const entry of ['node_modules/', 'dist/']) {
+  for (const entry of entries) {
     if (!present.has(entry)) {
       next += (next && !next.endsWith('\n') ? '\n' : '') + entry + '\n'
       changed = true
@@ -84,9 +132,10 @@ async function ensureGitignore(root, created) {
   }
 }
 
-async function hasHomePage(root) {
-  const candidates = ['README.md', 'readme.md', 'index.md', 'docs/README.md', 'docs/index.md']
-  for (const c of candidates) if (await fileExists(path.join(root, c))) return true
+async function hasHomePageIn(dir) {
+  for (const c of ['README.md', 'readme.md', 'index.md']) {
+    if (await fileExists(path.join(dir, c))) return true
+  }
   return false
 }
 
@@ -96,82 +145,189 @@ function starterReadme(title) {
 Welcome to the ${title} documentation.
 
 This is the home page of your docs site. Edit this \`README.md\` to change it, and add
-more \`.md\` files anywhere in the repo — they show up in the sidebar automatically.
+more \`.md\` files alongside it — they show up in the sidebar automatically.
 `
 }
 
-/** Scaffold the per-repo files needed to publish a markdown repo as a docs site. */
+/**
+ * Scaffold the per-repo files needed to publish markdown as a docs site.
+ * Designed to co-exist with normal app repos: never overwrites app build/dev scripts,
+ * avoids clobbering an existing Wrangler config, and uses a separate output dir when needed.
+ */
 export async function init({ root = process.cwd(), flags = {} } = {}) {
   const enginePkg = JSON.parse(await fs.readFile(path.join(__dirname, '..', 'package.json'), 'utf8'))
   const engineVersion = `^${enginePkg.version}`
 
   const remote = parseRemote(gitRemote(root))
   const folder = path.basename(root)
-  const name = sanitizeName(flags.name || remote.repo || folder)
-  const title = flags.title || titleCase(remote.repo || folder)
+  const existingPkg = await readJsonIfExists(path.join(root, 'package.json'))
+  const coexisting = Boolean(existingPkg)
+  const baseName = remote.repo || folder
+  const name = sanitizeName(flags.name || (coexisting ? `${baseName}-docs` : baseName))
+  const title = flags.title || titleCase(baseName)
   const visibility = flags.public ? 'public' : 'private'
   const repoUrl = flags.repo || remote.httpsUrl || null
   const force = flags.force === true
+
   // Content root: --content <dir>, else auto-set "docs" when docs/ exists, else omit (auto-detect at build).
   let content = typeof flags.content === 'string' ? flags.content.trim() : null
   if (!content && (await fileExists(path.join(root, 'docs')))) content = 'docs'
 
+  // App repos often already use dist/ — keep docs output out of the way via config.outDir.
+  const outDir = coexisting ? 'dist-docs' : 'dist'
+  // One Cloudflare build command for every repo (npm/pnpm/yarn). Reads docs.config.json.
+  const buildCommand = 'npx inovus-docs build'
+  const pm = await detectPackageManager(root, existingPkg)
+  const localInstall = pm === 'yarn' ? 'yarn' : pm === 'bun' ? 'bun install' : `${pm} install`
+  const localDev = runScript(pm, 'docs:dev')
+
+  const hasAppWrangler =
+    (await fileExists(path.join(root, 'wrangler.jsonc'))) ||
+    (await fileExists(path.join(root, 'wrangler.toml'))) ||
+    (await fileExists(path.join(root, 'wrangler.json')))
+  const wranglerFile = coexisting && hasAppWrangler ? 'wrangler.docs.jsonc' : 'wrangler.jsonc'
+
   const created = []
   const skipped = []
+  const notes = []
 
-  // docs.config.json (don't clobber existing unless --force)
+  // docs.config.json — create or merge additive fields (never wipe an existing file)
   const cfgPath = path.join(root, 'docs.config.json')
   if ((await fileExists(cfgPath)) && !force) {
-    skipped.push('docs.config.json')
+    const cfg = (await readJsonIfExists(cfgPath)) || {}
+    let changed = false
+    if (content && !cfg.content) {
+      cfg.content = content
+      changed = true
+    }
+    if (coexisting && !cfg.outDir) {
+      cfg.outDir = outDir
+      changed = true
+    }
+    if (!cfg.theme) {
+      cfg.theme = 'totum'
+      changed = true
+    }
+    if (changed) {
+      await fs.writeFile(cfgPath, JSON.stringify(cfg, null, 2) + '\n')
+      created.push('docs.config.json (updated)')
+    } else {
+      skipped.push('docs.config.json')
+    }
   } else {
-    const cfg = { title, description: '', visibility }
+    const cfg = { title, description: '', visibility, theme: 'totum' }
     if (repoUrl) cfg.repo = repoUrl
     if (content) cfg.content = content
+    if (outDir !== 'dist') cfg.outDir = outDir
     await fs.writeFile(cfgPath, JSON.stringify(cfg, null, 2) + '\n')
     created.push('docs.config.json')
   }
 
-  // wrangler.jsonc
-  const wranglerPath = path.join(root, 'wrangler.jsonc')
+  // Wrangler config — never overwrite an app's wrangler unless --force on our docs file
+  const wranglerPath = path.join(root, wranglerFile)
   if ((await fileExists(wranglerPath)) && !force) {
-    skipped.push('wrangler.jsonc')
+    skipped.push(wranglerFile)
   } else {
-    await fs.writeFile(wranglerPath, WRANGLER(name))
-    created.push('wrangler.jsonc')
+    await fs.writeFile(wranglerPath, WRANGLER(name, outDir))
+    created.push(wranglerFile)
+    if (wranglerFile !== 'wrangler.jsonc') {
+      notes.push(
+        `App Wrangler config left alone; docs deploy uses: npx wrangler deploy -c ${wranglerFile}`
+      )
+    }
   }
 
-  // package.json (merge if present — never remove existing fields)
+  // package.json — merge only; never replace existing build/dev
   const pkgPath = path.join(root, 'package.json')
-  const existingPkg = await readJsonIfExists(pkgPath)
-  const pkg = existingPkg || { name, private: true }
-  pkg.scripts = pkg.scripts || {}
-  if (!pkg.scripts.build) pkg.scripts.build = 'inovus-docs build'
-  if (!pkg.scripts.dev) pkg.scripts.dev = 'inovus-docs dev'
-  pkg.devDependencies = pkg.devDependencies || {}
+  const pkg = existingPkg ? { ...existingPkg } : { name, private: true }
+  pkg.scripts = { ...(pkg.scripts || {}) }
+  // Local convenience scripts (CF uses `npx inovus-docs build` — not these names).
+  pkg.scripts['docs:build'] = 'inovus-docs build'
+  pkg.scripts['docs:dev'] = 'inovus-docs dev'
+  if (!pkg.scripts.build) {
+    pkg.scripts.build = 'inovus-docs build'
+  } else {
+    notes.push(
+      `Left existing "build" script alone (app build). Cloudflare must use: ${buildCommand}`
+    )
+  }
+  if (!pkg.scripts.dev) {
+    pkg.scripts.dev = 'inovus-docs dev'
+  }
+  if (wranglerFile !== 'wrangler.jsonc' && !pkg.scripts['docs:deploy']) {
+    pkg.scripts['docs:deploy'] = `wrangler deploy -c ${wranglerFile}`
+  }
+  pkg.devDependencies = { ...(pkg.devDependencies || {}) }
   pkg.devDependencies[enginePkg.name] = engineVersion
+  if (!pkg.devDependencies.wrangler) {
+    pkg.devDependencies.wrangler = '^4'
+  }
   await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n')
   created.push(existingPkg ? 'package.json (updated)' : 'package.json')
 
-  // .node-version for Cloudflare's build image (Wrangler needs Node 22)
+  // Update the lockfile so Cloudflare --frozen-lockfile can install the engine.
+  try {
+    console.log(`Updating lockfile (${localInstall})…`)
+    execSync(localInstall, { cwd: root, stdio: 'inherit', shell: true })
+    created.push('lockfile (updated)')
+  } catch {
+    notes.push(
+      `Could not run "${localInstall}" automatically. Run it yourself and commit the lockfile before deploying.`
+    )
+  }
+
+  // .node-version — only for greenfield docs repos (apps often pin their own Node).
   const nodeVerPath = path.join(root, '.node-version')
-  if (!(await fileExists(nodeVerPath))) {
+  if (!coexisting && !(await fileExists(nodeVerPath))) {
     await fs.writeFile(nodeVerPath, '22\n')
     created.push('.node-version')
+  } else if (coexisting && !(await fileExists(nodeVerPath))) {
+    notes.push('Set Node 22 in the Cloudflare Worker build settings (Wrangler requires it).')
   }
 
-  await ensureGitignore(root, created)
+  const ignore = ['node_modules/', `${outDir}/`]
+  await ensureGitignore(root, ignore, created)
 
-  // Guarantee a landing page: if the repo has no README/index anywhere, drop a starter.
-  let home = await hasHomePage(root)
+  // Home page inside the content root (never invent a root README over an app's README).
+  const contentRel = content || '.'
+  const contentRoot = path.join(root, contentRel)
+  let home = await hasHomePageIn(contentRoot)
   if (!home && !flags['no-readme']) {
-    const inDocsMode = await fileExists(path.join(root, 'docs'))
-    const rel = inDocsMode ? path.join('docs', 'README.md') : 'README.md'
-    const readmePath = path.join(root, rel)
+    await fs.mkdir(contentRoot, { recursive: true })
+    const rel = path.join(contentRel === '.' ? '' : contentRel, 'README.md').replace(/^\//, '')
+    const readmePath = path.join(root, rel || 'README.md')
     await fs.mkdir(path.dirname(readmePath), { recursive: true })
-    await fs.writeFile(readmePath, starterReadme(title))
-    created.push(rel.split(path.sep).join('/'))
-    home = true
+    if (!(await fileExists(readmePath))) {
+      await fs.writeFile(readmePath, starterReadme(title))
+      created.push((rel || 'README.md').split(path.sep).join('/'))
+      home = true
+    } else {
+      home = true
+    }
   }
 
-  return { created, skipped, name, title, visibility, repoUrl, home }
+  const deployCommand =
+    wranglerFile === 'wrangler.jsonc'
+      ? 'npx wrangler deploy'
+      : `npx wrangler deploy -c ${wranglerFile}`
+
+  return {
+    created,
+    skipped,
+    notes,
+    name,
+    title,
+    visibility,
+    repoUrl,
+    home,
+    content: contentRel,
+    outDir,
+    wranglerFile,
+    buildCommand,
+    deployCommand,
+    localInstall,
+    localDev,
+    packageManager: pm,
+    coexisting
+  }
 }

package/src/layout.js

@@ -74,7 +74,7 @@ function header(config) {
 
 function shell({ config, pageTitle, description, navHtml, main }) {
   const accent = config.accent ? `<style>:root{--accent:${esc(config.accent)}}</style>` : ''
-  const docsTheme = (config.theme && config.theme !== 'default') ? config.theme : 'default'
+  const docsTheme = config.theme || 'totum'
   const themeLink =
     docsTheme !== 'default' ? '<link rel="stylesheet" href="/_assets/theme.css">\n' : ''
   const desc = description || config.description || ''

package/src/watch.js

@@ -2,7 +2,7 @@ import { watch } from 'node:fs'
 import path from 'node:path'
 import { build } from './build.js'
 
-const IGNORED = /(^|[\\/])(node_modules|\.git|dist)([\\/]|$)/
+const IGNORED = /(^|[\\/])(node_modules|\.git|dist-docs|dist)([\\/]|$)/
 
 /**
  * Rebuild on any change under the content directory. Debounced so a burst of
@@ -12,7 +12,7 @@ const IGNORED = /(^|[\\/])(node_modules|\.git|dist)([\\/]|$)/
  */
 export function watchAndRebuild({ root, inDir, outDir, theme }) {
   const watchPath = inDir === '.' ? root : path.join(root, inDir)
-  const outBase = path.basename(outDir)
+  const outBase = path.basename(outDir || 'dist')
   let timer = null
   let building = false
 
@@ -23,7 +23,12 @@ export function watchAndRebuild({ root, inDir, outDir, theme }) {
       if (building) return
       building = true
       try {
-        const { pageCount } = await build({ root, inDir: inDir === '.' ? '.' : inDir, outDir, theme })
+        const { pageCount } = await build({
+          root,
+          inDir: inDir === '.' ? '.' : inDir,
+          outDir,
+          theme
+        })
         console.log(`↻ Rebuilt ${pageCount} page(s)`)
       } catch (err) {
         console.error('Build failed:', err.message)