@lukoweb/apitogo 0.2.40 → 0.2.42

package/dist/cli/cli.js

@@ -5463,6 +5463,7 @@ import colors4 from "picocolors";
 import { gt } from "semver";
 
 // src/cli/common/json-only-deploy.ts
+init_logger();
 function isDeployJsonOnlyArgv() {
   const args = process.argv;
   let cmdIdx = -1;
@@ -5478,6 +5479,14 @@ function isDeployJsonOnlyArgv() {
   }
   return args.slice(cmdIdx).some((a) => a === "--json-only" || a.startsWith("--json-only="));
 }
+function applyJsonOnlyDeployQuietMode() {
+  process.env.APITOGO_JSON_ONLY = "1";
+  const noop = () => {
+  };
+  logger.info = noop;
+  logger.warn = noop;
+  logger.warnOnce = noop;
+}
 
 // src/cli/common/output.ts
 import * as Sentry from "@sentry/node";
@@ -5886,6 +5895,8 @@ var PortalSchema = z.strictObject({
   }).optional(),
   console: z.strictObject({ enabled }).optional(),
   theme: path3.optional(),
+  /** A custom home page: a React component file that the portal serves at `/`. */
+  landing: path3.optional(),
   requireAuth: z.union([z.boolean(), z.strictObject({ exclude: pathList })], {
     error: 'must be true, false or { "exclude": ["/route", ...] }'
   }).optional(),
@@ -6447,6 +6458,7 @@ function resolveConfigV2(config2, configPath) {
       },
       console: { enabled: portal.console?.enabled ?? true },
       theme: portal.theme ? path7.resolve(configDir, portal.theme) : path7.join(dir, "theme.json"),
+      ...portal.landing ? { landing: path7.resolve(configDir, portal.landing) } : {},
       requireAuth: portal.requireAuth ?? false,
       search: provider === "external" ? "none" : portal.search ?? "pagefind"
     };
@@ -6563,7 +6575,7 @@ function loadConfigV2(pathOrDir) {
 }
 
 // src/config/v2/rules.ts
-import { readFile as readFile2, stat as stat2 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile2, stat as stat2 } from "node:fs/promises";
 import path9 from "node:path";
 import { glob } from "glob";
 import { parse as parseYaml } from "yaml";
@@ -6575,6 +6587,10 @@ async function isFile(target) {
 async function isDirectory(target) {
   return (await stat2(target).catch(() => void 0))?.isDirectory() === true;
 }
+async function isEmptyFolder(target) {
+  const entries = await readdir2(target).catch(() => []);
+  return entries.every((name) => name === ".gitkeep");
+}
 function collectSecretRefs(config2) {
   const found = [];
   const walk = (value, at) => {
@@ -6816,6 +6832,13 @@ async function gatewayRules(resolved, out) {
           message: `gateway.origin.source does not exist: ${inside === "" ? "." : inside}.`,
           hint: "Point it at the folder that holds your backend code."
         });
+      } else if (await isEmptyFolder(origin.source)) {
+        out.warn({
+          code: "GATEWAY_BACKEND_EMPTY",
+          path: "gateway.origin.source",
+          message: `gateway.origin.source (${inside}) is empty: there is no code to run yet.`,
+          hint: "Put your backend code in that folder before you deploy."
+        });
       }
     }
     if (origin.url !== void 0) {
@@ -7934,7 +7957,9 @@ function planPortal(profile, manifest) {
       keysApiBaseUrl: plans.keysApiBaseUrl,
       billing: plans.billing,
       links: {
-        ...profile.modules.docs ? { docs: "/introduction" } : profile.docs.url ? { docs: profile.docs.url } : {},
+        // Hosted docs are linked once their pages are known (see `buildPortalWorkspace`): there is no page to
+        // name before that, and a guessed one was a 404 on every portal whose first page is not called `introduction`.
+        ...!profile.modules.docs && profile.docs.url ? { docs: profile.docs.url } : {},
         ...plan2.apiReference ? { api: `/${API_REFERENCE_PATH}` } : {}
       }
     };
@@ -7964,6 +7989,15 @@ function buildSiteConfig(resolved, plan2, theme, extras = {}) {
     },
     modules: {
       docs: { enabled: plan2.docs },
+      // A custom home page (`portal.landing`) is served at `/`; the build imports the component from its absolute path.
+      ...portal?.landing ? {
+        landing: {
+          enabled: true,
+          path: "/",
+          layout: "landing",
+          page: portal.landing.split(path12.sep).join("/")
+        }
+      } : {},
       // The plans pages (pricing, choosing a plan) exist only when billing is on, and the plans service is what makes it so.
       // Switching billing on also makes the user panel register its own placeholder plans page, at `/account/<path>`.
       // Its default path is `plans`, which is where the billing plugin puts the real page (subscribe, switch, cancel),
@@ -7992,6 +8026,14 @@ function buildSiteConfig(resolved, plan2, theme, extras = {}) {
       ]
     } : {},
     ...navigation.length > 0 ? { navigation } : {},
+    // The sidebar link above is only seen inside the docs; the header is what every page shows.
+    ...plan2.apiReference ? {
+      header: {
+        navigation: [
+          { label: "API Reference", to: `/${API_REFERENCE_PATH}` }
+        ]
+      }
+    } : {},
     ...redirects.length > 0 ? { redirects } : {},
     ...extras.protectedRoutes?.length ? { protectedRoutes: extras.protectedRoutes } : {},
     ...theme !== void 0 ? { theme } : {},
@@ -8100,7 +8142,14 @@ async function preparePortal(resolved, manifest, mode, options = {}) {
   const hostedDocRoutes = plan2.docs ? await docRoutes(profile.docs.content, {
     includeDrafts: mode === "development"
   }) : [];
-  const home = homeRedirect({
+  if (plan2.plansPlugin && plan2.docs) {
+    const landing = hostedDocRoutes.some(
+      (route) => route === "/" || route === "/index"
+    ) ? "/" : pickLandingRoute(hostedDocRoutes);
+    if (landing)
+      plan2.plansPlugin.links = { ...plan2.plansPlugin.links, docs: landing };
+  }
+  const home = resolved.portal?.landing ? void 0 : homeRedirect({
     hostsDocs: plan2.docs,
     docRoutes: hostedDocRoutes,
     externalDocsUrl: profile.docs.url,
@@ -8277,8 +8326,156 @@ async function portalArtifactHash(resolved, manifestText, cliVersion, wrapper =
 
 // src/config/v2/services.ts
 init_invariant();
-import { access as access3, mkdir as mkdir5, rename as rename3, rm as rm4, stat as stat3, writeFile as writeFile7 } from "node:fs/promises";
+import {
+  access as access3,
+  mkdir as mkdir5,
+  readdir as readdir3,
+  rename as rename3,
+  rm as rm4,
+  stat as stat3,
+  writeFile as writeFile7
+} from "node:fs/promises";
 import path14 from "node:path";
+
+// src/config/v2/starter-landing.ts
+function starterLandingPage(options) {
+  const name = JSON.stringify(options.name);
+  const plansImport = options.withPlans ? 'import { usePlansPreview } from "@lukoweb/apitogo-plugin-dev-portal-billing";\n' : "";
+  const plansHook = options.withPlans ? "  // The plans of the project's catalog: the same ones the pricing page shows.\n  const plans = usePlansPreview();\n\n" : "";
+  const plansSection = options.withPlans ? "      <PlansPreviewSection plans={plans} />\n" : "";
+  return `import {
+  ApiShowcaseSection,
+  FeaturesSection,
+  HeroSection,
+  LandingShell,
+  ${options.withPlans ? "PlansPreviewSection,\n  " : ""}PricingCtaSection,
+  StepsSection,
+} from "@lukoweb/apitogo-module-landing";
+${plansImport}
+const NAME = ${name};
+
+export default function LandingPage() {
+${plansHook}  return (
+    <LandingShell
+      title={NAME}
+      description="Documentation, an API reference, sign-in, API keys and plans for your API, in one place."
+    >
+      <HeroSection
+        hero={{
+          badge: "API PORTAL",
+          title: NAME,
+          description:
+            "Everything your developers need to use your API: documentation, an interactive reference, sign-in, API keys and plans.",
+        }}
+        primaryAction={{ label: "Get started", href: "/signup" }}
+        secondaryAction={{ label: "Read the docs", href: "/introduction" }}
+        codeExamples={[
+          {
+            filename: "Call the API",
+            language: "bash",
+            code: \`$ curl https://your-api.example.com/health \\\\
+  -H "x-api-key: YOUR_API_KEY"
+# { "status": "ok" }\`,
+          },
+        ]}
+      />
+      <FeaturesSection
+        section={{
+          label: "What you get",
+          title: "A developer portal that is ready on day one",
+          description:
+            "Edit this page in apitogo/portal/landing/LandingPage.tsx to make it yours.",
+        }}
+        features={[
+          {
+            title: "Documentation",
+            description:
+              "Write pages in Markdown or MDX and they appear in the portal with a sidebar and search.",
+            icon: "book-open",
+          },
+          {
+            title: "API reference",
+            description:
+              "An interactive reference built from your OpenAPI file, with a try-it console.",
+            icon: "code",
+          },
+          {
+            title: "API keys",
+            description:
+              "People sign up, pick a plan and create keys themselves, with no work for you.",
+            icon: "shield-check",
+          },
+          {
+            title: "Plans and limits",
+            description:
+              "Rate limits and monthly quotas per plan, enforced at the gateway.",
+            icon: "gauge",
+          },
+          {
+            title: "Usage",
+            description:
+              "Each developer sees their own request counts and how much of the plan is left.",
+            icon: "activity",
+          },
+          {
+            title: "Sign-in",
+            description:
+              "Accounts and login pages that carry your name and theme.",
+            icon: "boxes",
+          },
+        ]}
+      />
+      <StepsSection
+        steps={[
+          {
+            step: "01",
+            title: "Create an account",
+            description: "Sign up in a minute, no approval queue.",
+          },
+          {
+            step: "02",
+            title: "Pick a plan",
+            description: "Start on the free plan and move up when you need more.",
+          },
+          {
+            step: "03",
+            title: "Call the API",
+            description: "Create a key and make your first request.",
+          },
+        ]}
+      />
+      <ApiShowcaseSection
+        apiShowcase={{
+          title: "Sample endpoints",
+          subtitle: "A slice of what is available. The full list is in the API reference.",
+          browseAllHref: "/api",
+          browseAllLabel: "Browse all APIs",
+          layout: "list",
+          items: [
+            {
+              name: "Health check",
+              path: "/health",
+              method: "GET",
+              summary: "Tells you the service is up.",
+            },
+          ],
+        }}
+      />
+${plansSection}      <PricingCtaSection
+        variant="banner"
+        pricingCta={{
+          title: "Start building today",
+          description: "Create an account and get your API key in minutes.",
+          primaryAction: { label: "Get started", href: "/signup" },
+        }}
+      />
+    </LandingShell>
+  );
+}
+`;
+}
+
+// src/config/v2/services.ts
 var SERVICES = ["portal", "gateway", "identity", "plans"];
 var ServiceEditError = class extends ApitogoError {
   constructor(message, developerHint, missingServices = []) {
@@ -8288,11 +8485,34 @@ var ServiceEditError = class extends ApitogoError {
   }
 };
 var httpsProblem = (value) => /^https:\/\/\S+$/i.test(value) ? void 0 : "The address must start with https://";
-var DEFAULT_RUNTIME_VERSION = {
-  nodejs: "NODE_22_LTS",
-  python: "PYTHON_312",
-  dotnet: "DOTNET_8"
+var RUNTIME_VERSIONS = {
+  nodejs: [
+    { value: "NODE_22_LTS", label: "Node.js 22 (LTS)" },
+    { value: "NODE_24_LTS", label: "Node.js 24 (LTS)" }
+  ],
+  python: [
+    { value: "PYTHON_312", label: "Python 3.12" },
+    { value: "PYTHON_310", label: "Python 3.10" },
+    { value: "PYTHON_311", label: "Python 3.11" },
+    { value: "PYTHON_313", label: "Python 3.13" },
+    { value: "PYTHON_314", label: "Python 3.14" }
+  ],
+  dotnet: [
+    { value: "DOTNET_8", label: ".NET 8" },
+    { value: "DOTNET_9", label: ".NET 9" },
+    { value: "DOTNET_10", label: ".NET 10" }
+  ]
 };
+function runtimeVersionSlug(runtime, value) {
+  const upper = value.trim().toUpperCase();
+  const known = RUNTIME_VERSIONS[runtime].map(
+    (choice) => choice.value
+  );
+  if (known.includes(upper)) return upper;
+  const digits = value.trim().toLowerCase().replace(/^(v|python|\.net|dotnet|node(js)?)[ _-]?/, "").replace(/(\.x|_lts| lts)$/, "");
+  const candidate = runtime === "nodejs" ? `NODE_${digits.split(".")[0]}_LTS` : runtime === "python" ? `PYTHON_${digits.replace(".", "")}` : `DOTNET_${digits.split(".")[0]}`;
+  return known.includes(candidate) ? candidate : value;
+}
 var SERVICE_LABELS = {
   portal: "Developer website",
   gateway: "API protection",
@@ -8341,6 +8561,31 @@ var PLAN_TEMPLATES = {
       }
     }
   ],
+  // Sample plans for the starter: a free plan and two with a price on request, so they show on the pricing page and
+  // the home page and still deploy on a Free project (a plan with a price needs a paid platform plan and billing).
+  starter: [
+    {
+      sku: "free",
+      displayName: "Free",
+      default: true,
+      limits: {
+        rateLimit: { calls: 3, periodSeconds: 60 },
+        quota: { calls: 1e3, periodDays: 30 }
+      }
+    },
+    {
+      sku: "pro",
+      displayName: "Pro",
+      pricingModel: "custom",
+      priceLabel: "Contact us"
+    },
+    {
+      sku: "enterprise",
+      displayName: "Enterprise",
+      pricingModel: "custom",
+      priceLabel: "Contact us"
+    }
+  ],
   tiered: [
     {
       sku: "free",
@@ -8411,6 +8656,7 @@ async function buildPortal(context) {
   }
   const name = o.name?.trim() || resolved.project.name;
   let content = [];
+  let landing;
   if (!external) {
     if (Array.isArray(o.docs) && o.docs.length > 0) {
       content = await docsFromPaths(dir, o.docs);
@@ -8442,7 +8688,28 @@ async function buildPortal(context) {
       const pages = path14.join(resolved.root, "portal", "pages");
       if (template === "blank")
         await addFile(context, path14.join(pages, ".gitkeep"), "");
-      else
+      else if (options.template === "starter") {
+        await addFile(
+          context,
+          path14.join(pages, "introduction.mdx"),
+          starterPage(name)
+        );
+        const landingFile = path14.join(
+          resolved.root,
+          "portal",
+          "landing",
+          "LandingPage.tsx"
+        );
+        await addFile(
+          context,
+          landingFile,
+          starterLandingPage({
+            name,
+            withPlans: context.config.plans !== void 0 && context.config.plans.enabled !== false
+          })
+        );
+        landing = rel(dir, landingFile);
+      } else
         await addFile(
           context,
           path14.join(pages, "index.mdx"),
@@ -8454,11 +8721,22 @@ async function buildPortal(context) {
     ...options.disabled ? { enabled: false } : {},
     name,
     ...external ? { docs: { provider: "external", url: docsUrl } } : content.length > 0 ? { docs: { content } } : {},
+    ...landing ? { landing } : {},
     ...o.noConsole ? { console: { enabled: false } } : {},
     ...o.requireAuth ? { requireAuth: true } : {},
     ...o.search && !external ? { search: o.search } : {}
   };
 }
+async function createSourceFolder(context, sourcePath) {
+  const folder = path14.join(context.dir, sourcePath);
+  const entries = await readdir3(folder).catch(() => []);
+  if (entries.some((name) => name !== ".gitkeep")) return;
+  if (entries.length === 0)
+    await addFile(context, path14.join(folder, ".gitkeep"), "");
+  context.notes.push(
+    `The folder ${sourcePath}/ is empty: put your backend code there before you deploy.`
+  );
+}
 async function buildGateway(context) {
   const { options, dir, resolved } = context;
   const o = options.gateway ?? {};
@@ -8499,22 +8777,28 @@ async function buildGateway(context) {
       { value: "python", label: "Python" },
       { value: "dotnet", label: ".NET" }
     ]) : void 0);
-    const runtimeVersion = o.runtimeVersion ?? (ask4 && runtime ? await ask4.text("Runtime version", {
-      default: DEFAULT_RUNTIME_VERSION[runtime]
-    }) : void 0);
+    const runtimeVersion = o.runtimeVersion !== void 0 && runtime ? runtimeVersionSlug(runtime, o.runtimeVersion) : ask4 && runtime ? await ask4.choose(
+      "Runtime version",
+      RUNTIME_VERSIONS[runtime].map((choice, index) => ({
+        value: choice.value,
+        label: index === 0 ? `${choice.label} (suggested)` : choice.label
+      }))
+    ) : void 0;
     if (!source || !runtime || !runtimeVersion) {
       throw new ServiceEditError(
         "--origin managed needs --source, --runtime and --runtime-version.",
-        "For example: --source server --runtime nodejs --runtime-version NODE_22_LTS."
+        runtime ? `For ${runtime}, --runtime-version is one of: ${RUNTIME_VERSIONS[runtime].map((choice) => choice.value).join(", ")} (a short form such as ${runtime === "nodejs" ? "22" : runtime === "python" ? "3.12" : "8"} works too).` : "For example: --source server --runtime nodejs --runtime-version NODE_22_LTS."
       );
     }
+    const sourcePath = insideProject(dir, source, "Source folder");
     origin = {
       mode,
-      source: insideProject(dir, source, "Source folder"),
+      source: sourcePath,
       runtime,
       runtimeVersion,
       ...o.exclude?.length ? { exclude: o.exclude } : {}
     };
+    await createSourceFolder(context, sourcePath);
   }
   let specs;
   let requestedSpecs = o.spec ?? [];
@@ -8637,7 +8921,7 @@ async function buildIdentity(context) {
 async function buildPlans(context) {
   const { options, dir, resolved } = context;
   const o = options.plans ?? {};
-  const template = o.template ?? (options.template === "blank" ? "none" : options.template === "starter" ? "free" : "free");
+  const template = o.template ?? (options.template === "blank" ? "none" : options.template === "starter" ? "starter" : "free");
   const billing = o.billing ?? (template === "tiered" ? "stripe" : "none");
   if (template === "tiered" && billing === "none") {
     throw new ServiceEditError(
@@ -9010,7 +9294,7 @@ init_invariant();
 
 // src/cli/check/v2.ts
 init_apitogo_config_core();
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 import path49 from "node:path";
 
 // src/cli/platform/client/platform-api.ts
@@ -9833,8 +10117,8 @@ var PlatformApiClient = class {
   }
 };
 async function readFileBytes(filePath) {
-  const { readFile: readFile28 } = await import("node:fs/promises");
-  const buffer = await readFile28(filePath);
+  const { readFile: readFile29 } = await import("node:fs/promises");
+  const buffer = await readFile29(filePath);
   const arrayBuffer = new ArrayBuffer(buffer.byteLength);
   new Uint8Array(arrayBuffer).set(buffer);
   return arrayBuffer;
@@ -9931,10 +10215,10 @@ function resolveProjectId(explicit, config2) {
 import {
   access as access4,
   mkdir as mkdir12,
-  readFile as readFile11,
+  readFile as readFile12,
   rename as rename6,
   rm as rm8,
-  writeFile as writeFile14
+  writeFile as writeFile15
 } from "node:fs/promises";
 import path48 from "node:path";
 
@@ -10087,7 +10371,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.2.40",
+  version: "0.2.42",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -14935,6 +15219,7 @@ init_package_json();
 
 // src/cli/init/v2-packages.ts
 import { existsSync as existsSync5 } from "node:fs";
+import { readFile as readFile11, writeFile as writeFile14 } from "node:fs/promises";
 import path47 from "node:path";
 var CORE_PACKAGES = [
   "@lukoweb/apitogo",
@@ -14947,6 +15232,29 @@ var portalPackageSpecs = (version) => [
   "react-dom@19"
 ];
 var installCommand = (version) => `npm install --save-dev ${portalPackageSpecs(version).join(" ")}`;
+function packageNameFrom(name) {
+  const slug = name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[._-]+|[._-]+$/g, "");
+  return slug || "portal";
+}
+async function ensurePackageJson(dir, name) {
+  const file = path47.join(dir, "package.json");
+  if (existsSync5(file)) return false;
+  await writeFile14(
+    file,
+    `${JSON.stringify(
+      {
+        name: packageNameFrom(name),
+        version: "0.0.1",
+        private: true,
+        type: "module"
+      },
+      null,
+      2
+    )}
+`
+  );
+  return true;
+}
 function isPackageInstalled(startDir, name) {
   let dir = path47.resolve(startDir);
   for (; ; ) {
@@ -15028,7 +15336,7 @@ function portalBuildStep(context, options = {}, build2 = runBuild) {
       await mkdir12(path48.dirname(buildDir), { recursive: true });
       await rename6(path48.join(root, "dist"), buildDir);
       if (prepared.publishedManifest) {
-        await writeFile14(
+        await writeFile15(
           path48.join(buildDir, MANIFEST_FILE),
           `${JSON.stringify(prepared.publishedManifest, null, 2)}
 `
@@ -15058,7 +15366,7 @@ async function buildV2(options) {
 }
 
 // src/cli/check/gateway-online.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 var SPEC_SEND_LIMIT = 5 * 1024 * 1024 + 64 * 1024;
 var issue2 = (code, path101, message, hint) => ({ code, path: path101, message, hint });
 function capabilityIssues(gateway, answer) {
@@ -15122,7 +15430,7 @@ async function onlineGatewayRules(gateway, projectId, api, derivedCors = []) {
   const specFile = gateway.specs[0];
   if (specFile) {
     try {
-      const text = await readFile12(specFile, "utf8");
+      const text = await readFile13(specFile, "utf8");
       if (text.length <= SPEC_SEND_LIMIT) spec = text;
     } catch {
     }
@@ -15150,7 +15458,7 @@ async function onlineGatewayRules(gateway, projectId, api, derivedCors = []) {
 
 // src/cli/deploy/plans-file.ts
 init_invariant();
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 import { z as z14 } from "zod";
 var PlansFileError = class extends ApitogoError {
   constructor(code, message, developerHint) {
@@ -15194,7 +15502,7 @@ var issuesOf = (error) => error.issues.map(
 async function readPlansFile(file) {
   let text;
   try {
-    text = await readFile13(file, "utf8");
+    text = await readFile14(file, "utf8");
   } catch {
     throw new PlansFileError(
       "PLANS_FILE_UNREADABLE",
@@ -15385,7 +15693,7 @@ async function onlinePlansRules(resolved, projectId, api) {
 async function isConfigV2(dir) {
   try {
     return /"version"\s*:\s*2\b/.test(
-      await readFile14(path49.join(dir, APITOGO_CONFIG_FILENAME), "utf8")
+      await readFile15(path49.join(dir, APITOGO_CONFIG_FILENAME), "utf8")
     );
   } catch {
     return false;
@@ -15534,10 +15842,8 @@ async function validatePortalBuild(dir) {
 async function runCheckV2(dir, args = {}, deps = {}) {
   const configPath = path49.join(dir, APITOGO_CONFIG_FILENAME);
   let report;
-  let layout;
   try {
     const { config: config2, resolved } = loadConfigV2(dir);
-    layout = resolved.layout;
     const online = await fetchSecretNames(
       config2,
       resolved.project.id,
@@ -15584,7 +15890,6 @@ async function runCheckV2(dir, args = {}, deps = {}) {
     status: report.errors.length > 0 ? "failed" : "ok",
     configVersion: 2,
     configPath,
-    layout,
     ...report
   };
 }
@@ -15757,15 +16062,18 @@ import { existsSync as existsSync6 } from "node:fs";
 import path51 from "node:path";
 var USER_PANEL_PACKAGE = "@lukoweb/apitogo-module-user-panel";
 var BILLING_PLUGIN_PACKAGE = "@lukoweb/apitogo-plugin-dev-portal-billing";
+var LANDING_PACKAGE = "@lukoweb/apitogo-module-landing";
 function packagesForConfig(config2) {
   const portal = config2.portal;
-  if (!portal || portal.enabled === false || portal.console?.enabled === false)
-    return [];
+  if (!portal || portal.enabled === false) return [];
+  const landing = portal.landing ? [LANDING_PACKAGE] : [];
+  if (portal.console?.enabled === false) return landing;
   const identity = config2.identity && config2.identity.enabled !== false;
   const plans = config2.plans && config2.plans.enabled !== false;
   return [
     ...identity || plans ? [USER_PANEL_PACKAGE] : [],
-    ...plans ? [BILLING_PLUGIN_PACKAGE] : []
+    ...plans ? [BILLING_PLUGIN_PACKAGE] : [],
+    ...landing
   ];
 }
 function isInstalled(dir, name) {
@@ -15783,10 +16091,20 @@ function detectPackageManager(dir) {
   if (existsSync6(path51.join(dir, "yarn.lock"))) return "yarn";
   return "npm";
 }
-function installCommand2(manager, names, version) {
-  const specs = names.map((name) => `${name}@${version}`);
-  return manager === "npm" ? { command: "npm", args: ["install", ...specs] } : { command: manager, args: ["add", ...specs] };
+function installSpecsCommand(manager, specs) {
+  return manager === "npm" ? {
+    command: "npm",
+    // Only errors: the audit summary and engine warnings of the dependencies are not about this project.
+    args: [
+      "install",
+      "--no-audit",
+      "--no-fund",
+      "--loglevel=error",
+      ...specs
+    ]
+  } : { command: manager, args: ["add", ...specs] };
 }
+var specName = (spec) => spec.slice(0, spec.lastIndexOf("@"));
 var runInstaller = (dir, { command: command2, args }) => new Promise((resolve, reject) => {
   const child = spawn(command2, args, {
     cwd: dir,
@@ -15803,10 +16121,24 @@ var runInstaller = (dir, { command: command2, args }) => new Promise((resolve, r
     )
   );
 });
+function packagesToInstall(dir, config2) {
+  const portal = config2.portal && config2.portal.enabled !== false;
+  return {
+    core: portal ? missingCorePackages(dir) : [],
+    plugins: missingPackages(dir, packagesForConfig(config2))
+  };
+}
 async function installMissingPackages(dir, config2, version, options) {
-  const missing = missingPackages(dir, packagesForConfig(config2));
+  const { core, plugins } = packagesToInstall(dir, config2);
+  const missing = [...core, ...plugins];
   if (missing.length === 0) return void 0;
-  const command2 = installCommand2(detectPackageManager(dir), missing, version);
+  const specs = [
+    ...portalPackageSpecs(version).filter(
+      (spec) => core.includes(specName(spec))
+    ),
+    ...plugins.map((name) => `${name}@${version}`)
+  ];
+  const command2 = installSpecsCommand(detectPackageManager(dir), specs);
   const shown = `${command2.command} ${command2.args.join(" ")}`;
   if (!options.install)
     return {
@@ -15815,13 +16147,7 @@ async function installMissingPackages(dir, config2, version, options) {
       reason: "--no-install was given",
       command: shown
     };
-  if (!existsSync6(path51.join(dir, "package.json")))
-    return {
-      status: "skipped",
-      packages: missing,
-      reason: "there is no package.json here",
-      command: shown
-    };
+  await ensurePackageJson(dir, config2.project?.name ?? path51.basename(dir));
   await (options.installer ?? runInstaller)(dir, command2);
   return { status: "installed", packages: missing, command: shown };
 }
@@ -15983,7 +16309,7 @@ async function run(action, argv, plan2, deps = {}) {
         }
       }
     }
-    const needed = action === "add" ? missingPackages(dir, packagesForConfig(edit.config)) : [];
+    const needed = action === "add" ? Object.values(packagesToInstall(dir, edit.config)).flat() : [];
     if (!json) {
       for (const line2 of formatServiceEdit(edit))
         printDiagnosticsToConsole(line2);
@@ -16446,7 +16772,7 @@ function formatDevPortalBackendResponse(projectId, backend) {
 // src/cli/platform/helpers/dev-portal-manifest.ts
 init_gateway_limits();
 import { existsSync as existsSync7 } from "node:fs";
-import { access as access5, mkdir as mkdir13, readFile as readFile15, writeFile as writeFile15 } from "node:fs/promises";
+import { access as access5, mkdir as mkdir13, readFile as readFile16, writeFile as writeFile16 } from "node:fs/promises";
 import path56 from "node:path";
 
 // src/cli/make-config/json-config.ts
@@ -17682,7 +18008,7 @@ function applyOpenApiToSiteConfig(config2, options) {
 async function readManifest2(siteDirectory) {
   const filePath = manifestFilePath(siteDirectory);
   if (await pathExists(filePath)) {
-    const raw = await readFile15(filePath, "utf8");
+    const raw = await readFile16(filePath, "utf8");
     const config2 = JSON.parse(raw);
     return extractManifestFromConfig(config2);
   }
@@ -17693,7 +18019,7 @@ async function writeManifest2(siteDirectory, manifest) {
   await mkdir13(path56.dirname(filePath), { recursive: true });
   let config2 = {};
   if (await pathExists(filePath)) {
-    const raw = await readFile15(filePath, "utf8");
+    const raw = await readFile16(filePath, "utf8");
     config2 = JSON.parse(raw);
   }
   const {
@@ -17702,7 +18028,7 @@ async function writeManifest2(siteDirectory, manifest) {
     ...safeManifest
   } = manifest;
   config2 = applyManifestToConfig(config2, safeManifest);
-  await writeFile15(filePath, `${JSON.stringify(config2, null, 2)}
+  await writeFile16(filePath, `${JSON.stringify(config2, null, 2)}
 `, "utf8");
   return filePath;
 }
@@ -17712,9 +18038,9 @@ import {
   access as access6,
   appendFile,
   mkdir as mkdir14,
-  readFile as readFile16,
+  readFile as readFile17,
   unlink,
-  writeFile as writeFile16
+  writeFile as writeFile17
 } from "node:fs/promises";
 import path57 from "node:path";
 var ENV_FILENAME = ".env";
@@ -17818,7 +18144,7 @@ function applyEnvOverrides2(config2, env) {
 }
 async function readEnvFile(filePath) {
   try {
-    const raw = await readFile16(filePath, "utf8");
+    const raw = await readFile17(filePath, "utf8");
     const env = {};
     for (const line2 of raw.split("\n")) {
       const trimmed = line2.trim();
@@ -17951,7 +18277,7 @@ var SECRETS_COLLECTION_INSTRUCTION = "For go-live, plans must already be in apit
 
 // src/cli/platform/helpers/dev-portal-site-validation.ts
 init_gateway_limits();
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
 import path58 from "node:path";
 var cachedFallbackTs;
@@ -18129,7 +18455,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
     let parsed;
     let parseFailed = false;
     try {
-      parsed = JSON.parse(await readFile17(jsonPath, "utf8"));
+      parsed = JSON.parse(await readFile18(jsonPath, "utf8"));
     } catch (error) {
       parseFailed = true;
       issues.push({
@@ -18168,7 +18494,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
     } else {
       for (const relativeFile of existingTsxFiles) {
         checkedFiles.push(relativeFile);
-        const content = await readFile17(
+        const content = await readFile18(
           path58.join(resolvedDir, relativeFile),
           "utf8"
         );
@@ -18191,7 +18517,7 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
 
 // src/cli/platform/helpers/npm-build.ts
 import { spawn as spawn2 } from "node:child_process";
-import { access as access7, readFile as readFile18 } from "node:fs/promises";
+import { access as access7, readFile as readFile19 } from "node:fs/promises";
 import path59 from "node:path";
 var BUILD_LOG_TAIL_BYTES = 8192;
 var MIN_NODE_MAJOR = 20;
@@ -18828,7 +19154,7 @@ var check_default = {
 
 // src/cli/make-config/handler.ts
 import { constants as constants2 } from "node:fs";
-import { access as access11, mkdir as mkdir16, readFile as readFile22, writeFile as writeFile20 } from "node:fs/promises";
+import { access as access11, mkdir as mkdir16, readFile as readFile23, writeFile as writeFile21 } from "node:fs/promises";
 import path69 from "node:path";
 import { stdin as input2 } from "node:process";
 import { glob as glob8 } from "glob";
@@ -18968,12 +19294,12 @@ function withDefaultIncludedActionKeys(plan2, actionKeys) {
 }
 
 // src/cli/scaffold/dev-portal-config-pages.ts
-import { access as access8, readFile as readFile19, rename as rename7, rm as rm9, writeFile as writeFile17 } from "node:fs/promises";
+import { access as access8, readFile as readFile20, rename as rename7, rm as rm9, writeFile as writeFile18 } from "node:fs/promises";
 import path63 from "node:path";
 async function writeConfigAtomically(filePath, content) {
   const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile17(temporaryPath, content, "utf8");
+    await writeFile18(temporaryPath, content, "utf8");
     await rename7(temporaryPath, filePath);
   } catch (error) {
     await rm9(temporaryPath, { force: true });
@@ -19733,7 +20059,7 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label2) {
   if (!configPath) {
     return { updated: false };
   }
-  const original = await readFile19(configPath, "utf8");
+  const original = await readFile20(configPath, "utf8");
   const patched = patchApitogoConfigForNewPage(original, slug, label2, {
     typescript: configPath.endsWith(".tsx")
   });
@@ -19745,7 +20071,7 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label2) {
 }
 
 // src/cli/scaffold/wire-openapi.ts
-import { access as access9, readFile as readFile20, writeFile as writeFile18 } from "node:fs/promises";
+import { access as access9, readFile as readFile21, writeFile as writeFile19 } from "node:fs/promises";
 import path66 from "node:path";
 
 // src/cli/platform/helpers/openapi.ts
@@ -20004,13 +20330,13 @@ async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
   }
   const jsonConfigPath = manifestFilePath(resolvedSource);
   if (await pathExists3(jsonConfigPath)) {
-    const raw = await readFile20(jsonConfigPath, "utf8");
+    const raw = await readFile21(jsonConfigPath, "utf8");
     const siteConfig = JSON.parse(raw);
     const updated = applyOpenApiToSiteConfig(siteConfig, {
       input: input5,
       apiPath: "api"
     });
-    await writeFile18(
+    await writeFile19(
       jsonConfigPath,
       `${JSON.stringify(updated, null, 2)}
 `,
@@ -20018,10 +20344,10 @@ async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
     );
   } else {
     const tsxConfigPath = path66.join(resolvedSource, "apitogo.config.tsx");
-    const configContent = await readFile20(tsxConfigPath, "utf8");
+    const configContent = await readFile21(tsxConfigPath, "utf8");
     try {
       const patched = patchApitogoConfigOpenApiToFile(configContent, input5);
-      await writeFile18(tsxConfigPath, patched);
+      await writeFile19(tsxConfigPath, patched);
     } catch (error) {
       return {
         status: "failed",
@@ -20374,7 +20700,7 @@ export default function ${componentName}() {
 // src/cli/make-config/scaffold-project.ts
 init_package_json();
 import { constants } from "node:fs";
-import { access as access10, mkdir as mkdir15, readFile as readFile21, writeFile as writeFile19 } from "node:fs/promises";
+import { access as access10, mkdir as mkdir15, readFile as readFile22, writeFile as writeFile20 } from "node:fs/promises";
 import path68 from "node:path";
 import { glob as glob7 } from "glob";
 
@@ -20416,7 +20742,7 @@ async function findOpenApiSpecPath(dir) {
   });
   return extra[0] ? toPosix2(extra[0]) : null;
 }
-async function ensurePackageJson(dir) {
+async function ensurePackageJson2(dir) {
   const pkgPath = path68.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
@@ -20452,11 +20778,11 @@ async function ensurePackageJson(dir) {
         typescript: "^5"
       }
     };
-    await writeFile19(pkgPath, `${JSON.stringify(pkg2, null, 2)}
+    await writeFile20(pkgPath, `${JSON.stringify(pkg2, null, 2)}
 `, "utf8");
     return true;
   }
-  const raw = await readFile21(pkgPath, "utf8");
+  const raw = await readFile22(pkgPath, "utf8");
   let pkg;
   try {
     pkg = JSON.parse(raw);
@@ -20479,7 +20805,7 @@ async function ensurePackageJson(dir) {
   for (const [k, v] of Object.entries(baseDeps)) {
     if (!deps[k]) deps[k] = v;
   }
-  await writeFile19(pkgPath, `${JSON.stringify(pkg, null, 2)}
+  await writeFile20(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   return false;
 }
@@ -20514,7 +20840,7 @@ async function ensureTsconfigJson(dir) {
         "user-panel"
       ]
     };
-    await writeFile19(tsPath, `${JSON.stringify(tsconfig, null, 2)}
+    await writeFile20(tsPath, `${JSON.stringify(tsconfig, null, 2)}
 `, "utf8");
     return true;
   }
@@ -20536,17 +20862,17 @@ async function ensurePortalStubFiles(dir) {
   const landingPath = path68.join(dir, "landing", "LandingPage.tsx");
   if (!await fileExists2(landingPath)) {
     await mkdir15(path68.join(dir, "landing"), { recursive: true });
-    await writeFile19(landingPath, LANDING_PAGE_SOURCE, "utf8");
+    await writeFile20(landingPath, LANDING_PAGE_SOURCE, "utf8");
   }
   const plansPath = path68.join(dir, "user-panel", "AccountPlansPage.tsx");
   if (!await fileExists2(plansPath)) {
     await mkdir15(path68.join(dir, "user-panel"), { recursive: true });
-    await writeFile19(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
+    await writeFile20(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
   }
   const dashboardPath = path68.join(dir, "user-panel", "DashboardPage.tsx");
   if (!await fileExists2(dashboardPath)) {
     await mkdir15(path68.join(dir, "user-panel"), { recursive: true });
-    await writeFile19(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
+    await writeFile20(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
   }
   await ensurePublicBrandingFiles(dir);
 }
@@ -20558,11 +20884,11 @@ async function ensurePublicBrandingFiles(dir) {
     if (await fileExists2(dest)) {
       continue;
     }
-    await writeFile19(dest, content, "utf8");
+    await writeFile20(dest, content, "utf8");
   }
   const faviconDest = path68.join(destDir, "Icon.png");
   if (!await fileExists2(faviconDest)) {
-    await writeFile19(faviconDest, Buffer.from(FAVICON_PNG_BASE64, "base64"));
+    await writeFile20(faviconDest, Buffer.from(FAVICON_PNG_BASE64, "base64"));
   }
 }
 async function ensureThinConfigTsx(dir) {
@@ -20570,7 +20896,7 @@ async function ensureThinConfigTsx(dir) {
   if (await fileExists2(tsxPath)) {
     return false;
   }
-  await writeFile19(tsxPath, THIN_WRAPPER_SOURCE, "utf8");
+  await writeFile20(tsxPath, THIN_WRAPPER_SOURCE, "utf8");
   return true;
 }
 
@@ -20585,7 +20911,7 @@ var fileExists3 = async (filePath) => {
   }
 };
 var readJsonConfig = async (filePath) => {
-  const raw = await readFile22(filePath, "utf8");
+  const raw = await readFile23(filePath, "utf8");
   const parsed = JSON.parse(raw);
   if (!isPlainObject3(parsed)) {
     throw new Error(`${APITOGO_JSON_FILENAME} must be a JSON object.`);
@@ -20631,13 +20957,13 @@ async function persistConfig(config2, ctx) {
       force: ctx.force
     })
   };
-  await writeFile20(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
+  await writeFile21(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
   const tsxPath = path69.join(ctx.dir, "apitogo.config.tsx");
   if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
-    const tsxSource = await readFile22(tsxPath, "utf8");
+    const tsxSource = await readFile23(tsxPath, "utf8");
     if (isManagedConfigWrapper(tsxSource)) {
-      await writeFile20(
+      await writeFile21(
         tsxPath,
         buildThinWrapperWithCustomPages(tsxRoutes),
         "utf8"
@@ -20669,7 +20995,7 @@ async function makeConfig(argv) {
   const changes = [];
   try {
     const discoveredOpenApi = await findOpenApiSpecPath(dir);
-    const createdPackageJson = await ensurePackageJson(dir);
+    const createdPackageJson = await ensurePackageJson2(dir);
     const createdTsconfig = await ensureTsconfigJson(dir);
     if (createdPackageJson && !json) {
       printSuccessToConsole(
@@ -20741,7 +21067,7 @@ async function makeConfig(argv) {
           if (action2.kind === "page") {
             const pagePath = path69.join(dir, action2.page.relativePath);
             await mkdir16(path69.dirname(pagePath), { recursive: true });
-            await writeFile20(
+            await writeFile21(
               pagePath,
               buildStarterDocsPageTsx(action2.page.slug, action2.page.title),
               "utf8"
@@ -20850,7 +21176,7 @@ async function makeConfig(argv) {
             argv.pageContent,
             pageTemplate
           );
-          await writeFile20(filePath, tsx, "utf8");
+          await writeFile21(filePath, tsx, "utf8");
           pageResult = {
             action: "updated",
             slug,
@@ -20870,7 +21196,7 @@ async function makeConfig(argv) {
             pageTemplate
           );
           await mkdir16(path69.dirname(filePath), { recursive: true });
-          await writeFile20(filePath, tsx, "utf8");
+          await writeFile21(filePath, tsx, "utf8");
           const configResult = await wireNewDevPortalPageInConfig(
             dir,
             slug,
@@ -21009,11 +21335,21 @@ var config_default = {
 // src/cli/create/handler.ts
 init_apitogo_config_core();
 import { execFile } from "node:child_process";
-import { readFile as readFile23 } from "node:fs/promises";
+import { readFile as readFile24 } from "node:fs/promises";
 import path70 from "node:path";
 import { promisify } from "node:util";
 var execFileAsync = promisify(execFile);
+function nextStepHint(dir) {
+  const linked = loadConfigV2(dir).resolved.project.id;
+  return linked ? "Next: apitogo deploy" : "Next: apitogo project create, then apitogo deploy";
+}
 var DONE = "done";
+var STARTER_SERVICES = [
+  "gateway",
+  "identity",
+  "plans",
+  "portal"
+];
 async function gitHasUncommittedChanges(dir) {
   try {
     const { stdout } = await execFileAsync("git", ["status", "--porcelain"], {
@@ -21027,7 +21363,7 @@ async function gitHasUncommittedChanges(dir) {
 async function defaultName(dir) {
   try {
     const parsed = JSON.parse(
-      await readFile23(path70.join(dir, "package.json"), "utf8")
+      await readFile24(path70.join(dir, "package.json"), "utf8")
     );
     if (typeof parsed.name === "string" && parsed.name.trim())
       return parsed.name.replace(/^@[^/]+\//, "");
@@ -21060,7 +21396,8 @@ async function createProject(argv, deps = {}) {
   };
   try {
     const dir = path70.resolve(process.cwd(), argv.dir ?? ".");
-    const requested = parseServicesFlag(argv.services);
+    let requested = parseServicesFlag(argv.services);
+    let template = argv.template;
     if (!asker && requested.length === 0) {
       throw new InitError(
         "create needs a terminal to ask its questions, and none is available.",
@@ -21098,10 +21435,23 @@ async function createProject(argv, deps = {}) {
     } else {
       say(`${APITOGO_CONFIG_FILENAME} exists: continuing from it.`);
     }
+    if (!template && requested.length === 0 && asker)
+      template = await asker.choose(
+        "What do you want to start from?",
+        [
+          {
+            value: "starter",
+            label: "Starter: every service with examples (home page, sample plans, API reference)"
+          },
+          { value: "blank", label: "Blank: choose the services one by one" }
+        ]
+      );
+    if (template === "starter" && requested.length === 0)
+      requested = STARTER_SERVICES;
     const stepArgs = (service) => ({
       service,
       dir: argv.dir,
-      template: argv.template,
+      template,
       dryRun: argv.dryRun,
       install: argv.install,
       json,
@@ -21153,9 +21503,8 @@ async function createProject(argv, deps = {}) {
       );
       return;
     }
-    printResultToConsole("Setup finished. The same steps as commands:");
-    for (const command2 of commands) printDiagnosticsToConsole(`  ${command2}`);
-    printHintToConsole("Next: apitogo deploy");
+    printResultToConsole("Setup finished.");
+    printHintToConsole(nextStepHint(dir));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     const hint = error instanceof InitError ? error.developerHint : void 0;
@@ -21345,6 +21694,16 @@ function buildProgressSummary(options) {
     terminalStatus: options.terminalStatus
   };
 }
+var MODULE_DISPLAY_NAMES = {
+  "dev-portal": "Developer website",
+  apihub: "API hosting"
+};
+function friendlyModuleNames(text) {
+  return text.replace(
+    /(?:Module|module) (dev-portal|apihub)(?![\w-])/g,
+    (_match, id) => MODULE_DISPLAY_NAMES[id] ?? id
+  );
+}
 function createConsoleProgressReporter(stream = process.stderr) {
   const shared = { spinner: void 0 };
   return {
@@ -21364,7 +21723,9 @@ function createScopedConsoleProgressReporter(stream, stepLabel, shared) {
   const reporter = {
     async onStep(step2, detail) {
       const message = (!animated ? detail?.message : void 0) ?? (detail?.platformStatus ? `${step2}: ${detail.platformStatus}` : step2);
-      const line2 = stepLabel ? `[${stepLabel}] ${message}` : message;
+      const line2 = friendlyModuleNames(
+        stepLabel ? `[${stepLabel}] ${message}` : message
+      );
       if (line2 === lastLine) return;
       lastLine = line2;
       if (!animated) {
@@ -21383,7 +21744,9 @@ function createScopedConsoleProgressReporter(stream, stepLabel, shared) {
     async onNewMessages(messages) {
       for (const entry of messages) {
         writeLine2(
-          stepLabel ? `[${stepLabel}] ${entry.message}` : entry.message
+          friendlyModuleNames(
+            stepLabel ? `[${stepLabel}] ${entry.message}` : entry.message
+          )
         );
       }
     },
@@ -22247,7 +22610,7 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
 }
 
 // src/cli/platform/helpers/openapi-gateway-servers.ts
-import { mkdir as mkdir17, readFile as readFile24, writeFile as writeFile21 } from "node:fs/promises";
+import { mkdir as mkdir17, readFile as readFile25, writeFile as writeFile22 } from "node:fs/promises";
 import path73 from "node:path";
 import YAML3 from "yaml";
 var GATEWAY_URL_ENV_KEY = "APITOGO_GATEWAY_URL";
@@ -22279,7 +22642,7 @@ async function resolveProjectGatewayUrl(client, projectId) {
   return null;
 }
 async function readOpenApiDocument(filePath) {
-  const content = await readFile24(filePath, "utf8");
+  const content = await readFile25(filePath, "utf8");
   const ext = path73.extname(filePath).toLowerCase();
   const parsed = ext === ".json" ? JSON.parse(content) : YAML3.parse(content);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -22295,7 +22658,7 @@ async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApi
   const doc = await readOpenApiDocument(source);
   const rewritten = withGatewayServers(doc, gatewayUrl);
   await mkdir17(path73.dirname(outputPath), { recursive: true });
-  await writeFile21(
+  await writeFile22(
     outputPath,
     `${JSON.stringify(rewritten, null, 2)}
 `,
@@ -22308,7 +22671,7 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
     path73.resolve(siteDirectory),
     APITOGO_CONFIG_FILENAME2
   );
-  const raw = await readFile24(configPath, "utf8");
+  const raw = await readFile25(configPath, "utf8");
   const config2 = JSON.parse(raw);
   const previousApis = config2.apis;
   const previousBackend = config2.backend;
@@ -22321,11 +22684,11 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
   const backend = config2.backend && typeof config2.backend === "object" ? { ...config2.backend } : {};
   backend.openApiPath = relativeInput;
   config2.backend = backend;
-  await writeFile21(configPath, `${JSON.stringify(config2, null, 2)}
+  await writeFile22(configPath, `${JSON.stringify(config2, null, 2)}
 `, "utf8");
   return {
     restore: async () => {
-      const currentRaw = await readFile24(configPath, "utf8");
+      const currentRaw = await readFile25(configPath, "utf8");
       const current = JSON.parse(currentRaw);
       if (previousApis === void 0) {
         delete current.apis;
@@ -22337,7 +22700,7 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
       } else {
         current.backend = previousBackend;
       }
-      await writeFile21(
+      await writeFile22(
         configPath,
         `${JSON.stringify(current, null, 2)}
 `,
@@ -22360,7 +22723,7 @@ async function prepareOpenApiServersForGatewayBuild(options) {
   );
   if (!openApiPath) {
     try {
-      const raw = await readFile24(
+      const raw = await readFile25(
         path73.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
         "utf8"
       );
@@ -22434,7 +22797,7 @@ function collectManifestPublicActionKeys(gateway) {
 }
 
 // src/cli/platform/helpers/publish-ledger.ts
-import { mkdir as mkdir18, readFile as readFile25, writeFile as writeFile22 } from "node:fs/promises";
+import { mkdir as mkdir18, readFile as readFile26, writeFile as writeFile23 } from "node:fs/promises";
 import path74 from "node:path";
 var PUBLISH_LEDGER_RELATIVE_PATH = ".apitogo/publish-state.json";
 function publishLedgerPath(siteDirectory) {
@@ -22443,7 +22806,7 @@ function publishLedgerPath(siteDirectory) {
 async function readPublishLedger(siteDirectory) {
   const filePath = publishLedgerPath(siteDirectory);
   try {
-    const raw = await readFile25(filePath, "utf8");
+    const raw = await readFile26(filePath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed?.version !== 1 || !Array.isArray(parsed.steps)) {
       return null;
@@ -22461,7 +22824,7 @@ async function writePublishLedger(siteDirectory, ledger) {
     version: 1,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  await writeFile22(filePath, `${JSON.stringify(next, null, 2)}
+  await writeFile23(filePath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
   return filePath;
 }
@@ -22975,14 +23338,14 @@ async function createProjectWithWarmPoolRetry(client, body, options) {
 
 // src/cli/platform/helpers/backend-packaging.ts
 import { spawn as spawn3 } from "node:child_process";
-import { mkdtemp, readdir as readdir2, rm as rm10 } from "node:fs/promises";
+import { mkdtemp, readdir as readdir4, rm as rm10 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path75 from "node:path";
 async function directoryHasRuntimeConfig(dir) {
   if (!await pathExists(dir)) {
     return false;
   }
-  const entries = await readdir2(dir);
+  const entries = await readdir4(dir);
   return entries.some((name) => name.endsWith(".runtimeconfig.json"));
 }
 function runDotnetPublish(projectDir, outputDir) {
@@ -23018,7 +23381,7 @@ function runDotnetPublish(projectDir, outputDir) {
   });
 }
 async function findCsproj(projectDir) {
-  const entries = await readdir2(projectDir);
+  const entries = await readdir4(projectDir);
   const csproj = entries.find((name) => name.endsWith(".csproj"));
   return csproj ? path75.join(projectDir, csproj) : null;
 }
@@ -24134,6 +24497,33 @@ async function handleDeleteProject(client, config2, args, progress) {
 }
 
 // src/cli/platform/tools/lifecycle.ts
+function shouldRetryActivation(infrastructureStatus, context) {
+  const status2 = infrastructureStatus?.toLowerCase() ?? "";
+  if (status2 === "failed") return true;
+  if (!context.resumed) return false;
+  return status2 === "none" || status2 === "" || context.timedOut;
+}
+async function retryActivation(client, projectId, steps, progress) {
+  await progress?.onStep("Retrying hosting activation");
+  try {
+    const started = await client.retryAzureInfrastructure(projectId);
+    steps.push({
+      step: "retry_activation",
+      status: "pending",
+      detail: started
+    });
+    return true;
+  } catch (error) {
+    steps.push({
+      step: "retry_activation",
+      status: "skipped",
+      detail: {
+        reason: error instanceof Error ? error.message : String(error)
+      }
+    });
+    return false;
+  }
+}
 async function findExistingProjectByName(client, name) {
   const projects = await client.listProjects();
   return findProjectByNormalizedName(projects, name);
@@ -24238,11 +24628,27 @@ async function handleBootstrapProject(client, config2, args, progress) {
   const projectBeforeModules = await client.getProject(projectId);
   const planSelected = !isPlatformPlanUnselected(projectBeforeModules.planTier);
   if (wait && planSelected) {
-    const binding = await waitForWarmPoolBinding(client, projectId, {
+    if (resumed && shouldRetryActivation(projectBeforeModules.infrastructureStatus, {
+      resumed,
+      timedOut: false
+    })) {
+      await retryActivation(client, projectId, steps, bootstrapProgress);
+    }
+    let binding = await waitForWarmPoolBinding(client, projectId, {
       timeoutMs: args.timeoutMs,
       pollIntervalMs: args.pollIntervalMs,
       progress: bootstrapProgress?.child("Waiting for warm pool binding")
     });
+    if (shouldRetryActivation(binding.project.infrastructureStatus, {
+      resumed,
+      timedOut: binding.timedOut
+    }) && await retryActivation(client, projectId, steps, bootstrapProgress)) {
+      binding = await waitForWarmPoolBinding(client, projectId, {
+        timeoutMs: args.timeoutMs,
+        pollIntervalMs: args.pollIntervalMs,
+        progress: bootstrapProgress?.child("Waiting for warm pool binding")
+      });
+    }
     steps.push({
       step: "wait_warm_pool_binding",
       status: binding.timedOut ? "running" : binding.status,
@@ -24622,7 +25028,7 @@ async function resolveProjectIdForPublish(client, config2, args, wait, progress,
 import path80 from "node:path";
 
 // src/cli/platform/helpers/dev-portal-site-api-url.ts
-import { readdir as readdir3, readFile as readFile26, writeFile as writeFile23 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile27, writeFile as writeFile24 } from "node:fs/promises";
 import path77 from "node:path";
 var SITE_API_BASE_URL_ENV_KEY = "VITE_APITOGO_AUTHENTICATION_API_BASE_URL";
 var PLACEHOLDER_HOST_MARKERS = [
@@ -24647,7 +25053,7 @@ async function readSiteApiBaseUrl(sourceDirectory) {
   const resolved = path77.resolve(sourceDirectory);
   for (const envFile of [".env", ".env.production"]) {
     try {
-      const content = await readFile26(path77.join(resolved, envFile), "utf8");
+      const content = await readFile27(path77.join(resolved, envFile), "utf8");
       const lines = [...content.matchAll(ENV_LINE_GLOBAL_RE)];
       if (lines.length === 0) {
         continue;
@@ -24678,19 +25084,19 @@ async function patchSiteApiBaseUrl(sourceDirectory, apiBaseUrl) {
   for (const envFile of [".env.production", ".env"]) {
     const envPath = path77.join(resolved, envFile);
     try {
-      const content = await readFile26(envPath, "utf8");
+      const content = await readFile27(envPath, "utf8");
       const withoutAssignments = content.replace(ENV_LINE_GLOBAL_RE, "").replace(/\n{3,}/g, "\n\n").trimEnd();
       const patched = withoutAssignments ? `${withoutAssignments}
 ${line2}
 ` : `${line2}
 `;
-      await writeFile23(envPath, patched);
+      await writeFile24(envPath, patched);
       patchedExisting = true;
     } catch {
     }
   }
   if (!patchedExisting) {
-    await writeFile23(path77.join(resolved, ".env"), `${line2}
+    await writeFile24(path77.join(resolved, ".env"), `${line2}
 `);
   }
 }
@@ -24729,7 +25135,7 @@ async function ensureLiveSiteApiBaseUrlForBuild(_client, config2, args, resolveF
 async function* walkFiles(root) {
   let entries;
   try {
-    entries = await readdir3(root, { withFileTypes: true });
+    entries = await readdir5(root, { withFileTypes: true });
   } catch {
     return;
   }
@@ -24758,7 +25164,7 @@ async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiB
   let found = false;
   let foundPlaceholder = false;
   for await (const file of walkFiles(dist)) {
-    const content = await readFile26(file, "utf8");
+    const content = await readFile27(file, "utf8");
     if (content.includes(needle)) {
       found = true;
     }
@@ -26525,7 +26931,12 @@ function printPlanCatalog(payload) {
   if (typeof payload.freeProjectsQuotaHint === "string") {
     printDiagnosticsToConsole(payload.freeProjectsQuotaHint);
   }
-  const catalog = Array.isArray(payload.platformPlanCatalog) ? payload.platformPlanCatalog : [];
+  printPlanOptions(
+    Array.isArray(payload.platformPlanCatalog) ? payload.platformPlanCatalog : []
+  );
+  printDiagnosticsToConsole("");
+}
+function printPlanOptions(catalog) {
   for (const entry of catalog) {
     if (!entry || typeof entry !== "object") continue;
     const plan2 = entry;
@@ -26543,7 +26954,12 @@ function printPlanCatalog(payload) {
       printHintToConsole(`  - ${limitation}`);
     }
   }
+}
+async function pickPlatformPlan() {
+  printDiagnosticsToConsole("Which API ToGo plan should this project use?");
+  printPlanOptions(PLATFORM_PLAN_CATALOG);
   printDiagnosticsToConsole("");
+  return askPlanChoice();
 }
 async function askPlanChoice() {
   const rl = createInterface4({ input: input3, output: output2 });
@@ -26897,7 +27313,7 @@ import path82 from "node:path";
 
 // src/cli/deploy/gateway.ts
 import { createHash as createHash4 } from "node:crypto";
-import { readFile as readFile27 } from "node:fs/promises";
+import { readFile as readFile28 } from "node:fs/promises";
 init_invariant();
 var GatewayDeployError = class extends ApitogoError {
   constructor(code, message, developerHint) {
@@ -26906,6 +27322,12 @@ var GatewayDeployError = class extends ApitogoError {
     this.name = "GatewayDeployError";
   }
 };
+var API_HOSTING_MODULE = "apihub";
+function isHostingNotActivated(error) {
+  return error instanceof PlatformApiError && /module is not activated/i.test(
+    `${error.message} ${error.problem?.detail ?? ""}`
+  );
+}
 var sha256 = (text) => createHash4("sha256").update(text).digest("hex");
 function gatewayNotDeployableReason(gateway) {
   if (gateway.specs.length > 1)
@@ -26929,7 +27351,7 @@ async function readSpec(gateway) {
       "Add one to gateway.specs in the config."
     );
   try {
-    return await readFile27(file);
+    return await readFile28(file);
   } catch {
     throw new GatewayDeployError(
       "GATEWAY_SPEC_UNREADABLE",
@@ -27044,6 +27466,32 @@ async function deployGateway(resolved, projectId, deps, options = {}) {
   const timeoutMs = deps.reconcileTimeoutMs ?? 42e4;
   const backendTimeoutMs = deps.backendTimeoutMs ?? 20 * 6e4;
   const intervalMs = deps.pollIntervalMs ?? 2e3;
+  const claimApiHosting = async () => {
+    await client.activateModule?.(projectId, API_HOSTING_MODULE);
+    const deadline = now() + backendTimeoutMs;
+    for (; ; ) {
+      const state = await client.getInfrastructureStatus?.(
+        projectId,
+        API_HOSTING_MODULE
+      );
+      if (!state || isTerminalInfrastructureStatus(state.status)) {
+        if (state?.status.toLowerCase() === "failed")
+          throw new GatewayDeployError(
+            "GATEWAY_HOSTING_FAILED",
+            `The platform could not prepare the API hosting: ${state.error ?? "no reason given"}.`,
+            "Run `apitogo project create` again, or `apitogo deploy` once it is fixed."
+          );
+        return;
+      }
+      if (now() >= deadline)
+        throw new GatewayDeployError(
+          "GATEWAY_HOSTING_TIMEOUT",
+          `The API hosting was not ready within ${Math.round(backendTimeoutMs / 6e4)} minutes.`,
+          "Run deploy again to keep waiting."
+        );
+      await sleep5(intervalMs);
+    }
+  };
   const backendStep = {
     name: "backend",
     hash: () => backend?.hash ?? "",
@@ -27061,14 +27509,28 @@ async function deployGateway(resolved, projectId, deps, options = {}) {
         );
         zipPath = packaged.zipPath;
         let started;
+        const upload = () => client.deployBackend(projectId, {
+          archivePath: packaged.zipPath,
+          runtime: backend.runtime,
+          runtimeVersion: backend.runtimeVersion,
+          healthCheckPath: backend.healthPath
+        });
         try {
-          started = await client.deployBackend(projectId, {
-            archivePath: packaged.zipPath,
-            runtime: backend.runtime,
-            runtimeVersion: backend.runtimeVersion,
-            healthCheckPath: backend.healthPath
-          });
+          try {
+            started = await upload();
+          } catch (error) {
+            if (!isHostingNotActivated(error) || !client.activateModule)
+              throw error;
+            await claimApiHosting();
+            started = await upload();
+          }
         } catch (error) {
+          if (isHostingNotActivated(error))
+            throw new GatewayDeployError(
+              "GATEWAY_HOSTING_NOT_ACTIVATED",
+              "The project has no API hosting yet, so there is nowhere to run your backend.",
+              "Run `apitogo project create` again: it finishes the same project and claims the hosting, then run `apitogo deploy`."
+            );
           return rejected("backend upload", error);
         }
         if (!started.reused) {
@@ -28747,7 +29209,7 @@ function formatStatus(output4) {
 }
 
 // src/cli/deploy/static-web-config.ts
-import { access as access13, writeFile as writeFile24 } from "node:fs/promises";
+import { access as access13, writeFile as writeFile25 } from "node:fs/promises";
 import path83 from "node:path";
 var STATIC_WEB_CONFIG_FILE = "staticwebapp.config.json";
 var STATIC_WEB_CONFIG_VERSION = 3;
@@ -28771,7 +29233,7 @@ async function ensureStaticWebConfig(buildDir) {
     await access13(file);
     return false;
   } catch {
-    await writeFile24(
+    await writeFile25(
       file,
       `${JSON.stringify(DEFAULT_STATIC_WEB_CONFIG, null, 2)}
 `,
@@ -29117,6 +29579,12 @@ function formatDeploy(output4) {
 // src/cli/deploy/command.ts
 async function deployProject(argv) {
   const json = argv.json === true;
+  const quiet = json || argv.verbose !== true;
+  if (quiet) applyJsonOnlyDeployQuietMode();
+  if (!json && quiet)
+    printDiagnosticsToConsole(
+      "Deploying. This can take a few minutes; add --verbose to see the build log."
+    );
   try {
     const config2 = loadConfig();
     const output4 = await deployV2(
@@ -29127,7 +29595,7 @@ async function deployProject(argv) {
         env: argv.env,
         force: argv.force === true,
         yes: argv.yes === true,
-        jsonOnly: json
+        jsonOnly: quiet
       },
       {
         client: new PlatformApiClient(config2),
@@ -29201,6 +29669,10 @@ var deploy_default = {
     type: "boolean",
     describe: "Wait for long-running jobs",
     default: true
+  }).option("verbose", {
+    type: "boolean",
+    describe: "Config version 2: show the full build log (by default only the result of each service is printed)",
+    default: false
   }).option("json", {
     type: "boolean",
     describe: "Print raw JSON result only",
@@ -29217,7 +29689,7 @@ var deploy_default = {
 };
 
 // src/cli/export/handler.ts
-import { mkdir as mkdir19, writeFile as writeFile25 } from "node:fs/promises";
+import { mkdir as mkdir19, writeFile as writeFile26 } from "node:fs/promises";
 import path86 from "node:path";
 init_invariant();
 var ExportError = class extends ApitogoError {
@@ -29259,7 +29731,7 @@ async function exportOpenApi(args, deps) {
   if (!args.out) return { text };
   const file = path86.resolve(process.cwd(), args.out);
   await mkdir19(path86.dirname(file), { recursive: true });
-  await writeFile25(file, text);
+  await writeFile26(file, text);
   return { text, file };
 }
 async function exportCommand(args) {
@@ -29680,9 +30152,9 @@ var plan_default = {
 };
 
 // src/cli/project/create-handler.ts
-init_invariant();
 import path88 from "node:path";
 import open3 from "open";
+init_invariant();
 
 // src/cli/project/v2.ts
 init_invariant();
@@ -29893,6 +30365,17 @@ async function createLinkedProject(argv, dir) {
   const json = argv.json === true;
   try {
     assertConfigChecksOut(await runCheckV2(dir));
+    let plan2 = argv.plan;
+    if (!plan2 && !json && process.stdin.isTTY && process.stdout.isTTY && !loadConfigV2(dir).resolved.project.id) {
+      const picked = await pickPlatformPlan();
+      if (!picked) {
+        printResultToConsole(
+          "No plan selected. Run `apitogo project create --plan free|starter|professional` when you are ready."
+        );
+        return;
+      }
+      plan2 = picked;
+    }
     const config2 = loadConfig();
     const client = new PlatformApiClient(config2);
     const progress = createConsoleProgressReporter();
@@ -29902,7 +30385,7 @@ async function createLinkedProject(argv, dir) {
         name: argv.name,
         description: argv.description,
         wait: argv.wait !== false,
-        plan: argv.plan ?? "free",
+        plan: plan2 ?? "free",
         skipPayment: argv.skipPayment === true,
         open: argv.open !== false,
         // In JSON mode the link is returned and a later run continues; otherwise the command waits for the payment.
@@ -29946,7 +30429,7 @@ async function createLinkedProject(argv, dir) {
       return;
     }
     printDiagnosticsToConsole(
-      `Project ${result.projectName} (${result.projectId}) is ready on the ${result.plan ?? "free"} plan${result.modules.length > 0 ? ` with: ${result.modules.join(", ")}` : " (the gateway is created by `apitogo deploy`)"}.`
+      `Project ${result.projectName} (${result.projectId}) is ready on the ${result.plan ?? "free"} plan${result.modules.length > 0 ? ` with: ${result.modules.map((id) => friendlyModuleNames(`module ${id}`)).join(", ")}` : " (the gateway is created by `apitogo deploy`)"}.`
     );
     printResultToConsole(
       "The folder is linked. Run `apitogo deploy` to publish."