create-playcanvas 0.0.2-beta.0

package/README.md

@@ -0,0 +1,75 @@
+# Create a PlayCanvas project in seconds
+
+`create playcanvas` spins up a ready-to-code PlayCanvas workspace in seconds, complete with modern tooling and opinionated defaults. Pick a template, answer a few prompts (or skip them with flags) and you're ready to `npm run dev`.
+
+## 📦 Usage
+
+You don't install anything globally – just run the CLI with your favourite package manager:
+
+```bash
+# npm (recommended)
+npm create playcanvas@latest
+
+# pnpm
+pnpm create playcanvas
+
+# yarn
+yarn create playcanvas
+
+# bun
+bun create playcanvas
+```
+
+The CLI will prompt you for:
+
+1. **Project name** – folder to create (defaults to `playcanvas-project`).
+2. **Overwrite behavior** if the folder exists.
+3. **Package name** – used in `package.json`.
+4. **Framework & variant** – pick from templates below.
+5. **Scaffolding** – project files are copied and tweaked; a final cheat-sheet is printed.
+
+### Non-interactive / flags
+
+Skip the questions when scripting or if you know what you want:
+
+```bash
+npm create playcanvas@latest my-game -t react-ts --overwrite
+```
+
+Flags:
+
+| Flag                         | Shorthand | Description                                          |
+| ---------------------------- | --------- | ---------------------------------------------------- |
+| `--template <name>`          | `-t`      | Directly choose template variant (see list below).   |
+| `--overwrite`                |           | Remove existing files in target directory.           |
+| `--help`                     | `-h`      | Show help/usage information.                         |
+
+## 🎨 Templates
+
+(TBD)
+
+| Template     | Description                 |
+| ------------ | --------------------------- |
+| `vanilla`    | Plain JavaScript PlayCanvas |
+| `react-ts`   | React + TypeScript + Vite   |
+
+_To add your own template, drop a folder in `templates/<name>` and it will be auto-detected._
+
+## 🛠 Development
+
+Clone the repo, then:
+
+```bash
+npm install     # or npm, yarn, bun
+npm run dev     # compile TypeScript → dist (if needed)
+npm link        # you can now run `npx create-playcanvas` to test 
+```
+
+## 🤝 Contributing
+
+Bug reports, feature requests and PRs are welcome! Want to create a new template? Please file an issue first if you plan major changes.
+
+1. Fork / clone.
+2. Create a branch: `git checkout -b feat/my-awesome-idea`.
+3. Commit with conventional-commit messages.
+4. Push and open a PR.

package/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import './dist/index.mjs'

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-playcanvas",
+  "author": "Mark Lundin",
+  "version": "0.0.2-beta.0",
+  "description": "Scaffold a PlayCanvas project",
+  "type": "module",
+  "bin": {
+    "create-playcanvas": "index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "scripts": {
+    "dev": "unbuild --stub",
+    "build": "unbuild",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "ISC",
+  "devDependencies": {
+    "@clack/prompts": "^0.10.0",
+    "@types/node": "^22.13.10",
+    "cross-spawn": "^7.0.6",
+    "mri": "^1.2.0",
+    "picocolors": "^1.1.1",
+    "unbuild": "^3.5.0"
+  },
+  "engines": {
+    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}