create-webjs 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# create-webjs
+
+Scaffold a new [webjs](https://webjs.dev) app with one command, no global install required.
+
+```sh
+npm create webjs@latest my-app
+cd my-app && npm run dev
+# → http://localhost:3000
+```
+
+`npm create webjs@latest` is npm's documented shorthand for `npx create-webjs@latest`; both routes dispatch to this same package. Under the hood it calls [`@webjsdev/cli`](https://www.npmjs.com/package/@webjsdev/cli)'s `scaffoldApp()` and auto-runs the detected package manager's install in the new directory.
+
+## Templates
+
+```sh
+npm create webjs@latest my-app                       # default: full-stack (pages + components + API + Prisma/SQLite)
+npm create webjs@latest my-api  -- --template api    # backend-only (route handlers + modules, no SSR/UI)
+npm create webjs@latest my-saas -- --template saas   # auth + login/signup + protected dashboard + Prisma User model
+```
+
+(The `--` separator before flags is npm's pass-through convention. Plain `npx create-webjs@latest my-app --template api` works without the separator.)
+
+Only three templates exist; the CLI rejects anything else.
+
+## Options
+
+| Flag | Default | Meaning |
+|---|---|---|
+| `--template <full-stack \| api \| saas>` | `full-stack` | Pick the scaffold variant. |
+| `--no-install` | install runs | Skip the post-scaffold `<pm> install`. |
+| `-h`, `--help` | | Show help. |
+
+The package manager is detected from `npm_config_user_agent`: pnpm / yarn / bun users get their own.
+
+## Relationship to `@webjsdev/cli`
+
+`create-webjs` is a thin scaffolding wrapper. The full CLI lives in [`@webjsdev/cli`](https://www.npmjs.com/package/@webjsdev/cli) (and its unscoped mirror [`webjsdev`](https://www.npmjs.com/package/webjsdev)), which installs globally to give you `webjs dev`, `webjs start`, `webjs create`, `webjs test`, `webjs check`, `webjs db`, and `webjs ui`. After scaffolding, `webjs <cmd>` is available locally via the new app's `node_modules/.bin`, and globally if you've run `npm i -g @webjsdev/cli` or `npm i -g webjsdev`.
+
+## License
+
+MIT

package/bin/create-webjs.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+/**
+ * `create-webjs` is the `npx` / `npm create` entry point for scaffolding a
+ * webjs app.
+ *
+ *   npm create webjs@latest my-app
+ *   npx create-webjs@latest my-app
+ *   npm create webjs@latest my-api  -- --template api
+ *   npm create webjs@latest my-saas -- --template saas --no-install
+ *
+ * This is a thin wrapper around `@webjsdev/cli`'s `scaffoldApp()`. Behaviour
+ * matches `webjs create` exactly, including auto-install (npm / pnpm / yarn /
+ * bun, detected from `npm_config_user_agent`). Pass `--no-install` to opt out.
+ *
+ * The package mirrors the create-next-app / create-react-app / create-astro
+ * pattern so the homepage hero is a single command and users don't need a
+ * global install of `@webjsdev/cli` to start. The `npm create <suffix>` form
+ * is npm's documented shorthand for `npx create-<suffix>`; both routes
+ * resolve to this same package and bin.
+ */
+import { scaffoldApp } from '@webjsdev/cli/lib/create.js';
+
+const TEMPLATES = ['full-stack', 'api', 'saas'];
+
+const args = process.argv.slice(2);
+
+function flagValue(name) {
+  const i = args.indexOf(name);
+  if (i === -1) return undefined;
+  return args[i + 1];
+}
+
+const usage = `Usage:
+  npm create webjs@latest <app-name> [-- --template full-stack|api|saas] [-- --no-install]
+  npx create-webjs@latest <app-name> [--template full-stack|api|saas] [--no-install]
+
+Templates:
+  full-stack (default)  pages + components + API + Prisma/SQLite
+  api                   route handlers + modules, no SSR/UI
+  saas                  auth + login/signup + protected dashboard + Prisma User model
+
+Options:
+  --no-install          skip running the package manager's install in the new directory
+  -h, --help            show this help`;
+
+if (args.length === 0 || args.includes('-h') || args.includes('--help')) {
+  console.log(usage);
+  process.exit(args.length === 0 ? 1 : 0);
+}
+
+const positional = args.filter((a) => !a.startsWith('-'));
+const name = positional[0];
+if (!name) {
+  console.error('Error: <app-name> is required.\n');
+  console.error(usage);
+  process.exit(1);
+}
+
+const template = flagValue('--template') || 'full-stack';
+if (!TEMPLATES.includes(template)) {
+  console.error(`Error: unknown template '${template}'. Only ${TEMPLATES.join(' / ')} are supported.\n`);
+  console.error(usage);
+  process.exit(1);
+}
+
+const noInstall = args.includes('--no-install');
+
+await scaffoldApp(name, process.cwd(), { template, install: !noInstall });

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-webjs",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Scaffold a new webjs app. `npm create webjs@latest my-app`.",
+  "bin": {
+    "create-webjs": "bin/create-webjs.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "@webjsdev/cli": "^0.8.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webjsdev/webjs.git",
+    "directory": "packages/create-webjs"
+  },
+  "homepage": "https://github.com/webjsdev/webjs#readme",
+  "bugs": "https://github.com/webjsdev/webjs/issues",
+  "license": "MIT",
+  "keywords": [
+    "webjs",
+    "create",
+    "scaffold",
+    "starter",
+    "framework"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}