create-tw-framework 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TW Framework Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# Create TW App
+
+The easiest way to get started with [TW Framework](https://github.com/tw-origin/tw-framework) is by using `create-tw-framework`. This CLI tool enables you to quickly start building a new TW application, with everything set up for you — project scaffold, git repository and installed dependencies.
+
+To get started, use the following command:
+
+```
+npx create-tw-framework@latest my-app
+# or
+npm create tw-app@latest my-app
+# or
+yarn create tw-app my-app
+# or
+pnpm create tw-app my-app
+# or
+bunx create-tw-framework my-app
+```
+
+You can also pass command line arguments to set up a new project non-interactively. See `create-tw-framework --help`:
+
+```
+Usage: create-tw-framework [project-directory] [options]
+
+Options:
+  -V, --version          output the version number
+  --template <name>      scaffold with a specific template
+  --skip-install         skip installing packages
+  --disable-git          skip initializing a git repository
+  -h, --help             display help for command
+```
+
+## Why use Create TW App?
+
+`create-tw-framework` lets you create a new TW app within seconds. It is officially maintained by the creators of TW Framework, and includes a number of benefits:
+
+- **Zero Configuration**: No configuration needed — the scaffold is complete, correct and buildable the moment it lands.
+- **Sensible Defaults**: `tw dev`, `tw build` and `tw serve` scripts are wired into the generated `package.json` from the start.
+- **Git Ready**: A fresh git repository is initialized in your project automatically (skip with `--disable-git`).
+- **Installs For You**: Dependencies are installed as part of creation (skip with `--skip-install`).
+- **Same Tool, One Command**: `create-tw-framework` runs the same `tw create` command shipped inside TW Framework, so the scaffold is always in sync with the version you install.
+
+## Manual Installation
+
+You can also create a project manually:
+
+```
+npm install tw-framework
+npx tw create my-app
+```
+
+Then run `npm run dev` inside the new project to start the development server.
+
+## Feedback
+
+Issues and feature requests belong in the [TW Framework repository](https://github.com/tw-origin/tw-framework/issues).

package/dist/create.mjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * create-tw-framework — the fastest way to start a TW Framework project.
+ *
+ * npx create-tw-framework@latest my-app
+ * npm create tw-app@latest my-app
+ * yarn create tw-app my-app
+ * pnpm create tw-app my-app
+ * bunx create-tw-framework my-app
+ *
+ * This package is a thin, dependency-free launcher: it resolves the
+ * installed `tw-framework` CLI and runs `tw create` with the given
+ * arguments — scaffold, git init and dependency install included.
+ */
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const args = process.argv.slice(2);
+
+function printVersion() {
+  let version = "1.0.0";
+  try {
+    version = require("../package.json").version;
+  } catch {
+    /* fall back to the constant */
+  }
+  process.stdout.write(`create-tw-framework ${version}\n`);
+}
+
+function printHelp() {
+  process.stdout.write(
+    `
+Usage: create-tw-framework [project-directory] [options]
+
+Options:
+  -V, --version          output the version number
+  --template <name>      scaffold with a specific template
+  --skip-install         skip installing packages
+  --disable-git          skip initializing a git repository
+  -h, --help             display help for command
+
+Examples:
+  npx create-tw-framework@latest my-app
+  npm create tw-app@latest my-app
+
+Everything after the project directory is passed to \`tw create\`.
+`
+  );
+}
+
+if (args.includes("-V") || args.includes("--version")) {
+  printVersion();
+  process.exit(0);
+}
+if (args.includes("-h") || args.includes("--help")) {
+  printHelp();
+  process.exit(0);
+}
+
+let binPath;
+try {
+  const pkgJsonPath = require.resolve("tw-framework/package.json");
+  const pkg = require(pkgJsonPath);
+  const bin = pkg.bin && (pkg.bin.tw || pkg.bin["tw-framework"]);
+  if (!bin) throw new Error("tw-framework has no tw bin");
+  binPath = join(dirname(pkgJsonPath), bin);
+} catch {
+  process.stderr.write(
+    "\n  Could not resolve the tw-framework CLI.\n" +
+      "  Install it alongside this package and try again:\n" +
+      "    npm install create-tw-framework\n" +
+      "    npx create-tw-framework my-app\n\n"
+  );
+  process.exit(1);
+}
+
+const child = spawn(process.execPath, [binPath, "create", ...args], {
+  stdio: "inherit",
+});
+child.on("exit", (code) => process.exit(code ?? 1));
+child.on("error", () => process.exit(1));

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "create-tw-framework",
+  "version": "1.0.0",
+  "description": "The easiest way to get started with TW Framework — scaffolds a complete, ready-to-run TW application in seconds.",
+  "bin": {
+    "create-tw-framework": "./dist/create.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tw",
+    "tw-framework",
+    "create",
+    "scaffold",
+    "cli",
+    "framework",
+    "ssr",
+    "streaming",
+    "web"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tw-origin/tw-framework.git"
+  },
+  "homepage": "https://github.com/tw-origin/tw-framework#readme",
+  "bugs": {
+    "url": "https://github.com/tw-origin/tw-framework/issues"
+  },
+  "author": "Mlk Raj",
+  "license": "MIT",
+  "dependencies": {
+    "tw-framework": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}