create-backtick-app 0.1.1 → 0.1.3

package/dist/index.js

@@ -25,25 +25,52 @@ const TEMPLATES = {
         then: "Then open http://localhost:3000. Edit server/Home.tsx and save to see the page change.",
     },
 };
-const { values, positionals } = parseArgs({
-    allowPositionals: true,
-    options: {
-        template: { type: "string", short: "t" },
-        runtime: { type: "string", short: "r" },
-        yes: { type: "boolean", short: "y" },
-        "no-install": { type: "boolean" },
-    },
-});
-if (values.template !== undefined && !(values.template in TEMPLATES)) {
-    console.error(`There's no template named ${values.template}. Pick one of: ${Object.keys(TEMPLATES).join(", ")}.`);
-    process.exit(1);
-}
 // What runs your Backtick server, and the loader that compiles it for that
 // runtime.
 const RUNTIMES = {
     node: { title: "Node", loader: "@backtickjs/node-plugin" },
     bun: { title: "Bun", loader: "@backtickjs/bun-plugin" },
 };
+const USAGE = `Usage: create-backtick-app [name] [options]
+
+Options:
+  -t, --template <name>  The framework: ${Object.keys(TEMPLATES).join(", ")}
+  -r, --runtime <name>   The server's runtime: ${Object.keys(RUNTIMES).join(", ")}
+  -y, --yes              Use the defaults for anything not given
+  --no-install           Skip installing packages
+  -h, --help             Show this help
+
+Asks for what isn't given, in a terminal; elsewhere, uses the defaults:
+my-app, react-native, and node (bun when run with bun).`;
+let parsed;
+try {
+    parsed = parseArgs({
+        allowPositionals: true,
+        options: {
+            template: { type: "string", short: "t" },
+            runtime: { type: "string", short: "r" },
+            yes: { type: "boolean", short: "y" },
+            "no-install": { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+}
+catch (error) {
+    // Node's first sentence, as "Unknown option '--framework'.", without its
+    // advice on positional arguments.
+    const [problem] = error.message.split(". ");
+    console.error(`${problem.replace(/\.?$/, ".")}\n\n${USAGE}`);
+    process.exit(1);
+}
+const { values, positionals } = parsed;
+if (values.help) {
+    console.log(USAGE);
+    process.exit(0);
+}
+if (values.template !== undefined && !(values.template in TEMPLATES)) {
+    console.error(`There's no template named ${values.template}. Pick one of: ${Object.keys(TEMPLATES).join(", ")}.`);
+    process.exit(1);
+}
 if (values.runtime !== undefined && !(values.runtime in RUNTIMES)) {
     console.error(`There's no runtime named ${values.runtime}. Pick one of: ${Object.keys(RUNTIMES).join(", ")}.`);
     process.exit(1);
@@ -53,16 +80,18 @@ if (values.runtime !== undefined && !(values.runtime in RUNTIMES)) {
 const manager = (process.env.npm_config_user_agent ?? "npm").split("/")[0];
 const run = ["npm", "pnpm", "yarn", "bun"].includes(manager) ? manager : "npm";
 const suggestedRuntime = run === "bun" ? "bun" : "node";
-// Asked only what the command line didn't say, as `create-expo-app` asks.
+// Asked only what the command line didn't say, and only in a terminal: an
+// agent or a CI script can't answer, so it gets the defaults, as `--yes` does.
+const ask = process.stdin.isTTY === true && !values.yes;
 const answers = await prompts([
     {
-        type: positionals[0] !== undefined || values.yes ? null : "text",
+        type: positionals[0] !== undefined || !ask ? null : "text",
         name: "name",
         message: "What is your app named?",
         initial: "my-app",
     },
     {
-        type: values.template !== undefined || values.yes ? null : "select",
+        type: values.template !== undefined || !ask ? null : "select",
         name: "template",
         message: "Which framework?",
         choices: Object.entries(TEMPLATES).map(([value, template]) => ({
@@ -72,7 +101,7 @@ const answers = await prompts([
         })),
     },
     {
-        type: values.runtime !== undefined || values.yes ? null : "select",
+        type: values.runtime !== undefined || !ask ? null : "select",
         name: "runtime",
         message: "Which runtime?",
         choices: Object.entries(RUNTIMES).map(([value, runtime]) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-backtick-app",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Creates a Backtick app: React Native, React or Solid, with screens from your server on Node or Bun",
   "keywords": [
     "backtick",

package/templates/react/package.json

@@ -11,15 +11,15 @@
     "format:check": "prettier --check --ignore-unknown ."
   },
   "dependencies": {
-    "@backtickjs/bundler": "^0.1.1",
-    "@backtickjs/core": "^0.1.1",
-    "@backtickjs/node-plugin": "^0.1.1",
+    "@backtickjs/bundler": "^0.1.3",
+    "@backtickjs/core": "^0.1.3",
+    "@backtickjs/node-plugin": "^0.1.3",
     "@backtickjs/react": "^19.2.3",
     "typescript": "^6.0.3"
   },
   "devDependencies": {
-    "@backtickjs/prettier-plugin": "^0.1.1",
-    "@backtickjs/tsc": "^0.1.1",
+    "@backtickjs/prettier-plugin": "^0.1.3",
+    "@backtickjs/tsc": "^0.1.3",
     "@types/node": "^25.9.1",
     "prettier": "^3.6.2"
   },

package/templates/react-native/package.json

@@ -14,12 +14,12 @@
     "format:check": "prettier --check --ignore-unknown ."
   },
   "dependencies": {
-    "@backtickjs/bundler": "^0.1.1",
-    "@backtickjs/core": "^0.1.1",
-    "@backtickjs/node-plugin": "^0.1.1",
+    "@backtickjs/bundler": "^0.1.3",
+    "@backtickjs/core": "^0.1.3",
+    "@backtickjs/node-plugin": "^0.1.3",
     "@backtickjs/react": "^19.2.3",
     "@backtickjs/react-native": "^0.86.3",
-    "@backtickjs/react-native-client": "^0.1.1",
+    "@backtickjs/react-native-client": "^0.1.3",
     "expo": "~57.0.26",
     "expo-constants": "~57.0.20",
     "expo-status-bar": "~57.0.1",
@@ -30,8 +30,8 @@
     "typescript": "^6.0.3"
   },
   "devDependencies": {
-    "@backtickjs/prettier-plugin": "^0.1.1",
-    "@backtickjs/tsc": "^0.1.1",
+    "@backtickjs/prettier-plugin": "^0.1.3",
+    "@backtickjs/tsc": "^0.1.3",
     "@types/node": "^25.9.1",
     "@types/react": "19.2.18",
     "prettier": "^3.6.2"

package/templates/solid-js/package.json

@@ -11,15 +11,15 @@
     "format:check": "prettier --check --ignore-unknown ."
   },
   "dependencies": {
-    "@backtickjs/bundler": "^0.1.1",
-    "@backtickjs/core": "^0.1.1",
-    "@backtickjs/node-plugin": "^0.1.1",
+    "@backtickjs/bundler": "^0.1.3",
+    "@backtickjs/core": "^0.1.3",
+    "@backtickjs/node-plugin": "^0.1.3",
     "@backtickjs/solid-js": "^1.9.14",
     "typescript": "^6.0.3"
   },
   "devDependencies": {
-    "@backtickjs/prettier-plugin": "^0.1.1",
-    "@backtickjs/tsc": "^0.1.1",
+    "@backtickjs/prettier-plugin": "^0.1.3",
+    "@backtickjs/tsc": "^0.1.3",
     "@types/node": "^25.9.1",
     "prettier": "^3.6.2"
   },