@webjsdev/cli 0.8.1 → 0.8.3

package/README.md

@@ -1,6 +1,6 @@
 # @webjsdev/cli
 
-CLI for [webjs](https://github.com/vivek7405/webjs): scaffold, develop,
+CLI for [webjs](https://github.com/webjsdev/webjs): scaffold, develop,
 build, and run webjs apps.
 
 Installing this package gives you the `webjs` command.
@@ -17,17 +17,24 @@ Then scaffold a new app anywhere:
 
 ```sh
 webjs create my-app
-cd my-app && npm install && npm run dev
+cd my-app && npm run dev
 # → http://localhost:3000
 ```
 
-One-shot without global install:
+One-shot without a global install, two ways:
 
 ```sh
+# Preferred: the npx-discoverable scaffolder
+npx create-webjs-app@latest my-app
+cd my-app && npm run dev
+
+# Or via the CLI's npx entry directly
 npx @webjsdev/cli create my-app
-cd my-app && npm install && npm run dev
+cd my-app && npm run dev
 ```
 
+Both `webjs create` and `create-webjs-app` auto-install dependencies in the new directory using your detected package manager (npm / pnpm / yarn / bun). Pass `--no-install` to opt out.
+
 ## Commands
 
 ```sh
@@ -64,7 +71,7 @@ The scaffold seeds opinionated defaults so AI agents produce consistent code:
 - Tailwind CSS via CLI (no browser runtime at build time)
 - TypeScript, `.editorconfig`, `.gitignore`
 
-See the full framework docs at https://github.com/vivek7405/webjs.
+See the full framework docs at https://github.com/webjsdev/webjs.
 
 ## License
 

package/bin/webjs.js

@@ -16,8 +16,10 @@ const USAGE = `webjs commands:
   webjs start [--port 3000]                       Start production server (serves source directly, no build step)
   webjs test  [--server|--browser]                 Run server + browser tests
   webjs check                                     Validate app against conventions
-  webjs create <name> [--template full-stack|api|saas]  Scaffold a new webjs app
+  webjs create <name> [--template full-stack|api|saas] [--no-install]  Scaffold a new webjs app
                                                   (only 3 templates exist. default: full-stack with Prisma+SQLite)
+                                                  Auto-runs the detected package manager's install in the new dir
+                                                  unless --no-install is passed.
   webjs db generate                               Run \`prisma generate\`
   webjs db migrate [name]                         Run \`prisma migrate dev\`
   webjs db studio                                 Run \`prisma studio\`
@@ -259,8 +261,9 @@ files.
 Full docs: https://docs.webjs.com`);
         process.exit(1);
       }
+      const noInstall = rest.includes('--no-install');
       const { scaffoldApp } = await import('../lib/create.js');
-      await scaffoldApp(name, process.cwd(), { template });
+      await scaffoldApp(name, process.cwd(), { template, install: !noInstall });
       break;
     }
     case 'help':

package/lib/create.js

@@ -15,6 +15,37 @@ import { mkdir, writeFile, readFile, cp } from 'node:fs/promises';
 import { join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+
+/**
+ * Detect which package manager invoked us. Reads `npm_config_user_agent`,
+ * which npm / pnpm / yarn / bun all set when running scripts or `npx`.
+ * Falls back to `npm` when nothing is detected (matches what most users
+ * actually have installed).
+ *
+ * @returns {'npm'|'pnpm'|'yarn'|'bun'}
+ */
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || '';
+  if (ua.startsWith('pnpm/')) return 'pnpm';
+  if (ua.startsWith('yarn/')) return 'yarn';
+  if (ua.startsWith('bun/')) return 'bun';
+  return 'npm';
+}
+
+/**
+ * Run `<pm> install` inside the scaffolded app. Returns true on success.
+ * Inherits stdio so the user sees the install progress live. Caller decides
+ * whether to call this (skipped when --no-install).
+ *
+ * @param {string} appDir absolute path to the new app
+ * @param {'npm'|'pnpm'|'yarn'|'bun'} pm
+ * @returns {boolean}
+ */
+function runInstall(appDir, pm) {
+  const r = spawnSync(pm, ['install'], { cwd: appDir, stdio: 'inherit' });
+  return r.status === 0;
+}
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES = resolve(__dirname, '..', 'templates');
@@ -142,6 +173,11 @@ async function readThemeCss() {
  */
 export async function scaffoldApp(name, cwd, opts = {}) {
   const template = opts.template || 'full-stack';
+  // `install` is opt-in at the library level (so tests + programmatic
+  // callers get a side-effect-free scaffold by default). The CLI entry
+  // points (`webjs create` and `npx create-webjs-app`) explicitly set
+  // `install: true` unless the user passes `--no-install`.
+  const shouldInstall = opts.install === true;
   // Defence in depth. The CLI already validates this, but library
   // callers (tests, programmatic use) might pass anything.
   const VALID_TEMPLATES = ['full-stack', 'api', 'saas'];
@@ -855,20 +891,39 @@ ThemeToggle.register('theme-toggle');
     CONVENTIONS.md, AGENTS.md, CLAUDE.md
 `);
   }
-  // Post-scaffold guidance. The full-stack and saas templates ship with
-  // @webjsdev/ui already initialised (components.json, lib/utils/cn.ts, the
-  // standard kit under components/ui/), so the user only runs `webjs dev`.
-  // The api template has no UI; we only mention `webjs ui` in case the
-  // user later adds one.
+  // Auto-install (default). Detect the package manager from the env so
+  // pnpm / yarn / bun users get their own. Pass `--no-install` (or
+  // `{ install: false }` to scaffoldApp) to opt out, e.g. for CI tests
+  // that exercise the scaffold without paying the install cost.
+  const pm = detectPackageManager();
+  let installed = false;
+  if (shouldInstall) {
+    console.log(`\nRunning '${pm} install' in ${name}/ ...\n`);
+    installed = runInstall(appDir, pm);
+    if (!installed) {
+      console.log(`\n[warn] ${pm} install failed. Run '${pm} install' manually in ${name}/ to finish setup.\n`);
+    }
+  }
+
+  // Post-scaffold guidance. Lead with a single copy-paste line so the
+  // user can move from "scaffold done" to "dev server up" in one
+  // command. The full-stack and saas templates ship with @webjsdev/ui
+  // already initialised; the api template has no UI but may add one
+  // later. Saas needs a one-time prisma migrate before the first run
+  // (the example User model wants its table to exist).
+  const installSegment = installed ? '' : `${pm} install && `;
+  const prismaSegment = isSaas ? `npx prisma migrate dev --name init && ` : '';
+  const runCommand = `cd ${name} && ${installSegment}${prismaSegment}${pm} run dev`;
   const uiNote = isApi
     ? `# If you later add a UI to this API project:
-  #   webjs ui init && webjs ui add button card dialog`
-    : `webjs ui add <name>     # optional: add more ui-* components later`;
+  #   npx webjs ui init && npx webjs ui add button card dialog`
+    : `npx webjs ui add <name>     # add more ui-* components later`;
   console.log(`Next steps:
-  cd ${name}
-  npm install${isSaas ? '\n  npx prisma migrate dev --name init' : ''}
+  ${runCommand}
+  # → http://localhost:3000
+
+Optional:
   ${uiNote}
-  webjs dev
 
 AI-driven development (enforced for all AI agents):
   ✓ Tests auto-generated with every feature

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webjsdev/cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "type": "module",
   "description": "webjs CLI - dev, start, create, db",
   "bin": {
@@ -21,11 +21,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vivek7405/webjs.git",
+    "url": "git+https://github.com/webjsdev/webjs.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/vivek7405/webjs#readme",
-  "bugs": "https://github.com/vivek7405/webjs/issues",
+  "homepage": "https://github.com/webjsdev/webjs#readme",
+  "bugs": "https://github.com/webjsdev/webjs/issues",
   "license": "MIT",
   "keywords": [
     "webjs",

package/templates/AGENTS.md

@@ -2,7 +2,7 @@
 
 Read this before editing any file. This is a webjs app: AI-first, web-
 components-first, no build step. The framework's own full API reference
-lives at https://github.com/vivek7405/webjs/blob/main/AGENTS.md and the
+lives at https://github.com/webjsdev/webjs/blob/main/AGENTS.md and the
 full hosted documentation (every API, recipe, and example) lives at
 **https://docs.webjs.com**. Treat this file as the app-scoped
 companion and reach for docs.webjs.com whenever you need more detail.
@@ -483,7 +483,7 @@ Practical consequences for agents writing webjs code.
 
 The full annotated catalog with code examples lives in the framework
 repo at
-[`agent-docs/lit-muscle-memory-gotchas.md`](https://github.com/vivek7405/webjs/blob/main/agent-docs/lit-muscle-memory-gotchas.md).
+[`agent-docs/lit-muscle-memory-gotchas.md`](https://github.com/webjsdev/webjs/blob/main/agent-docs/lit-muscle-memory-gotchas.md).
 
 ## Server action pattern