create-eigen-game 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eigen Interactive
+
+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,80 @@
+# create-eigen-game
+
+Creates one repository containing an Eigen Cloudflare Worker and Flutter app:
+
+```sh
+pnpm create eigen-game my-game
+# or
+npm create eigen-game@latest my-game
+```
+
+The command detects npm or pnpm from the invoking package manager. Pass
+`--package-manager npm|pnpm` to override it and `--org games.example` to set
+the Flutter organization. The destination basename is the one required
+lowercase kebab-case slug. The CLI derives the display name (`My Game`), Dart
+package name (`my_game`), and type prefix (`MyGame`) from `my-game`; there is no
+separate name or prefix input.
+
+The generated project has two application-owned halves:
+
+```text
+my-game/
+├── server/   # authoritative TypeScript rules and Cloudflare Worker
+└── app/      # generated Dart payloads and handwritten Flutter presentation
+```
+
+The scaffolder creates the Flutter shell explicitly for Android and web,
+installs both halves, emits `server/game-contract.json`, and
+generates the initial Dart payload types and typed rules base. Engine
+repositories remain ordinary npm/pub.dev dependencies and are not cloned.
+It also supplies a starter v1 twin fixture, a Vitest runner, a Flutter fixture
+runner, watch-mode rules tests, and generated-contract drift checks. At the
+generated repository root, `pnpm run contract` (or `npm run contract`) emits
+the TypeScript contract and regenerates the Dart payloads in one command;
+`contract:check` checks both artifacts without rewriting them.
+
+`pnpm run deploy` (or npm) is similarly whole-project: it builds Flutter web
+into the Worker's Static Assets directory, applies D1 migrations, and deploys
+one same-origin Worker. The Flutter app lives at `/`; the generated native
+install page lives at `/download`. Both Android and web builds read the same
+public values from `app/app-config.json` through Flutter's native
+`--dart-define-from-file` support.
+
+## Template architecture
+
+`templates/worker` is a valid standalone Cloudflare C3-style Worker template:
+it contains its own `package.json`, `wrangler.jsonc`, TypeScript entry point,
+generated Wrangler types, and game module. The combined Eigen CLI renders that
+same template under `server/`; it does not maintain a second Worker skeleton.
+
+`templates/app-overlay` is applied after
+`flutter create --empty --platforms android,web`. It supplies the Firebase
+Messaging service worker, the narrowly scoped Flutter bootstrap that registers
+it before app startup, and one setup command that runs FlutterFire and derives
+the worker's public Firebase configuration from the Web app FlutterFire
+selected. Implementors never copy those identifiers into JavaScript by hand.
+`eigen_flutter` bundles and loads the Cropper.js assets required by
+`image_cropper` on web, so generated apps do not carry their own copy or
+configure `web/index.html`.
+On Android, `eigen_flutter` supplies FID messaging configuration through its
+plugin manifest and native dependency graph; the scaffolder does not edit the
+application manifest or `gradle.properties`. It adds the application-level core
+library desugaring block required by `flutter_local_notifications`, because an
+Android library cannot supply that compiler setting transitively. The CLI then
+uses `flutter pub add` and the public
+`eigen_flutter:generate_payloads` executable instead of editing Flutter's
+generated YAML by hand.
+
+The public CLI intentionally has no server-only or app-only modes.
+
+The Worker directly depends on both `@eigeninteractive/rules` and
+`@eigeninteractive/server`. Rules is the pure contract the game implements and
+the shared peer identity used by server/kernel/testkit; server is the
+Cloudflare runtime. Server deliberately does not re-export the rules surface.
+
+## Documentation
+
+- [Quickstart](https://eigeninteractive.com/docs/getting-started/quickstart)
+- [Manual setup and split repositories](https://eigeninteractive.com/docs/getting-started/manual-setup)
+- [Deploy the web app](https://eigeninteractive.com/docs/ship-it/deploy-the-web-app)
+- [The game contract](https://eigeninteractive.com/docs/build-a-game/the-contract)

package/dist/chunk-BSJVRXI4.js

@@ -0,0 +1,127 @@
+// src/index.ts
+import { execFileSync } from "child_process";
+import { appendFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "fs";
+import { basename, dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+var templatesRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../templates");
+var gameSlug = (value) => {
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value)) {
+    throw new Error("destination directory name must be a lowercase kebab-case slug, for example my-game");
+  }
+  return value;
+};
+var dartName = (value) => value.replaceAll("-", "_");
+var title = (value) => value.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var identifier = (value) => {
+  const pascal = value.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join("");
+  return /^[0-9]/.test(pascal) ? `Game${pascal}` : pascal;
+};
+function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
+  if (userAgent?.startsWith("pnpm/")) return "pnpm";
+  if (userAgent?.startsWith("npm/")) return "npm";
+  return void 0;
+}
+function render(contents, name, manager) {
+  const replacements = [
+    ["@game/example-game-server", `@game/${name}-server`],
+    ["{{PACKAGE_MANAGER}}", manager],
+    ["ExampleGame", identifier(name)],
+    ["Example Game", title(name)],
+    ["example_game", dartName(name)],
+    ["example-game", name]
+  ];
+  return replacements.reduce((result, [from, to]) => result.replaceAll(from, to), contents);
+}
+function renderTree(source, destination, name, manager) {
+  cpSync(source, destination, { recursive: true });
+  const visit = (directory) => {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+      const path = resolve(directory, entry.name);
+      if (entry.isDirectory()) visit(path);
+      else if (entry.isFile()) {
+        writeFileSync(path, render(readFileSync(path, "utf8"), name, manager));
+        if (entry.name.endsWith(".template")) {
+          renameSync(path, path.slice(0, -".template".length));
+        }
+      }
+    }
+  };
+  visit(destination);
+  const packagedGitignore = resolve(templatesRoot, "scaffold", `${basename(source)}.gitignore`);
+  if (existsSync(packagedGitignore)) {
+    writeFileSync(resolve(destination, ".gitignore"), render(readFileSync(packagedGitignore, "utf8"), name, manager));
+  }
+}
+function packageCommand(manager, operation) {
+  if (operation === "install") return [manager, ["install"]];
+  return [manager, ["run", "contract"]];
+}
+var androidDesugaring = `// flutter_local_notifications requires desugaring in the application module.
+// A library plugin cannot enable this compiler setting transitively.
+android {
+    compileOptions {
+        isCoreLibraryDesugaringEnabled = true
+    }
+}
+
+dependencies {
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.4")
+}`;
+function enableAndroidCoreLibraryDesugaring(appRoot) {
+  const gradlePath = resolve(appRoot, "android/app/build.gradle.kts");
+  const gradle = readFileSync(gradlePath, "utf8");
+  if (!gradle.includes('id("com.android.application")')) {
+    throw new Error(`Flutter created an unexpected Android application build file: ${gradlePath}`);
+  }
+  const settingExists = gradle.includes("isCoreLibraryDesugaringEnabled");
+  const dependencyExists = gradle.includes("coreLibraryDesugaring(");
+  if (settingExists && dependencyExists) return;
+  if (settingExists || dependencyExists) {
+    throw new Error(`Flutter created an incomplete Android core library desugaring configuration: ${gradlePath}`);
+  }
+  appendFileSync(gradlePath, `${gradle.endsWith("\n") ? "\n" : "\n\n"}${androidDesugaring}
+`);
+}
+function scaffoldGame(options) {
+  const root = resolve(options.directory);
+  const name = gameSlug(basename(root));
+  const manager = options.packageManager ?? detectPackageManager() ?? "pnpm";
+  const org = options.org?.trim() || "com.example";
+  const bootstrap = options.bootstrap ?? true;
+  const run = options.run ?? ((command, args, cwd) => execFileSync(command, args, { cwd, stdio: "inherit" }));
+  if (existsSync(root)) throw new Error(`target already exists: ${root}`);
+  mkdirSync(dirname(root), { recursive: true });
+  const stagingRoot = mkdtempSync(resolve(dirname(root), `.${basename(root)}-`));
+  try {
+    const serverRoot = resolve(stagingRoot, "server");
+    const appRoot = resolve(stagingRoot, "app");
+    renderTree(resolve(templatesRoot, "worker"), serverRoot, name, manager);
+    renderTree(resolve(templatesRoot, "project"), stagingRoot, name, manager);
+    if (bootstrap) {
+      run("flutter", ["create", "--empty", "--platforms", "android,web", "--project-name", dartName(name), "--org", org, appRoot], stagingRoot);
+      enableAndroidCoreLibraryDesugaring(appRoot);
+    } else {
+      mkdirSync(appRoot, { recursive: true });
+    }
+    renderTree(resolve(templatesRoot, "app-overlay"), appRoot, name, manager);
+    if (bootstrap) {
+      run("flutter", ["pub", "add", "eigen_flutter@^0.1.0", "firebase_core@^4.9.0", "firebase_messaging@^16.2.2"], appRoot);
+      const [install, installArgs] = packageCommand(manager, "install");
+      run(install, installArgs, serverRoot);
+      const [contract, contractArgs] = packageCommand(manager, "contract");
+      run(contract, contractArgs, serverRoot);
+      run("dart", ["run", "eigen_flutter:generate_payloads", "--contract", "../server/game-contract.json", "--output", "lib/game/generated/payloads.dart", "--fixtures-output", "test/fixtures"], appRoot);
+    }
+    renameSync(stagingRoot, root);
+    return { root, name };
+  } catch (error) {
+    rmSync(stagingRoot, { recursive: true, force: true });
+    throw error;
+  }
+}
+
+export {
+  detectPackageManager,
+  scaffoldGame
+};
+//# sourceMappingURL=chunk-BSJVRXI4.js.map

package/dist/chunk-BSJVRXI4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { appendFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport type PackageManager = \"npm\" | \"pnpm\";\n\nexport interface ScaffoldOptions {\n  directory: string;\n  org?: string;\n  packageManager?: PackageManager;\n  /**\n   * Run Flutter, package installation, and contract/payload generation.\n   * Kept as a programmatic test seam; the public CLI always bootstraps both\n   * halves of the combined project.\n   */\n  bootstrap?: boolean;\n  run?: (command: string, args: string[], cwd: string) => void;\n}\n\nexport interface ScaffoldResult {\n  root: string;\n  name: string;\n}\n\nconst templatesRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"../templates\");\n\nconst gameSlug = (value: string): string => {\n  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value)) {\n    throw new Error(\"destination directory name must be a lowercase kebab-case slug, for example my-game\");\n  }\n  return value;\n};\n\nconst dartName = (value: string): string => value.replaceAll(\"-\", \"_\");\n\nconst title = (value: string): string =>\n  value\n    .split(\"-\")\n    .map((part) => `${part[0]?.toUpperCase() ?? \"\"}${part.slice(1)}`)\n    .join(\" \");\n\nconst identifier = (value: string): string => {\n  const pascal = value\n    .split(\"-\")\n    .map((part) => `${part[0]?.toUpperCase() ?? \"\"}${part.slice(1)}`)\n    .join(\"\");\n  return /^[0-9]/.test(pascal) ? `Game${pascal}` : pascal;\n};\n\nexport function detectPackageManager(userAgent = process.env.npm_config_user_agent): PackageManager | undefined {\n  if (userAgent?.startsWith(\"pnpm/\")) return \"pnpm\";\n  if (userAgent?.startsWith(\"npm/\")) return \"npm\";\n  return undefined;\n}\n\nfunction render(contents: string, name: string, manager: PackageManager): string {\n  const replacements: ReadonlyArray<readonly [string, string]> = [\n    [\"@game/example-game-server\", `@game/${name}-server`],\n    [\"{{PACKAGE_MANAGER}}\", manager],\n    [\"ExampleGame\", identifier(name)],\n    [\"Example Game\", title(name)],\n    [\"example_game\", dartName(name)],\n    [\"example-game\", name],\n  ];\n  return replacements.reduce((result, [from, to]) => result.replaceAll(from, to), contents);\n}\n\nfunction renderTree(source: string, destination: string, name: string, manager: PackageManager): void {\n  cpSync(source, destination, { recursive: true });\n  const visit = (directory: string): void => {\n    for (const entry of readdirSync(directory, { withFileTypes: true })) {\n      const path = resolve(directory, entry.name);\n      if (entry.isDirectory()) visit(path);\n      else if (entry.isFile()) {\n        writeFileSync(path, render(readFileSync(path, \"utf8\"), name, manager));\n        // Template-only source must not be claimed by language servers before\n        // it has an enclosing generated package. Restore the real extension\n        // only in the rendered project.\n        if (entry.name.endsWith(\".template\")) {\n          renameSync(path, path.slice(0, -\".template\".length));\n        }\n      }\n    }\n  };\n  visit(destination);\n\n  // npm deliberately excludes files named `.gitignore` from package\n  // tarballs. Their packaged twins live outside the C3 template so a direct\n  // Git-based C3 render does not inherit a scaffolder-only helper file.\n  const packagedGitignore = resolve(templatesRoot, \"scaffold\", `${basename(source)}.gitignore`);\n  if (existsSync(packagedGitignore)) {\n    writeFileSync(resolve(destination, \".gitignore\"), render(readFileSync(packagedGitignore, \"utf8\"), name, manager));\n  }\n}\n\nfunction packageCommand(manager: PackageManager, operation: \"install\" | \"contract\"): [string, string[]] {\n  if (operation === \"install\") return [manager, [\"install\"]];\n  return [manager, [\"run\", \"contract\"]];\n}\n\nconst androidDesugaring = `// flutter_local_notifications requires desugaring in the application module.\n// A library plugin cannot enable this compiler setting transitively.\nandroid {\n    compileOptions {\n        isCoreLibraryDesugaringEnabled = true\n    }\n}\n\ndependencies {\n    coreLibraryDesugaring(\"com.android.tools:desugar_jdk_libs:2.1.4\")\n}`;\n\nfunction enableAndroidCoreLibraryDesugaring(appRoot: string): void {\n  const gradlePath = resolve(appRoot, \"android/app/build.gradle.kts\");\n  const gradle = readFileSync(gradlePath, \"utf8\");\n  if (!gradle.includes('id(\"com.android.application\")')) {\n    throw new Error(`Flutter created an unexpected Android application build file: ${gradlePath}`);\n  }\n  const settingExists = gradle.includes(\"isCoreLibraryDesugaringEnabled\");\n  const dependencyExists = gradle.includes(\"coreLibraryDesugaring(\");\n  if (settingExists && dependencyExists) return;\n  if (settingExists || dependencyExists) {\n    throw new Error(`Flutter created an incomplete Android core library desugaring configuration: ${gradlePath}`);\n  }\n  appendFileSync(gradlePath, `${gradle.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\"}${androidDesugaring}\\n`);\n}\n\nexport function scaffoldGame(options: ScaffoldOptions): ScaffoldResult {\n  const root = resolve(options.directory);\n  const name = gameSlug(basename(root));\n  const manager = options.packageManager ?? detectPackageManager() ?? \"pnpm\";\n  const org = options.org?.trim() || \"com.example\";\n  const bootstrap = options.bootstrap ?? true;\n  const run = options.run ?? ((command, args, cwd) => execFileSync(command, args, { cwd, stdio: \"inherit\" }));\n\n  if (existsSync(root)) throw new Error(`target already exists: ${root}`);\n  mkdirSync(dirname(root), { recursive: true });\n\n  // Build beside the destination and publish it with one rename. Failed\n  // subprocesses never leave a half-scaffolded project at the requested path.\n  const stagingRoot = mkdtempSync(resolve(dirname(root), `.${basename(root)}-`));\n  try {\n    const serverRoot = resolve(stagingRoot, \"server\");\n    const appRoot = resolve(stagingRoot, \"app\");\n\n    renderTree(resolve(templatesRoot, \"worker\"), serverRoot, name, manager);\n    renderTree(resolve(templatesRoot, \"project\"), stagingRoot, name, manager);\n\n    if (bootstrap) {\n      run(\"flutter\", [\"create\", \"--empty\", \"--platforms\", \"android,web\", \"--project-name\", dartName(name), \"--org\", org, appRoot], stagingRoot);\n      enableAndroidCoreLibraryDesugaring(appRoot);\n    } else {\n      mkdirSync(appRoot, { recursive: true });\n    }\n    renderTree(resolve(templatesRoot, \"app-overlay\"), appRoot, name, manager);\n\n    if (bootstrap) {\n      run(\"flutter\", [\"pub\", \"add\", \"eigen_flutter@^0.1.0\", \"firebase_core@^4.9.0\", \"firebase_messaging@^16.2.2\"], appRoot);\n      const [install, installArgs] = packageCommand(manager, \"install\");\n      run(install, installArgs, serverRoot);\n      const [contract, contractArgs] = packageCommand(manager, \"contract\");\n      run(contract, contractArgs, serverRoot);\n      run(\"dart\", [\"run\", \"eigen_flutter:generate_payloads\", \"--contract\", \"../server/game-contract.json\", \"--output\", \"lib/game/generated/payloads.dart\", \"--fixtures-output\", \"test/fixtures\"], appRoot);\n    }\n\n    renameSync(stagingRoot, root);\n    return { root, name };\n  } catch (error) {\n    rmSync(stagingRoot, { recursive: true, force: true });\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import {
+  detectPackageManager,
+  scaffoldGame
+} from "./chunk-BSJVRXI4.js";
+
+// src/cli.ts
+import { parseArgs } from "util";
+var help = `Usage: create-eigen-game <game-slug> [options]
+
+Creates one repository containing an Eigen Cloudflare Worker and Flutter app.
+The destination basename is the lowercase kebab-case game slug; the CLI derives
+the display name, Dart package name, and Dart/TypeScript type prefix from it.
+
+Options:
+  --org <reverse-domain> Android/iOS organization (default: com.example)
+  --package-manager <pm> npm or pnpm (defaults to the invoking package manager)
+  -h, --help             Show this help`;
+function main(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    allowPositionals: true,
+    strict: true,
+    options: {
+      help: { type: "boolean", short: "h" },
+      org: { type: "string" },
+      "package-manager": { type: "string" }
+    }
+  });
+  if (values.help) {
+    console.log(help);
+    return;
+  }
+  if (positionals.length !== 1) {
+    throw new Error(`expected exactly one destination directory
+
+${help}`);
+  }
+  const requestedManager = values["package-manager"];
+  if (requestedManager !== void 0 && requestedManager !== "npm" && requestedManager !== "pnpm") {
+    throw new Error("--package-manager must be npm or pnpm");
+  }
+  const packageManager = requestedManager ?? detectPackageManager() ?? "pnpm";
+  const result = scaffoldGame({
+    directory: positionals[0],
+    org: values.org,
+    packageManager
+  });
+  console.log(`Created ${result.name} in ${result.root}`);
+}
+try {
+  main(process.argv.slice(2));
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`create-eigen-game: ${message}`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { detectPackageManager, type PackageManager, scaffoldGame } from \"./index.js\";\n\nconst help = `Usage: create-eigen-game <game-slug> [options]\n\nCreates one repository containing an Eigen Cloudflare Worker and Flutter app.\nThe destination basename is the lowercase kebab-case game slug; the CLI derives\nthe display name, Dart package name, and Dart/TypeScript type prefix from it.\n\nOptions:\n  --org <reverse-domain> Android/iOS organization (default: com.example)\n  --package-manager <pm> npm or pnpm (defaults to the invoking package manager)\n  -h, --help             Show this help`;\n\nfunction main(args: string[]): void {\n  const { values, positionals } = parseArgs({\n    args,\n    allowPositionals: true,\n    strict: true,\n    options: {\n      help: { type: \"boolean\", short: \"h\" },\n      org: { type: \"string\" },\n      \"package-manager\": { type: \"string\" },\n    },\n  });\n\n  if (values.help) {\n    console.log(help);\n    return;\n  }\n  if (positionals.length !== 1) {\n    throw new Error(`expected exactly one destination directory\\n\\n${help}`);\n  }\n\n  const requestedManager = values[\"package-manager\"];\n  if (requestedManager !== undefined && requestedManager !== \"npm\" && requestedManager !== \"pnpm\") {\n    throw new Error(\"--package-manager must be npm or pnpm\");\n  }\n  const packageManager = (requestedManager as PackageManager | undefined) ?? detectPackageManager() ?? \"pnpm\";\n  const result = scaffoldGame({\n    directory: positionals[0],\n    org: values.org,\n    packageManager,\n  });\n  console.log(`Created ${result.name} in ${result.root}`);\n}\n\ntry {\n  main(process.argv.slice(2));\n} catch (error) {\n  const message = error instanceof Error ? error.message : String(error);\n  console.error(`create-eigen-game: ${message}`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;;AACA,SAAS,iBAAiB;AAG1B,IAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWb,SAAS,KAAK,MAAsB;AAClC,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,IACxC;AAAA,IACA,kBAAkB;AAAA,IAClB,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,MAAM,EAAE,MAAM,WAAW,OAAO,IAAI;AAAA,MACpC,KAAK,EAAE,MAAM,SAAS;AAAA,MACtB,mBAAmB,EAAE,MAAM,SAAS;AAAA,IACtC;AAAA,EACF,CAAC;AAED,MAAI,OAAO,MAAM;AACf,YAAQ,IAAI,IAAI;AAChB;AAAA,EACF;AACA,MAAI,YAAY,WAAW,GAAG;AAC5B,UAAM,IAAI,MAAM;AAAA;AAAA,EAAiD,IAAI,EAAE;AAAA,EACzE;AAEA,QAAM,mBAAmB,OAAO,iBAAiB;AACjD,MAAI,qBAAqB,UAAa,qBAAqB,SAAS,qBAAqB,QAAQ;AAC/F,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AACA,QAAM,iBAAkB,oBAAmD,qBAAqB,KAAK;AACrG,QAAM,SAAS,aAAa;AAAA,IAC1B,WAAW,YAAY,CAAC;AAAA,IACxB,KAAK,OAAO;AAAA,IACZ;AAAA,EACF,CAAC;AACD,UAAQ,IAAI,WAAW,OAAO,IAAI,OAAO,OAAO,IAAI,EAAE;AACxD;AAEA,IAAI;AACF,OAAK,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC5B,SAAS,OAAO;AACd,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,UAAQ,MAAM,sBAAsB,OAAO,EAAE;AAC7C,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+type PackageManager = "npm" | "pnpm";
+interface ScaffoldOptions {
+    directory: string;
+    org?: string;
+    packageManager?: PackageManager;
+    /**
+     * Run Flutter, package installation, and contract/payload generation.
+     * Kept as a programmatic test seam; the public CLI always bootstraps both
+     * halves of the combined project.
+     */
+    bootstrap?: boolean;
+    run?: (command: string, args: string[], cwd: string) => void;
+}
+interface ScaffoldResult {
+    root: string;
+    name: string;
+}
+declare function detectPackageManager(userAgent?: string | undefined): PackageManager | undefined;
+declare function scaffoldGame(options: ScaffoldOptions): ScaffoldResult;
+
+export { type PackageManager, type ScaffoldOptions, type ScaffoldResult, detectPackageManager, scaffoldGame };

package/dist/index.js

@@ -0,0 +1,9 @@
+import {
+  detectPackageManager,
+  scaffoldGame
+} from "./chunk-BSJVRXI4.js";
+export {
+  detectPackageManager,
+  scaffoldGame
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "create-eigen-game",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Scaffold an Eigen game Worker and Flutter app without cloning the engine repositories.",
+  "type": "module",
+  "bin": {
+    "create-eigen-game": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "wrangler": "^4.110.0",
+    "zod": "^4.4.3",
+    "@eigeninteractive/rules": "0.1.0",
+    "@eigeninteractive/testkit": "0.1.0",
+    "@eigeninteractive/server": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eigeninteractive/eigen-server.git",
+    "directory": "packages/create-eigen-game"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm --dts --sourcemap --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p templates/worker/tsconfig.json"
+  }
+}

package/templates/app-overlay/app-config.json.template

@@ -0,0 +1,6 @@
+{
+  "API_BASE_URL": "",
+  "APP_HOST": "",
+  "GOOGLE_WEB_CLIENT_ID": "",
+  "FIREBASE_VAPID_KEY": ""
+}

package/templates/app-overlay/lib/firebase_options.dart.template

@@ -0,0 +1,14 @@
+import 'package:firebase_core/firebase_core.dart';
+
+/// Firebase configuration generated by the FlutterFire CLI.
+///
+/// The scaffold keeps this throwing implementation so the project compiles
+/// before Firebase is connected. `pnpm firebase:configure` or
+/// `npm run firebase:configure` replaces this file with FlutterFire's generated
+/// platform configuration.
+abstract final class DefaultFirebaseOptions {
+  static FirebaseOptions get currentPlatform => throw StateError(
+    'Firebase is not configured. Run `pnpm firebase:configure` or '
+    '`npm run firebase:configure` from the project root.',
+  );
+}

package/templates/app-overlay/lib/game/README.md

@@ -0,0 +1,18 @@
+# Example Game client module
+
+The immutable payload classes and typed rules base under `generated/` come from
+the authoritative TypeScript schemas. Regenerate them after changing a schema
+or shared fixture:
+
+```sh
+dart run eigen_flutter:generate_payloads \
+  --contract ../server/game-contract.json \
+  --output lib/game/generated/payloads.dart \
+  --fixtures-output test/fixtures
+flutter test
+```
+
+Keep `module.dart` and `v1/rules.dart` handwritten: they contain client-side
+legality and preview behavior plus game presentation. The server remains
+authoritative. The generated `test/game/twin_fixtures_test.dart` runs the
+contract's same fixtures against this Dart rules registry.

package/templates/app-overlay/lib/game/module.dart.template

@@ -0,0 +1,29 @@
+import 'package:eigen_flutter/eigen_flutter.dart';
+import 'package:flutter/material.dart';
+
+import 'v1/rules.dart';
+
+class ExampleGameModule extends GameModule {
+  const ExampleGameModule();
+
+  @override
+  Map<int, GameRules> get versions => const {1: ExampleGameRulesV1()};
+
+  @override
+  GameCreationSpec get creationSpec => const GameCreationSpec(
+    minPlayers: 2,
+    maxPlayers: 2,
+    timingConfigs: {'Untimed': UntimedConfig()},
+    defaultConfig: {'target': 10},
+  );
+
+  @override
+  Widget? buildCreationConfig({
+    required ValueChanged<Map<String, dynamic>> onChanged,
+  }) => null;
+
+  @override
+  Widget buildRules(BuildContext context) => const Text(
+    'Take turns increasing the counter. The first player to reach the target wins.',
+  );
+}

package/templates/app-overlay/lib/game/v1/rules.dart.template

@@ -0,0 +1,79 @@
+import 'package:eigen_flutter/eigen_flutter.dart';
+import 'package:flutter/material.dart';
+
+import '../generated/payloads.dart';
+
+class ExampleGameRulesV1 extends ExampleGameV1RulesBase {
+  const ExampleGameRulesV1();
+
+  @override
+  bool isValidAction({
+    required ExampleGameV1Observation obs,
+    required List<int> pending,
+    required ExampleGameV1Action data,
+    required int playerIndex,
+    required ExampleGameV1Config config,
+  }) => pending.contains(playerIndex) && data.amount > 0;
+
+  @override
+  ExampleGameV1Observation? previewAction({
+    required ExampleGameV1Observation obs,
+    required List<int> pending,
+    required ExampleGameV1Action data,
+    required int playerIndex,
+    required ExampleGameV1Config config,
+  }) => ExampleGameV1Observation(count: obs.count + data.amount);
+
+  @override
+  Widget buildContent(GameContentContext context) =>
+      _CounterBoard(context: context, rules: this);
+
+  @override
+  String? ratingPool(RatingPoolArgs args) => null;
+
+  @override
+  bool botSeatable(BotSeatableArgs args) => true;
+}
+
+class _CounterBoard extends StatelessWidget {
+  const _CounterBoard({required this.context, required this.rules});
+
+  final GameContentContext context;
+  final ExampleGameRulesV1 rules;
+
+  @override
+  Widget build(BuildContext buildContext) {
+    final observation = context.frame.observation! as ExampleGameV1Observation;
+    final config = context.config as ExampleGameV1Config;
+    final seat = context.mySeat.indexOrNull;
+    final action = ExampleGameV1Action(amount: 1);
+    final canAct =
+        seat != null &&
+        !context.isReplay &&
+        !context.actionPending &&
+        rules.isValidAction(
+          obs: observation,
+          pending: context.frame.pendingPlayers,
+          data: action,
+          playerIndex: seat,
+          config: config,
+        );
+
+    return Center(
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Text(
+            '${observation.count} / ${config.target}',
+            style: Theme.of(buildContext).textTheme.displayMedium,
+          ),
+          const SizedBox(height: 24),
+          FilledButton(
+            onPressed: canAct ? () => context.onAction(action.toJson()) : null,
+            child: const Text('Add one'),
+          ),
+        ],
+      ),
+    );
+  }
+}

package/templates/app-overlay/lib/main.dart.template

@@ -0,0 +1,39 @@
+import 'package:eigen_flutter/eigen_flutter.dart';
+import 'package:firebase_core/firebase_core.dart';
+import 'package:firebase_messaging/firebase_messaging.dart';
+import 'package:flutter/material.dart';
+
+import 'firebase_options.dart';
+import 'game/module.dart';
+
+const _apiBaseUrl = String.fromEnvironment('API_BASE_URL');
+const _googleWebClientId = String.fromEnvironment('GOOGLE_WEB_CLIENT_ID');
+const _firebaseVapidKey = String.fromEnvironment('FIREBASE_VAPID_KEY');
+const _appHost = String.fromEnvironment('APP_HOST');
+
+Future<void> main() async {
+  await runEngineApp(
+    module: const ExampleGameModule(),
+    config: AppConfig(
+      branding: const Branding(
+        appName: 'Example Game',
+        seedColor: Colors.indigo,
+      ),
+      engine: EngineConfig(
+        apiBaseUrl: _apiBaseUrl,
+        googleWebClientId: _googleWebClientId,
+        appHost: _appHost.isEmpty ? null : _appHost,
+        firebaseVapidKey: _firebaseVapidKey,
+      ),
+    ),
+    firebaseOptions: DefaultFirebaseOptions.currentPlatform,
+    onBackgroundMessage: _onBackgroundMessage,
+  );
+}
+
+@pragma('vm:entry-point')
+Future<void> _onBackgroundMessage(RemoteMessage message) async {
+  await Firebase.initializeApp(
+    options: DefaultFirebaseOptions.currentPlatform,
+  );
+}

package/templates/app-overlay/test/game/twin_fixtures_test.dart.template

@@ -0,0 +1,28 @@
+import 'package:eigen_flutter/testing/twin_fixtures.dart';
+import 'package:example_game/game/module.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  const module = ExampleGameModule();
+  final suites = loadTwinFixtureSuites('test/fixtures');
+
+  test('the generated twin fixture suite is present', () {
+    expect(suites, isNotEmpty);
+  });
+
+  for (final suite in suites) {
+    final rules = module.versions[suite.schemaVersion];
+    group('twin fixtures v${suite.schemaVersion} (${suite.path})', () {
+      for (final fixtureCase in suite.cases) {
+        test(fixtureCase.name, () {
+          expect(
+            rules,
+            isNotNull,
+            reason: 'no Dart rules unit for v${suite.schemaVersion}',
+          );
+          expect(runTwinFixtureCase(rules!, fixtureCase), isEmpty);
+        });
+      }
+    });
+  }
+}

package/templates/app-overlay/web/firebase-config.js.template

@@ -0,0 +1,4 @@
+throw new Error(
+  "Firebase Web is not configured. Run `pnpm firebase:configure` or " +
+    "`npm run firebase:configure` from the project root.",
+);

package/templates/app-overlay/web/firebase-messaging-sw.js.template

@@ -0,0 +1,15 @@
+// Keep this version aligned with the Firebase JS SDK supported by the
+// firebase_core_web version resolved by the Flutter app.
+importScripts("https://www.gstatic.com/firebasejs/12.15.0/firebase-app-compat.js");
+importScripts("https://www.gstatic.com/firebasejs/12.15.0/firebase-messaging-compat.js");
+importScripts("firebase-config.js");
+
+// `firebase:configure` generates this public configuration from the Web app
+// selected by FlutterFire. Firebase Security Rules and the Eigen Worker's
+// verified ID tokens enforce authorization; these identifiers are not server
+// credentials.
+firebase.initializeApp(self.firebaseConfig);
+
+// Initializing Messaging is enough for notification payloads: the browser
+// displays them while the app is backgrounded or closed.
+firebase.messaging();