@viliha/vui-ui 1.5.1 → 1.5.2

package/AGENT.md

@@ -86,6 +86,47 @@ dependencies** with the package manager it detects from the lockfile (npm / pnpm
 Other flags: `--yes` / `--force` / `--dry-run`. If you only need the components, pass
 `--theme-only` (or skip `init` entirely) and follow the setup below.
 
+### Inside a Turborepo / monorepo
+
+**Never scaffold into the repo root** — a monorepo root has no `app/` and no Next
+app. Target the specific application, e.g. `apps/web`. Two equivalent ways:
+
+```bash
+# A) from the repo root, name the app dir
+npx @viliha/vui-ui init --turbo --dir apps/web
+
+# B) from inside the app (simplest to reason about)
+cd apps/web
+npx @viliha/vui-ui init
+```
+
+In turbo mode the CLI **does not auto-install** (installs are workspace-specific),
+so finish the setup yourself, scoped to that app:
+
+```bash
+cd apps/web                 # be inside the app, not the root
+pnpm add @viliha/vui-ui …   # or: pnpm --filter <app-name> add @viliha/vui-ui …
+```
+
+Then confirm the app is in your workspace globs (`pnpm-workspace.yaml` /
+`package.json` `workspaces`) and run it with a filter: `pnpm --filter <app-name>
+dev`. The theme import, `transpilePackages`, and the `@/*` alias all belong in
+**that app's** `globals.css` / `next.config` / `tsconfig`, not the root.
+
+### End-to-end walkthroughs
+
+- **New standalone app** — `npx create-next-app@latest my-app --ts --tailwind
+  --app --no-src-dir --use-npm`, then `cd my-app && npx @viliha/vui-ui init`
+  (fresh + prebuilt). It scaffolds config + shell + demo, installs deps, and you
+  run `npm run dev` → `/dashboard`.
+- **New app in a monorepo** — scaffold your app under `apps/<name>` (e.g. with
+  `create-next-app`), then from that app dir run `npx @viliha/vui-ui init` (or
+  `--turbo --dir apps/<name>` from the root) and install deps in that app.
+- **Existing app** — run `npx @viliha/vui-ui init --existing`. It never
+  overwrites your config; wire up the four things it prints (`transpilePackages`,
+  the `theme.css` import, the `@/*` alias, `import "./globals.css"`). Prefer only
+  the components? Use `--theme-only` (copies nothing) and follow the setup below.
+
 VUI ships as TypeScript source.
 
 ## Next.js

package/README.md

@@ -109,6 +109,26 @@ cd my-app && bunx @viliha/vui-ui init && bun dev
 the demo pages, overwriting the create-next-app boilerplate, and installs the
 dependencies. The demo then runs out of the box at `/dashboard`.
 
+### Turborepo / monorepo
+
+Scaffold **inside the target app** (e.g. `apps/web`), never at the repo root —
+the root has no `app/` and no Next.js app. Run `init` from the app, or name it
+from the root with `--dir`:
+
+```bash
+# from inside the app (simplest)
+cd apps/web && npx @viliha/vui-ui init
+
+# …or from the repo root
+npx @viliha/vui-ui init --turbo --dir apps/web
+```
+
+In monorepo mode `init` does **not** auto-install (installs are
+workspace-specific), so add the deps to that app afterward — `cd apps/web && pnpm
+add @viliha/vui-ui …`, or from the root `pnpm --filter web add @viliha/vui-ui …`.
+The `transpilePackages` entry, the `theme.css` import, and the `@/*` alias all
+belong to **that app**, not the root.
+
 ### ⚠️ Existing project — read this first
 
 Adding VUI to an app you already have takes a little care. **`init --existing`

package/bin/vui.mjs

@@ -306,11 +306,17 @@ The shell + demo were added under app/(app)/ and app/_components/ — review the
   }
 
   if (turbo) {
-    console.log(`Turborepo notes (target: ${appDir}):
-  • Add the deps to that app: ${ADD_CMD[pm]} ${installList}
-    (from the app dir, or with your PM's workspace filter).
-  • Ensure your workspace globs include this app (pnpm-workspace.yaml / workspaces).
-  • Run dev with a filter, e.g. ${pm} --filter <app-name> dev
+    console.log(`Turborepo — finish inside the target app (${appDir}):
+  1. cd ${appDir}
+  2. Install the deps in THIS app (not the repo root):
+       ${ADD_CMD[pm]} ${installList}
+     (or from the root with your workspace filter, e.g.
+       ${pm} --filter <app-name> add ${installList})
+  3. Make sure your workspace globs include this app
+     (pnpm-workspace.yaml \`packages:\` or package.json \`workspaces\`).
+  4. Run it: ${pm} --filter <app-name> dev   (or \`cd ${appDir} && ${pm} dev\`)
+
+Deps were NOT auto-installed for a monorepo — installs are workspace-specific.
 `);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viliha/vui-ui",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Vui UI — a clean, token-driven React admin/CRM component library built on Tailwind CSS v4, shadcn-style patterns, and Radix Icons. Ships as TypeScript source (Just-in-Time), compiled by the consuming app.",
   "license": "MIT",
   "author": "Suman Bonakurthi",