refactor(docs): take apps/docs out of the pnpm workspace (#502)

The docs app was the one thing making this a monorepo, and it earned nothing
for it: no shared code, no cross-package imports, its own framework, its own
deploy target. What it did do was break every pnpm install inside a StackBlitz
WebContainer — `ENOENT: apps/docs/.npmrc`, then `ENOENT: apps/docs/node_modules`
— because pnpm's workspace layout and the sandbox fs disagree. The escape
hatch, `--ignore-workspace`, is incompatible with `--frozen-lockfile` precisely
because the lockfile is a workspace lockfile.

So: delete pnpm-workspace.yaml, give apps/docs its own pnpm-lock.yaml, its own
.npmrc (same settings — the app was relying on the root's `shamefully-hoist`),
and pin `packageManager` so Vercel resolves pnpm 10 from the app directory.
The root lockfile is regenerated with a single importer.

Two things this surfaced, both fixed here:

  - `build` now runs `fumadocs-mdx` before `next build`. Vercel installs with
    `--ignore-scripts` (its own vercel.json says so), and a cold standalone
    install + build failed on `Cannot find module 'fumadocs-mdx:collections/
    server'` — the generated `.source` has to exist before Turbopack collects
    page data. Generating it in `build` makes the cold path deterministic
    rather than dependent on a previous run's leftovers.
  - `turbopack.root` stays unset. Pinning it to apps/docs looks right for a
    standalone app and breaks 231 modules: content lives at the repo root
    (`../../../content/**`), so the Turbopack root must stay above this app.
    The resulting two-lockfile warning is expected; there's a comment saying so.

Verified locally by rehearsing Vercel's exact sequence in apps/docs:
`rm -rf node_modules && pnpm install --ignore-scripts` → `pnpm build` → 329
static pages, exit 0, from a clean tree. Root `pnpm verify` green.

Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>

Author: os-zhuang

.claude/launch.json

@@ -11,7 +11,7 @@
     {
       "name": "docs",
       "runtimeExecutable": "pnpm",
-      "runtimeArgs": ["--filter", "@hotcrm/docs", "dev"],
+      "runtimeArgs": ["-C", "apps/docs", "dev"],
       "port": 3210,
       "autoPort": true
     }

README.md

@@ -136,7 +136,7 @@ hotcrm/
 │   ├── profiles/, sharing/       # security
 │   ├── translations/             # en / zh-CN / es-ES / ja-JP
 │   └── data/                     # seed data
-├── apps/docs/                    # Fumadocs app
+├── apps/docs/                    # Fumadocs site — standalone, own lockfile (not a pnpm workspace member)
 └── content/docs/                 # Documentation content
 ```
 
@@ -146,7 +146,7 @@ Every file follows the **`<entity>.<kind>.ts`** convention. The `crm_` prefix on
 
 ## 📚 Documentation
 
-- **Live docs:** start `pnpm --filter @hotcrm/docs dev -- -p 3001`, then open <http://localhost:3001/docs>
+- **Live docs:** start `pnpm -C apps/docs install && pnpm -C apps/docs dev -p 3001`, then open <http://localhost:3001/docs>
 - **For business users:** Sales, Service, Marketing, Revenue, AI Copilot guides
 - **For developers:** Architecture, Customization, API reference, Testing & CI
 - **For publishers:** Marketplace publishing guide

apps/docs/.npmrc

@@ -0,0 +1,4 @@
+auto-install-peers=false
+engine-strict=true
+node-linker=hoisted
+shamefully-hoist=true

apps/docs/next.config.mjs

@@ -5,6 +5,11 @@ const withMDX = createMDX();
 /** @type {import('next').NextConfig} */
 const config = {
   reactStrictMode: true,
+  // Docs content lives at the repo root (`content/`), outside this app, so the
+  // Turbopack root has to stay the repo root — Next infers it from the root
+  // lockfile. Pinning `turbopack.root` here breaks every `../../../content`
+  // import, and the two-lockfile warning it silences is expected now that this
+  // app is not a pnpm workspace member.
   async rewrites() {
     return [
       {

apps/docs/package.json

@@ -2,8 +2,9 @@
   "name": "@hotcrm/docs",
   "version": "1.0.0",
   "private": true,
+  "packageManager": "pnpm@10.33.0",
   "scripts": {
-    "build": "next build",
+    "build": "fumadocs-mdx && next build",
     "dev": "next dev",
     "start": "next start",
     "types:check": "fumadocs-mdx && next typegen && tsc --noEmit"
@@ -29,4 +30,4 @@
     "tailwindcss": "^4.3.1",
     "typescript": "^5.9.3"
   }
-}
+}