@pylonsync/create-pylon 0.3.18 → 0.3.20

package/bin/create-pylon.js

@@ -25,7 +25,7 @@ import { stdin, stdout, exit, argv, cwd } from "node:process";
 // of the pylon stack).
 // ---------------------------------------------------------------------------
 
-const PYLON_VERSION = "0.3.17";
+const PYLON_VERSION = "0.3.20";
 
 // ---------------------------------------------------------------------------
 // CLI args + interactive prompt
@@ -35,9 +35,9 @@ const args = argv.slice(2);
 let projectName = args.find((a) => !a.startsWith("--"));
 
 const flags = {
-	pm:
-		args.find((a) => a === "--bun" || a === "--pnpm" || a === "--yarn" || a === "--npm")?.slice(2) ??
-		detectPackageManager(),
+	pm: args.find(
+		(a) => a === "--bun" || a === "--pnpm" || a === "--yarn" || a === "--npm",
+	)?.slice(2),
 	skipInstall: args.includes("--skip-install"),
 	help: args.includes("--help") || args.includes("-h"),
 };
@@ -47,11 +47,35 @@ if (flags.help) {
 	exit(0);
 }
 
+// Interactive prompts for project name + package manager. Default
+// PM to bun: it handles `workspace:*` correctly out of the box,
+// installs faster than the alternatives, and is what the
+// @pylonsync/* packages are tested against. The user can pick
+// anything though.
+const rl = createInterface({ input: stdin, output: stdout });
 if (!projectName) {
-	const rl = createInterface({ input: stdin, output: stdout });
 	projectName = (await rl.question("Project name: ")).trim() || "my-pylon-app";
-	rl.close();
 }
+if (!flags.pm) {
+	const detected = detectPackageManager();
+	const def = detected ?? "bun";
+	const choice = (
+		await rl.question(`Package manager (bun, pnpm, yarn, npm) [${def}]: `)
+	)
+		.trim()
+		.toLowerCase();
+	flags.pm = ["bun", "pnpm", "yarn", "npm"].includes(choice) ? choice : def;
+}
+rl.close();
+
+// Some PMs reject the `workspace:` protocol. Bun/pnpm/yarn berry
+// understand it and rewrite to the local sibling version at install
+// time. npm errors EUNSUPPORTEDPROTOCOL ("Unsupported URL Type").
+// For npm, emit "*" — npm's own workspaces feature still resolves
+// it to the local sibling because the workspace package is in the
+// root's `workspaces` list.
+const usesWorkspaceProtocol = flags.pm !== "npm";
+const workspaceDepSpec = usesWorkspaceProtocol ? "workspace:*" : "*";
 
 const root = resolve(cwd(), projectName);
 
@@ -82,6 +106,12 @@ function writeJson(path, value) {
 // Root workspace
 // ---------------------------------------------------------------------------
 
+// Per-PM script syntax: bun has its own --filter, pnpm uses --filter,
+// npm/yarn use --workspace. Picking the right shape at scaffold time
+// means `npm run dev` (or whichever PM) works without the user
+// learning each PM's flag dialect.
+const wsScripts = pmScripts(flags.pm);
+
 writeJson("package.json", {
 	name: projectName,
 	private: true,
@@ -89,9 +119,9 @@ writeJson("package.json", {
 	workspaces: ["apps/*", "packages/*"],
 	scripts: {
 		dev: "npm-run-all --parallel dev:api dev:web",
-		"dev:api": "npm --workspace apps/api run dev",
-		"dev:web": "npm --workspace apps/web run dev",
-		build: "npm --workspaces run build --if-present",
+		"dev:api": wsScripts.devApi,
+		"dev:web": wsScripts.devWeb,
+		build: wsScripts.build,
 	},
 	devDependencies: {
 		"npm-run-all": "^4.1.5",
@@ -526,7 +556,7 @@ writeJson("apps/web/package.json", {
 		lint: "next lint",
 	},
 	dependencies: {
-		[`@${projectName}/ui`]: "workspace:*",
+		[`@${projectName}/ui`]: workspaceDepSpec,
 		"@pylonsync/sdk": `^${PYLON_VERSION}`,
 		"@pylonsync/react": `^${PYLON_VERSION}`,
 		"@pylonsync/next": `^${PYLON_VERSION}`,
@@ -574,7 +604,20 @@ write(
  * Pylon's typed client + functions packages re-export across the
  * server/client boundary AND the workspace UI package ships TSX.
  * \`transpilePackages\` makes Next bundle them cleanly.
+ *
+ * \`rewrites\` proxies every Pylon-owned path (\`/api/fn/*\`,
+ * \`/api/auth/*\`, \`/api/sync/*\`, …) to the Pylon binary running
+ * on \`PYLON_API_URL\` (default http://localhost:4321). Without this,
+ * Next.js sees \`/api/fn/addTodo\` as a missing route and 404s before
+ * the request ever reaches Pylon.
+ *
+ * In production set \`PYLON_API_URL\` to wherever you've deployed the
+ * Pylon binary (Fly, Render, Railway, your own box). The browser
+ * still hits same-origin paths under your Next deployment, and Next
+ * forwards them server-side — no CORS, no extra DNS.
  */
+const PYLON_API_URL = process.env.PYLON_API_URL ?? "http://localhost:4321";
+
 const config: NextConfig = {
 \ttranspilePackages: [
 \t\t"@${projectName}/ui",
@@ -584,6 +627,14 @@ const config: NextConfig = {
 \t\t"@pylonsync/functions",
 \t\t"@pylonsync/sync",
 \t],
+\tasync rewrites() {
+\t\treturn [
+\t\t\t{ source: "/api/fn/:path*", destination: \`\${PYLON_API_URL}/api/fn/:path*\` },
+\t\t\t{ source: "/api/auth/:path*", destination: \`\${PYLON_API_URL}/api/auth/:path*\` },
+\t\t\t{ source: "/api/sync/:path*", destination: \`\${PYLON_API_URL}/api/sync/:path*\` },
+\t\t\t{ source: "/api/:path*", destination: \`\${PYLON_API_URL}/api/:path*\` },
+\t\t];
+\t},
 };
 
 export default config;
@@ -816,7 +867,50 @@ function detectPackageManager() {
 	if (ua.startsWith("bun")) return "bun";
 	if (ua.startsWith("pnpm")) return "pnpm";
 	if (ua.startsWith("yarn")) return "yarn";
-	return "npm";
+	if (ua.startsWith("npm")) return "npm";
+	return null;
+}
+
+/**
+ * Per-package-manager workspace script syntax. Each PM exposes
+ * "run X in workspace Y" differently:
+ *   bun  bun run --filter ./apps/api dev
+ *   pnpm pnpm --filter ./apps/api run dev
+ *   yarn yarn workspace @<name>/api run dev
+ *   npm  npm --workspace apps/api run dev
+ *
+ * The scaffold doesn't try to abstract the PM — it bakes the right
+ * syntax into the generated scripts so `<pm> run dev` works
+ * everywhere with no further config.
+ */
+function pmScripts(pm) {
+	switch (pm) {
+		case "bun":
+			return {
+				devApi: "bun run --filter './apps/api' dev",
+				devWeb: "bun run --filter './apps/web' dev",
+				build: "bun run --filter '*' build",
+			};
+		case "pnpm":
+			return {
+				devApi: "pnpm --filter './apps/api' run dev",
+				devWeb: "pnpm --filter './apps/web' run dev",
+				build: "pnpm --filter '*' run build",
+			};
+		case "yarn":
+			return {
+				devApi: `yarn workspace @${projectName}/api run dev`,
+				devWeb: `yarn workspace @${projectName}/web run dev`,
+				build: "yarn workspaces foreach -A run build",
+			};
+		case "npm":
+		default:
+			return {
+				devApi: "npm --workspace apps/api run dev",
+				devWeb: "npm --workspace apps/web run dev",
+				build: "npm --workspaces run build --if-present",
+			};
+	}
 }
 
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/create-pylon",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "Scaffold a new Pylon app — realtime backend + Next.js frontend in one command. Run via `npm create @pylonsync/pylon@latest`.",
   "publishConfig": {
     "access": "public"