create-omg 0.4.41 → 0.4.43

package/README.md

@@ -1,14 +1,24 @@
 # create-omg
 
-Create a new omg.dev app from the official starter:
+Copy an official React starter. This is **not** the current product.
+
+The current product is the local agent control plane:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/BennyKok/omg.dev/main/scripts/setup.sh | bash
+```
+
+Then open **http://localhost:8766**. You bring your own agent accounts.
+`lfg` is a compatibility alias.
+
+`create-omg` only copies starter files. It does not install the control
+plane and it does not deploy to `*.omgs.app`.
 
 ```sh
-bun create omg my-app
+npx create-omg my-app
 cd my-app
 bun run dev
 ```
 
-The same generator is available through `npx create-omg my-app` and
-`omg create my-app`.
-
-Use `--no-install` to create the project without installing dependencies.
+`omg create` from `@omg-dev/cli` 0.4.x is retired. The same generator is
+available as `omg-apps create` from `@omg-dev/apps`.

package/dist/index.mjs

@@ -2,6 +2,7 @@
 // @bun
 
 // src/index.ts
+import { existsSync as existsSync2 } from "fs";
 import { fileURLToPath } from "url";
 
 // src/create.ts
@@ -59,31 +60,83 @@ async function createApp(options) {
   if (options.install === false)
     output("      bun install");
   output("      bun run dev");
-  output("      omg deploy");
+  output("");
+  output("This starter is not the current product.");
+  output("Current product: curl -fsSL https://raw.githubusercontent.com/BennyKok/omg.dev/main/scripts/setup.sh | bash");
+  output("Then open http://localhost:8766");
 }
 
 // src/index.ts
-var HELP = `Create a new omg.dev app
+var TEMPLATES = {
+  "react-ts": "React + TanStack Router (SPA, prerendered)",
+  "react-ts-start": "React + TanStack Start (SSR) \u2014 experimental"
+};
+var DEFAULT_TEMPLATE = "react-ts";
+var HELP = `create-omg \u2014 copy an omg React starter
+
+This is not the current product. The current product is the local
+agent control plane:
+
+  curl -fsSL https://raw.githubusercontent.com/BennyKok/omg.dev/main/scripts/setup.sh | bash
+  open http://localhost:8766
 
-  bun create omg <name>
   npx create-omg <name>
 
 Options:
-  --no-install   create files without installing dependencies
-  --help         show this help
+  --template <id>  starter to use (default: ${DEFAULT_TEMPLATE})
+  --no-install     create files without installing dependencies
+  --help           show this help
+
+Templates:
+${Object.entries(TEMPLATES).map(([id, desc]) => `  ${id.padEnd(16)} ${desc}`).join(`
+`)}
 `;
+function parseTemplate(args) {
+  const flagIndex = args.findIndex((arg) => arg === "--template" || arg === "-t");
+  if (flagIndex !== -1) {
+    const value = args[flagIndex + 1];
+    if (!value || value.startsWith("-"))
+      throw new Error("--template needs a value");
+    if (!(value in TEMPLATES)) {
+      throw new Error(`unknown template ${JSON.stringify(value)} (want: ${Object.keys(TEMPLATES).join(", ")})`);
+    }
+    return value;
+  }
+  const inline = args.find((arg) => arg.startsWith("--template="));
+  if (inline) {
+    const value = inline.slice("--template=".length);
+    if (!(value in TEMPLATES)) {
+      throw new Error(`unknown template ${JSON.stringify(value)} (want: ${Object.keys(TEMPLATES).join(", ")})`);
+    }
+    return value;
+  }
+  return DEFAULT_TEMPLATE;
+}
+function parseDestination(args) {
+  const flagIndex = args.findIndex((arg) => arg === "--template" || arg === "-t");
+  const consumed = flagIndex === -1 ? -1 : flagIndex + 1;
+  return args.find((arg, i) => !arg.startsWith("-") && i !== consumed);
+}
 async function main() {
   const args = process.argv.slice(2);
   if (args.includes("--help") || args.includes("-h")) {
     process.stdout.write(HELP);
     return 0;
   }
-  const destination = args.find((arg) => !arg.startsWith("-"));
+  const template = parseTemplate(args);
+  const destination = parseDestination(args);
   if (!destination) {
     process.stderr.write(HELP);
     return 1;
   }
-  const templateRoot = fileURLToPath(new URL("./template", import.meta.url));
+  let templateRoot = fileURLToPath(new URL(`./templates/${template}`, import.meta.url));
+  if (!existsSync2(templateRoot)) {
+    const legacy = fileURLToPath(new URL("./template", import.meta.url));
+    if (template !== DEFAULT_TEMPLATE || !existsSync2(legacy)) {
+      throw new Error(`template ${template} is missing from this package`);
+    }
+    templateRoot = legacy;
+  }
   await createApp({
     destination,
     install: !args.includes("--no-install"),
@@ -91,10 +144,16 @@ async function main() {
   });
   return 0;
 }
-main().then((code) => process.exit(code)).catch((error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`
+if (import.meta.main) {
+  main().then((code) => process.exit(code)).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`
 error: ${message}
 `);
-  process.exit(1);
-});
+    process.exit(1);
+  });
+}
+export {
+  parseTemplate,
+  parseDestination
+};

package/dist/{template → templates/react-ts}/AGENTS.md

@@ -41,6 +41,28 @@ divs** (no div-built tab bars, toggles, sliders, dropdowns, modals):
 - Motion: use `transitions.tsx` / `.vui-*` classes and the `animated-*`
   primitives; don't write bespoke keyframe animations for patterns they cover.
 
+## Routing: files in `src/routes/`
+
+This app uses TanStack Router with file-based routing. A second screen means a
+second file — **not** a `useState` view-switcher inside `App.tsx`.
+
+```tsx
+// src/routes/pricing.tsx  →  /pricing
+import { createFileRoute } from "@tanstack/react-router"
+
+export const Route = createFileRoute("/pricing")({ component: Pricing })
+
+function Pricing() { return <main>...</main> }
+```
+
+- `src/App.tsx` is the `/` route's component — keep the home view there.
+- Params: `posts.$postId.tsx` → `/posts/$postId`, read via `Route.useParams()`.
+- Navigate with `<Link to="/pricing">` from `@tanstack/react-router`. A raw
+  `<a href>` full-reloads the page and drops app state.
+- `src/routeTree.gen.ts` is generated from `src/routes/` — never edit it.
+- Static routes are prerendered to static HTML at build time, so real URLs are
+  cheap SEO. Param routes fall back to the SPA shell.
+
 ## Environment
 
 - Project dir `/home/user/project`, package manager **bun**.

package/dist/templates/react-ts/_gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?