@joinbankroll/create-app 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# @joinbankroll/create-app
+
+Scaffold a [Built for Bankroll](https://joinbankroll.com/build) app.
+
+```bash
+npm create @joinbankroll/app@latest my-app
+cd my-app
+npm run bankroll
+```
+
+`npm run bankroll` raises a public tunnel and prints a QR code. Scan it and your
+app opens inside Bankroll on your phone, which is the only place it runs — the
+host holds the user's money, identity, and location, and refuses any origin that
+is not public HTTPS.
+
+## What it does
+
+Downloads [bankroll-starter](https://github.com/inplayinnovation/bankroll-starter),
+writes `.env.local`, installs dependencies, and makes the first commit.
+
+```
+-t, --template <ref>   template branch or tag (default: main)
+```
+
+## What you get
+
+An app with its own git history and no upstream remote, the same as
+`create-next-app`. There is nothing to merge back later: everything that is not
+your app comes from `@joinbankroll/sdk` and `bankroll-cli`, and updates with
+`npm update`.
+
+`.env.local` holds configuration only — `STORE=fs` and your app's name. The
+signing key belongs to `bankroll dev`, which keeps it in
+`~/.config/bankroll/keypair.json` and injects it into the dev server's
+environment, so no secret is ever written into your project.

package/dist/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { spawnSync } from "child_process";
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from "fs";
+import { basename, resolve } from "path";
+import { createInterface } from "readline/promises";
+var TEMPLATE_REPO = "inplayinnovation/bankroll-starter";
+var DEFAULT_REF = "main";
+var DOWNLOAD_TIMEOUT_MS = 6e4;
+var ENV_FILE = ".env.local";
+var IGNORABLE = /* @__PURE__ */ new Set([".DS_Store", ".git", ".gitkeep", ".idea", ".vscode", "Thumbs.db"]);
+function parse(argv) {
+  const args = { ref: DEFAULT_REF, help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--help" || arg === "-h") args.help = true;
+    else if (arg === "--template" || arg === "-t") args.ref = argv[++i] ?? DEFAULT_REF;
+    else if (arg?.startsWith("-")) throw new Error(`Unknown option ${arg}`);
+    else if (arg && !args.directory) args.directory = arg;
+  }
+  return args;
+}
+function usage() {
+  console.log(`
+  Create a Built for Bankroll app.
+
+    npm create @joinbankroll/app@latest my-app
+
+  Options
+    -t, --template <ref>   template branch or tag (default: ${DEFAULT_REF})
+    -h, --help             show this
+`);
+}
+async function ask(question, fallback) {
+  if (!process.stdin.isTTY) return fallback;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return (await rl.question(`  ${question} (${fallback}): `)).trim() || fallback;
+  } finally {
+    rl.close();
+  }
+}
+function run(command, args, cwd) {
+  const result = spawnSync(command, args, { cwd, stdio: "inherit" });
+  if (result.error) throw result.error;
+  if (result.status !== 0) throw new Error(`${command} ${args.join(" ")} failed`);
+}
+function tryRun(command, args, cwd) {
+  const result = spawnSync(command, args, { cwd, stdio: "ignore" });
+  return !result.error && result.status === 0;
+}
+async function download(ref, into) {
+  const url = `https://codeload.github.com/${TEMPLATE_REPO}/tar.gz/${ref}`;
+  const response = await fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+  if (!response.ok) {
+    throw new Error(
+      response.status === 404 ? `No template named "${ref}" \u2014 check --template.` : `Could not download the template (${response.status}).`
+    );
+  }
+  const archive = resolve(into, ".template.tar.gz");
+  writeFileSync(archive, Buffer.from(await response.arrayBuffer()));
+  try {
+    run("tar", ["-xzf", archive, "--strip-components=1"], into);
+  } finally {
+    rmSync(archive, { force: true });
+  }
+}
+async function main() {
+  const args = parse(process.argv.slice(2));
+  if (args.help) return usage();
+  const directory = args.directory ?? await ask("Directory", "my-bankroll-app");
+  const target = resolve(process.cwd(), directory);
+  let created = false;
+  if (existsSync(target)) {
+    const existing = readdirSync(target).filter((entry) => !IGNORABLE.has(entry));
+    if (existing.length > 0) throw new Error(`${directory} is not empty.`);
+  } else {
+    mkdirSync(target, { recursive: true });
+    created = true;
+  }
+  const name = await ask("App name", basename(target));
+  console.log(`
+  Downloading the template\u2026`);
+  try {
+    await download(args.ref, target);
+  } catch (error) {
+    if (created && readdirSync(target).length === 0) rmSync(target, { recursive: true, force: true });
+    throw error;
+  }
+  writeFileSync(
+    resolve(target, ENV_FILE),
+    [
+      "# Written by create-bankroll-app. Gitignored, so none of it reaches a",
+      "# deployment.",
+      "",
+      "# Store state in local files rather than Vercel Blob, so this app runs",
+      "# without a Vercel account. A deployment has no STORE and uses Blob.",
+      "STORE=fs",
+      "",
+      "# Shown when someone connects the app.",
+      `BANKROLL_APP_NAME=${name}`,
+      ""
+    ].join("\n")
+  );
+  console.log(`  Installing dependencies\u2026
+`);
+  run("npm", ["install"], target);
+  if (tryRun("git", ["init", "-q"], target)) {
+    tryRun("git", ["add", "-A"], target);
+    tryRun("git", ["commit", "-qm", "Initial commit from create-bankroll-app"], target);
+  }
+  console.log(`
+  ${name} is ready.
+
+    cd ${directory}
+    npm run bankroll     tunnel + QR \u2014 scan it to open the app inside Bankroll
+
+  Your app runs inside Bankroll, so a phone is how you see it. Everything that
+  is not your app comes from @joinbankroll/sdk and updates with npm update.
+`);
+}
+if (process.argv[1] && import.meta.url.endsWith(basename(process.argv[1]))) {
+  try {
+    await main();
+  } catch (error) {
+    console.error(`
+  ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exit(1);
+  }
+}
+export {
+  IGNORABLE,
+  parse
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@joinbankroll/create-app",
+  "version": "0.1.0",
+  "description": "Create a Built for Bankroll app",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inplayinnovation/create-bankroll-app.git"
+  },
+  "homepage": "https://joinbankroll.com/build",
+  "type": "module",
+  "bin": {
+    "create-bankroll-app": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.6"
+  },
+  "keywords": [
+    "bankroll",
+    "solana",
+    "create"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}