create-pracht 0.5.0 → 0.6.1

package/src/index.js

@@ -16,10 +16,11 @@ const FALLBACK_VERSION_RANGES = {
   "@pracht/adapter-cloudflare": "^0.5.8",
   "@pracht/adapter-netlify": "^0.1.0",
   "@pracht/adapter-node": "^0.3.8",
+  "@pracht/adapter-static": "^0.1.0",
   "@pracht/adapter-vercel": "^0.2.8",
-  "@pracht/cli": "^1.9.0",
-  "@pracht/core": "^0.12.0",
-  "@pracht/vite-plugin": "^0.7.6",
+  "@pracht/cli": "^1.11.0",
+  "@pracht/core": "^0.14.0",
+  "@pracht/vite-plugin": "^0.9.0",
   "@tailwindcss/vite": "^4.1.0",
   "netlify-cli": "^21.6.0",
   tailwindcss: "^4.1.0",
@@ -87,6 +88,13 @@ const ADAPTERS = {
     packageName: "@pracht/adapter-vercel",
     short: "vercel",
   },
+  static: {
+    description: "Pure static export — deploy dist/client to any static host",
+    id: "static",
+    label: "Static export",
+    packageName: "@pracht/adapter-static",
+    short: "static",
+  },
 };
 
 const DEFAULT_DIRECTORY = "pracht-app";
@@ -407,7 +415,7 @@ export function parseArgs(argv) {
       const value = normalizeAdapter(arg.slice("--adapter=".length));
       if (!value) {
         throw new ValidationError(
-          `Invalid adapter: ${arg.slice("--adapter=".length)}. Use node, cf, netlify, or vercel.`,
+          `Invalid adapter: ${arg.slice("--adapter=".length)}. Use node, cf, netlify, vercel, or static.`,
         );
       }
       options.adapter = value;
@@ -462,6 +470,7 @@ async function promptForAdapter(readline) {
   console.log("  2. Cloudflare Workers");
   console.log("  3. Vercel");
   console.log("  4. Netlify");
+  console.log("  5. Static export (no server)");
 
   while (true) {
     const answer = await readline.question("Adapter (1): ");
@@ -471,7 +480,7 @@ async function promptForAdapter(readline) {
       return normalized;
     }
 
-    console.log("Choose 1/2/3/4 or node/cf/vercel/netlify.");
+    console.log("Choose 1/2/3/4/5 or node/cf/vercel/netlify/static.");
   }
 }
 
@@ -614,6 +623,10 @@ function normalizeAdapter(value) {
     return "netlify";
   }
 
+  if (normalized === "5" || normalized === "static" || normalized === "export") {
+    return "static";
+  }
+
   return null;
 }
 
@@ -690,11 +703,16 @@ async function buildProjectFiles({
       tailwind,
       versions,
     }),
-    "src/api/health.ts": createHealthRoute(adapter),
     "vite.config.ts": createViteConfig(adapter, router, tailwind),
     "tsconfig.json": createBaseTSConfig(adapter),
   };
 
+  // A static export has no server, so an API route would be a hard build
+  // error — the starter must not scaffold one it cannot build.
+  if (adapter.id !== "static") {
+    files["src/api/health.ts"] = createHealthRoute(adapter);
+  }
+
   if (agentTools) {
     files["AGENTS.md"] = createAgentInstructions({
       adapter,
@@ -803,6 +821,10 @@ function createPackageJson({ adapter, projectName, tailwind, versions }) {
     scripts.start = "node dist/server/server.js";
   }
 
+  if (adapter.id === "static") {
+    scripts.preview = "pracht preview";
+  }
+
   const devDependencies = {
     "@pracht/cli": versions["@pracht/cli"],
     "@pracht/vite-plugin": versions["@pracht/vite-plugin"],
@@ -858,6 +880,7 @@ function createViteConfig(adapter, router, tailwind) {
     cloudflare: { fn: "cloudflareAdapter", pkg: "@pracht/adapter-cloudflare" },
     netlify: { fn: "netlifyAdapter", pkg: "@pracht/adapter-netlify" },
     vercel: { fn: "vercelAdapter", pkg: "@pracht/adapter-vercel" },
+    static: { fn: "staticAdapter", pkg: "@pracht/adapter-static" },
   };
 
   const info = ADAPTER_IMPORTS[adapter.id] ?? ADAPTER_IMPORTS.node;
@@ -955,7 +978,9 @@ function createHomeRoute(adapter) {
     "    steps: [",
     '      "Edit src/routes/home.tsx to change this page.",',
     '      "Add more routes in src/routes.ts.",',
-    '      "Add API handlers in src/api/*.ts.",',
+    adapter.id === "static"
+      ? '      "Fetch live data from the browser — a static export runs no server.",'
+      : '      "Add API handlers in src/api/*.ts.",',
     "    ],",
     "  };",
     "}",
@@ -974,7 +999,9 @@ function createHomeRoute(adapter) {
     "        ))}",
     "      </ul>",
     '      <p style={{ marginTop: "24px" }}>',
-    "        Check <code>/api/health</code> for a simple API route.",
+    adapter.id === "static"
+      ? "        Run <code>pracht build</code>, then deploy <code>dist/client</code> anywhere."
+      : "        Check <code>/api/health</code> for a simple API route.",
     "      </p>",
     "    </section>",
     "  );",
@@ -1022,7 +1049,9 @@ function createPagesHomeRoute(adapter) {
     "    steps: [",
     '      "Edit src/pages/index.tsx to change this page.",',
     '      "Add more pages in src/pages/.",',
-    '      "Add API handlers in src/api/*.ts.",',
+    adapter.id === "static"
+      ? '      "Fetch live data from the browser — a static export runs no server.",'
+      : '      "Add API handlers in src/api/*.ts.",',
     "    ],",
     "  };",
     "}",
@@ -1041,7 +1070,9 @@ function createPagesHomeRoute(adapter) {
     "        ))}",
     "      </ul>",
     '      <p style={{ marginTop: "24px" }}>',
-    "        Check <code>/api/health</code> for a simple API route.",
+    adapter.id === "static"
+      ? "        Run <code>pracht build</code>, then deploy <code>dist/client</code> anywhere."
+      : "        Check <code>/api/health</code> for a simple API route.",
     "      </p>",
     "    </section>",
     "  );",
@@ -1267,6 +1298,11 @@ function createWranglerConfig(projectName) {
     // validates every named export of the deployed entry module and rejects the
     // build metadata (buildTarget, manifests, ...) server.js also exports.
     '  "main": "dist/server/worker.js",',
+    // Pracht's Vite build is the authoritative bundle and may contain lazy
+    // server chunks. A second Wrangler bundle would inline them again; the
+    // module rule makes Wrangler upload those chunks next to the entry.
+    '  "no_bundle": true,',
+    '  "rules": [{ "type": "ESModule", "globs": ["**/*.js", "**/*.mjs"] }],',
     `  "compatibility_date": ${JSON.stringify(compatibilityDate)},`,
     '  "assets": {',
     '    "binding": "ASSETS",',
@@ -1410,7 +1446,12 @@ function createAgentInstructions({ adapter, agentTools, packageManager, router,
     `- \`${runCmd} build\` — production build`,
   ];
 
-  if (adapter.id === "node" || adapter.id === "cloudflare" || adapter.id === "netlify") {
+  if (
+    adapter.id === "node" ||
+    adapter.id === "cloudflare" ||
+    adapter.id === "netlify" ||
+    adapter.id === "static"
+  ) {
     lines.push(`- \`${runCmd} preview\` — build and serve the production build locally`);
   }
 
@@ -1430,10 +1471,14 @@ function createAgentInstructions({ adapter, agentTools, packageManager, router,
   lines.push("- `pracht generate route --path /about` — add a route");
   if (router !== "pages") {
     lines.push("- `pracht generate shell --name app` — add a shell");
-    lines.push("- `pracht generate middleware --name auth` — add middleware");
+    if (adapter.id !== "static") {
+      lines.push("- `pracht generate middleware --name auth` — add middleware");
+    }
   }
-  lines.push("- `pracht generate api --path /health --methods GET` — add an API route");
-  if (router !== "pages") {
+  if (adapter.id !== "static") {
+    lines.push("- `pracht generate api --path /health --methods GET` — add an API route");
+  }
+  if (router !== "pages" && adapter.id !== "static") {
     lines.push(
       "- `pracht generate capability --name notes.search --effect read --expose http` — add a capability (agent-callable operation)",
     );
@@ -1473,7 +1518,9 @@ function createAgentInstructions({ adapter, agentTools, packageManager, router,
     lines.push("- `src/shells/` — shell components (layouts)");
   }
 
-  lines.push("- `src/api/` — API route handlers");
+  if (adapter.id !== "static") {
+    lines.push("- `src/api/` — API route handlers");
+  }
   lines.push(`- \`vite.config.ts\` — Vite config with the ${adapter.label} adapter`);
 
   if (tailwind) {
@@ -1576,6 +1623,21 @@ function createReadme({
     lines.push("Run the deploy command after linking or logging into your Vercel account.");
   }
 
+  if (adapter.id === "static") {
+    lines.push(`- \`${previewCommand}\``);
+    lines.push("");
+    lines.push(
+      "`pracht build` writes the whole site to `dist/client`. Upload that directory to any " +
+        "static host — there is no server to run. Configure the host to serve `index.html` " +
+        "for directory URLs and to use `404.html` as its error document.",
+    );
+    lines.push("");
+    lines.push(
+      "A static export runs no server, so API routes, middleware, and `ssr`/`isg` routes are " +
+        "build errors. Fetch live data from the browser instead, or switch to a serverful adapter.",
+    );
+  }
+
   lines.push("");
   lines.push("## Files");
   lines.push("");
@@ -1597,7 +1659,9 @@ function createReadme({
     lines.push("- `src/routes/not-found.tsx` is the not-found page, wired via `notFound`.");
   }
 
-  lines.push("- `src/api/health.ts` is a sample API route.");
+  if (adapter.id !== "static") {
+    lines.push("- `src/api/health.ts` is a sample API route.");
+  }
 
   if (packageManager === "pnpm") {
     lines.push(
@@ -1791,7 +1855,7 @@ Usage:
   create-pracht [directory] [options]
 
 Options:
-  --adapter=node|cf|netlify|vercel
+  --adapter=node|cf|netlify|vercel|static
                                Choose hosting adapter (default: node)
   --router=manifest|pages      Choose routing system (default: manifest)
   --template=minimal|tailwind  Choose starter template (minimal, or minimal + Tailwind CSS)