@lukoweb/apitogo 0.1.81 → 0.1.82

package/dist/cli/cli.js

@@ -5633,7 +5633,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.81",
+  version: "0.1.82",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -7454,13 +7454,13 @@ var generateCode = (schema2, filePath) => {
 
 // src/vite/api/SchemaManager.ts
 var FALLBACK_VERSION = "default";
-var parseInputString = (input2) => {
-  const idx = input2.indexOf("?");
+var parseInputString = (input3) => {
+  const idx = input3.indexOf("?");
   if (idx === -1)
-    return { filePath: input2, params: {} };
+    return { filePath: input3, params: {} };
   return {
-    filePath: input2.slice(0, idx),
-    params: Object.fromEntries(new URLSearchParams(input2.slice(idx)))
+    filePath: input3.slice(0, idx),
+    params: Object.fromEntries(new URLSearchParams(input3.slice(idx)))
   };
 };
 var canonicalParams = (params) => Object.entries(params).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join("&");
@@ -7496,8 +7496,8 @@ var SchemaManager = class {
       ...processors
     ];
   }
-  getPathForFile = (input2, params) => {
-    const filePath = path11.resolve(this.config.__meta.rootDir, input2);
+  getPathForFile = (input3, params) => {
+    const filePath = path11.resolve(this.config.__meta.rootDir, input3);
     const apis = ensureArray(this.config.apis ?? []);
     for (const apiConfig of apis) {
       if (!apiConfig || apiConfig.type !== "file" || !apiConfig.path) continue;
@@ -7507,12 +7507,12 @@ var SchemaManager = class {
       if (match) return apiConfig.path;
     }
   };
-  processSchema = async (input2) => {
-    const filePath = path11.resolve(this.config.__meta.rootDir, input2.input);
-    const params = input2.params;
-    const configuredPath = this.getPathForFile(input2.input, params);
+  processSchema = async (input3) => {
+    const filePath = path11.resolve(this.config.__meta.rootDir, input3.input);
+    const params = input3.params;
+    const configuredPath = this.getPathForFile(input3.input, params);
     if (!configuredPath) {
-      console.warn(`No path found for file ${input2.input}`);
+      console.warn(`No path found for file ${input3.input}`);
       return;
     }
     const parser = new $RefParser2();
@@ -7619,20 +7619,20 @@ var SchemaManager = class {
       if (apiConfig.type !== "file" || !apiConfig.path) continue;
       const inputs = normalizeInputs(apiConfig.input);
       if (inputs.length === 0) throw new Error("No schema found");
-      this.processedSchemas[apiConfig.path] = inputs.map((input2) => ({
+      this.processedSchemas[apiConfig.path] = inputs.map((input3) => ({
         schema: {},
         version: "",
-        path: input2.path ?? "",
-        label: input2.label,
-        inputPath: path11.resolve(this.config.__meta.rootDir, input2.input),
-        params: input2.params,
+        path: input3.path ?? "",
+        label: input3.label,
+        inputPath: path11.resolve(this.config.__meta.rootDir, input3.input),
+        params: input3.params,
         importKey: "",
         downloadUrl: "",
         processedJsonPath: "",
         processedTime: 0
       }));
       const results = await Promise.allSettled(
-        inputs.map((input2) => this.processSchema(input2))
+        inputs.map((input3) => this.processSchema(input3))
       );
       const errors = results.flatMap(
         (r) => r.status === "rejected" ? r.reason : []
@@ -7711,7 +7711,7 @@ import { readFile } from "node:fs/promises";
 import matter from "gray-matter";
 import { parse, stringify as stringify2 } from "yaml";
 var yaml = {
-  parse: (input2) => parse(input2) ?? {},
+  parse: (input3) => parse(input3) ?? {},
   stringify: (obj) => stringify2(obj)
 };
 var readFrontmatter = async (filePath) => {
@@ -10520,6 +10520,7 @@ var build_default = {
 import { constants as constants2 } from "node:fs";
 import { access as access3, mkdir as mkdir7, readFile as readFile5, writeFile as writeFile7 } from "node:fs/promises";
 import path36 from "node:path";
+import { stdin as input2 } from "node:process";
 import { glob as glob5 } from "glob";
 
 // src/cli/make-config/interactive.ts
@@ -10783,12 +10784,12 @@ function mergeDocumentationNavigation(navigation, docRoutePaths, options) {
   }
   return [documentation, ...rest];
 }
-function applyOpenApiToJsonConfig(config2, input2) {
+function applyOpenApiToJsonConfig(config2, input3) {
   const next = { ...config2 };
   next.apis = [
     {
       type: "file",
-      input: input2,
+      input: input3,
       path: "api"
     }
   ];
@@ -10831,15 +10832,15 @@ function buildLimitsJson(rateLimitCalls, monthlyQuota) {
     quota: { calls: monthlyQuota, renewalPeriodDays: 30 }
   });
 }
-function buildPlanItemFromWizard(input2) {
-  const sku = input2.sku ?? slugifyPlanSku(input2.displayName);
+function buildPlanItemFromWizard(input3) {
+  const sku = input3.sku ?? slugifyPlanSku(input3.displayName);
   const item = {
     sku,
-    displayName: input2.displayName,
-    priceAmount: input2.priceAmount,
-    limitsJson: buildLimitsJson(input2.rateLimitCalls, input2.monthlyQuota)
+    displayName: input3.displayName,
+    priceAmount: input3.priceAmount,
+    limitsJson: buildLimitsJson(input3.rateLimitCalls, input3.monthlyQuota)
   };
-  if (input2.priceAmount > 0) {
+  if (input3.priceAmount > 0) {
     item.priceCurrency = "usd";
     item.billingPeriod = "month";
   }
@@ -10870,6 +10871,45 @@ function applyPlansToJsonConfig(config2, planItems) {
   modules.userPanel = userPanel;
   return { ...config2, modules };
 }
+var BACKEND_RUNTIMES = ["dotnet", "nodejs", "python"];
+var RUNTIME_VERSIONS_BY_RUNTIME = {
+  nodejs: ["NODE_22_LTS", "NODE_24_LTS"],
+  python: [
+    "PYTHON_310",
+    "PYTHON_311",
+    "PYTHON_312",
+    "PYTHON_313",
+    "PYTHON_314"
+  ],
+  dotnet: ["DOTNET_8", "DOTNET_9", "DOTNET_10"]
+};
+function parseBackendRuntime(raw) {
+  const value = raw.trim().toLowerCase();
+  if (value === "node" || value === "nodejs") {
+    return "nodejs";
+  }
+  if (value === "dotnet" || value === "python") {
+    return value;
+  }
+  return null;
+}
+function parseRuntimeVersion(runtime, raw) {
+  const value = raw.trim().toUpperCase();
+  const allowed = RUNTIME_VERSIONS_BY_RUNTIME[runtime];
+  return allowed.includes(value) ? value : null;
+}
+function applyBackendToJsonConfig(config2, backend) {
+  const existing = isPlainObject2(config2.backend) ? config2.backend : {};
+  return {
+    ...config2,
+    backend: {
+      ...existing,
+      sourceDirectory: backend.sourceDirectory,
+      runtime: backend.runtime,
+      runtimeVersion: backend.runtimeVersion
+    }
+  };
+}
 function toRoutePath(relativeFile, pagesDir) {
   const relativeNoExt = relativeFile.replace(/\.(mdx?|tsx|jsx)$/i, "");
   const escaped = pagesDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -11022,45 +11062,95 @@ var parseLoopChoice = (raw) => {
   if (!value || value === "done") {
     return "done";
   }
-  if (value === "openapi" || value === "page" || value === "plan") {
+  if (value === "backend" || value === "openapi" || value === "page" || value === "plan") {
     return value;
   }
   return null;
 };
-async function promptMakeConfigInteractive(defaults) {
+async function promptMakeConfigInteractive(options) {
   const rl = createInterface({ input, output });
-  const customPages = [];
-  const planItems = [];
   let hasPaidPlans = false;
-  let openApiPath;
   try {
-    const title = await ask(rl, "Site title", defaults.title);
     while (true) {
       const choiceRaw = await ask(
         rl,
-        "Add OpenAPI, a custom page, or a plan? (openapi / page / plan / done)",
+        "What do you want to configure? (backend / openapi / page / plan / done)",
         "done"
       );
       const choice = parseLoopChoice(choiceRaw);
       if (!choice) {
-        printDiagnosticsToConsole("Choose openapi, page, plan, or done.");
+        printDiagnosticsToConsole(
+          "Choose backend, openapi, page, plan, or done."
+        );
         continue;
       }
       if (choice === "done") {
         break;
       }
+      if (choice === "backend") {
+        const sourceDirectory = await ask(
+          rl,
+          "Backend source directory (relative to portal)",
+          ".."
+        );
+        if (!sourceDirectory.trim()) {
+          printDiagnosticsToConsole("Backend source directory is required.");
+          continue;
+        }
+        let runtime = null;
+        while (!runtime) {
+          const runtimeRaw = await ask(
+            rl,
+            `Runtime (${BACKEND_RUNTIMES.join(" / ")})`,
+            "nodejs"
+          );
+          runtime = parseBackendRuntime(runtimeRaw);
+          if (!runtime) {
+            printDiagnosticsToConsole(
+              `Choose one of: ${BACKEND_RUNTIMES.join(", ")} (node \u2192 nodejs).`
+            );
+          }
+        }
+        const versions = RUNTIME_VERSIONS_BY_RUNTIME[runtime];
+        let runtimeVersion = null;
+        while (!runtimeVersion) {
+          const versionRaw = await ask(
+            rl,
+            `Runtime version (${versions.join(" / ")})`,
+            versions[0]
+          );
+          runtimeVersion = parseRuntimeVersion(runtime, versionRaw);
+          if (!runtimeVersion) {
+            printDiagnosticsToConsole(
+              `Choose one of: ${versions.join(", ")}.`
+            );
+          }
+        }
+        const backend = {
+          sourceDirectory: sourceDirectory.trim(),
+          runtime,
+          runtimeVersion
+        };
+        await options.onApplied({ kind: "backend", backend });
+        printDiagnosticsToConsole(
+          `Backend saved: ${backend.runtime} ${backend.runtimeVersion} (sourceDirectory: ${backend.sourceDirectory}).`
+        );
+        continue;
+      }
       if (choice === "openapi") {
         const entered = await ask(
           rl,
           "OpenAPI file path (leave empty to skip)",
-          defaults.discoveredOpenApi ?? ""
+          options.discoveredOpenApi ?? ""
         );
-        openApiPath = entered ? entered : null;
-        if (openApiPath) {
-          printDiagnosticsToConsole(
-            `OpenAPI will be linked as a relative path in apitogo.config.json.`
-          );
+        if (!entered) {
+          printDiagnosticsToConsole("OpenAPI skipped.");
+          continue;
         }
+        await options.onApplied({ kind: "openapi", openApiPath: entered });
+        printDiagnosticsToConsole(
+          `OpenAPI linked as a relative path in apitogo.config.json.`
+        );
         continue;
       }
       if (choice === "page") {
@@ -11079,14 +11169,14 @@ async function promptMakeConfigInteractive(defaults) {
           continue;
         }
         const routePath = `/${slug}`;
-        const relativePath = path34.posix.join(defaults.pagesDir, `${slug}.tsx`);
+        const relativePath = path34.posix.join(options.pagesDir, `${slug}.tsx`);
         const page = {
           slug,
           title: pageTitle.trim(),
           routePath,
           relativePath
         };
-        customPages.push(page);
+        await options.onApplied({ kind: "page", page });
         printPageAddedHint(relativePath, routePath);
         continue;
       }
@@ -11116,25 +11206,15 @@ async function promptMakeConfigInteractive(defaults) {
         rateLimitCalls,
         monthlyQuota
       });
-      planItems.push(planItem);
-      if (priceAmount > 0) {
+      const paid = priceAmount > 0;
+      if (paid) {
         hasPaidPlans = true;
         printPaidPlanPlatformWarning();
       }
+      await options.onApplied({ kind: "plan", planItem, paid });
       printPlanAddedHint(displayName.trim());
     }
-    return {
-      title,
-      site: { title },
-      authentication: {
-        enabled: true,
-        type: "dev-portal"
-      },
-      openApiPath,
-      customPages,
-      planItems,
-      hasPaidPlans
-    };
+    return { hasPaidPlans };
   } finally {
     rl.close();
   }
@@ -11414,11 +11494,65 @@ var readJsonConfig = async (filePath) => {
   }
   return parsed;
 };
+function shouldRunInteractive(argv) {
+  if (argv.interactive === true) {
+    return true;
+  }
+  if (argv.interactive === false) {
+    return false;
+  }
+  const hasPatchFlags = argv.title !== void 0 || argv.site !== void 0 || argv.theme !== void 0 || argv.authentication !== void 0 || argv.force === true;
+  if (hasPatchFlags) {
+    return false;
+  }
+  return input2.isTTY === true;
+}
+async function persistConfig(config2, ctx) {
+  const pageFiles = await glob5(`${ctx.pagesDir}/**/*.{md,mdx,tsx,jsx}`, {
+    cwd: ctx.dir,
+    ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+    posix: true
+  });
+  const markdownFiles = pageFiles.filter((file) => /\.mdx?$/i.test(file));
+  const tsxFiles = pageFiles.filter((file) => /\.(tsx|jsx)$/i.test(file));
+  const markdownRoutes = markdownFiles.map(
+    (file) => toRoutePath(file, ctx.pagesDir)
+  );
+  const tsxRoutes = tsxFiles.map((file) => toRoutePath(file, ctx.pagesDir));
+  if (markdownRoutes.length === 0 && tsxRoutes.length === 0) {
+    printDiagnosticsToConsole(
+      `No docs pages under '${ctx.pagesDir}/' \u2014 skipping documentation nav scan.`
+    );
+  }
+  const next = {
+    ...config2,
+    navigation: mergeDocumentationNavigation(
+      config2.navigation,
+      markdownRoutes,
+      { force: ctx.force }
+    )
+  };
+  await writeFile7(ctx.jsonPath, `${JSON.stringify(next, null, 2)}
+`, "utf8");
+  const tsxPath = path36.join(ctx.dir, "apitogo.config.tsx");
+  if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
+    const tsxSource = await readFile5(tsxPath, "utf8");
+    if (isThinConfigWrapper(tsxSource)) {
+      await writeFile7(
+        tsxPath,
+        buildThinWrapperWithCustomPages(tsxRoutes),
+        "utf8"
+      );
+    }
+  }
+  return next;
+}
 async function makeConfig(argv) {
   const dir = path36.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
+  const interactive = shouldRunInteractive(argv);
   try {
     const discoveredOpenApi = await findOpenApiSpecPath(dir);
     const createdPackageJson = await ensurePackageJson(dir);
@@ -11455,68 +11589,93 @@ async function makeConfig(argv) {
       authentication: parseJsonObjectFlag(argv.authentication, "authentication"),
       title: argv.title
     };
-    let openApiOverride;
+    const persistCtx = {
+      dir,
+      pagesDir,
+      jsonPath,
+      force: argv.force === true
+    };
     let interactiveHasPaidPlans = false;
-    if (argv.interactive) {
-      const site = isPlainObject2(config2.site) ? config2.site : {};
+    if (interactive) {
+      config2 = await persistConfig(config2, persistCtx);
       const prompted = await promptMakeConfigInteractive({
-        title: flagPatches.title ?? (typeof site.title === "string" ? site.title : titleFromDirectoryName(path36.basename(dir))),
         discoveredOpenApi,
-        pagesDir
+        pagesDir,
+        onApplied: async (action2) => {
+          if (action2.kind === "backend") {
+            config2 = applyBackendToJsonConfig(config2, action2.backend);
+            config2 = await persistConfig(config2, persistCtx);
+            return;
+          }
+          if (action2.kind === "openapi") {
+            const openApiInput = toRelativeOpenApiInput(
+              dir,
+              action2.openApiPath
+            );
+            config2 = applyOpenApiToJsonConfig(config2, openApiInput);
+            config2 = await persistConfig(config2, persistCtx);
+            return;
+          }
+          if (action2.kind === "page") {
+            const pagePath = path36.join(dir, action2.page.relativePath);
+            await mkdir7(path36.dirname(pagePath), { recursive: true });
+            await writeFile7(
+              pagePath,
+              buildStarterDocsPageTsx(action2.page.slug, action2.page.title),
+              "utf8"
+            );
+            config2 = await persistConfig(config2, persistCtx);
+            return;
+          }
+          if (action2.kind === "plan") {
+            config2 = applyPlansToJsonConfig(config2, [action2.planItem]);
+            config2 = await persistConfig(config2, persistCtx);
+          }
+        }
       });
-      openApiOverride = prompted.openApiPath;
       interactiveHasPaidPlans = prompted.hasPaidPlans;
-      config2 = applyConfigPatches(config2, prompted);
-      config2 = applyPlansToJsonConfig(config2, prompted.planItems);
-      for (const page of prompted.customPages) {
-        const pagePath = path36.join(dir, page.relativePath);
-        await mkdir7(path36.dirname(pagePath), { recursive: true });
-        await writeFile7(
-          pagePath,
-          buildStarterDocsPageTsx(page.slug, page.title),
-          "utf8"
+    } else {
+      config2 = applyConfigPatches(config2, flagPatches);
+      const pageFiles = await glob5(`${pagesDir}/**/*.{md,mdx,tsx,jsx}`, {
+        cwd: dir,
+        ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+        posix: true
+      });
+      const markdownFiles = pageFiles.filter((file) => /\.mdx?$/i.test(file));
+      const tsxFiles = pageFiles.filter((file) => /\.(tsx|jsx)$/i.test(file));
+      const markdownRoutes = markdownFiles.map(
+        (file) => toRoutePath(file, pagesDir)
+      );
+      const tsxRoutes = tsxFiles.map((file) => toRoutePath(file, pagesDir));
+      if (markdownRoutes.length === 0 && tsxRoutes.length === 0) {
+        printDiagnosticsToConsole(
+          `No docs pages under '${pagesDir}/' \u2014 skipping documentation nav scan.`
         );
       }
-    }
-    config2 = applyConfigPatches(config2, flagPatches);
-    const pageFiles = await glob5(`${pagesDir}/**/*.{md,mdx,tsx,jsx}`, {
-      cwd: dir,
-      ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
-      posix: true
-    });
-    const markdownFiles = pageFiles.filter((file) => /\.mdx?$/i.test(file));
-    const tsxFiles = pageFiles.filter((file) => /\.(tsx|jsx)$/i.test(file));
-    const markdownRoutes = markdownFiles.map(
-      (file) => toRoutePath(file, pagesDir)
-    );
-    const tsxRoutes = tsxFiles.map((file) => toRoutePath(file, pagesDir));
-    if (markdownRoutes.length === 0 && tsxRoutes.length === 0) {
-      printDiagnosticsToConsole(
-        `No docs pages under '${pagesDir}/' \u2014 skipping documentation nav scan.`
+      config2.navigation = mergeDocumentationNavigation(
+        config2.navigation,
+        markdownRoutes,
+        { force: argv.force === true }
       );
-    }
-    config2.navigation = mergeDocumentationNavigation(
-      config2.navigation,
-      markdownRoutes,
-      { force: argv.force === true }
-    );
-    const openApiRel = openApiOverride === void 0 ? discoveredOpenApi : openApiOverride;
-    if (openApiRel) {
-      const openApiInput = argv.interactive ? toRelativeOpenApiInput(dir, openApiRel) : openapiInputForConfig(openApiRel);
-      config2 = applyOpenApiToJsonConfig(config2, openApiInput);
-    }
-    await writeFile7(jsonPath, `${JSON.stringify(config2, null, 2)}
-`, "utf8");
-    const tsxPath = path36.join(dir, "apitogo.config.tsx");
-    if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
-      const tsxSource = await readFile5(tsxPath, "utf8");
-      if (isThinConfigWrapper(tsxSource)) {
-        await writeFile7(
-          tsxPath,
-          buildThinWrapperWithCustomPages(tsxRoutes),
-          "utf8"
+      if (discoveredOpenApi) {
+        config2 = applyOpenApiToJsonConfig(
+          config2,
+          openapiInputForConfig(discoveredOpenApi)
         );
       }
+      await writeFile7(jsonPath, `${JSON.stringify(config2, null, 2)}
+`, "utf8");
+      const tsxPath = path36.join(dir, "apitogo.config.tsx");
+      if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
+        const tsxSource = await readFile5(tsxPath, "utf8");
+        if (isThinConfigWrapper(tsxSource)) {
+          await writeFile7(
+            tsxPath,
+            buildThinWrapperWithCustomPages(tsxRoutes),
+            "utf8"
+          );
+        }
+      }
     }
     const action = createdJson ? "Initialized" : "Updated";
     printResultToConsole(
@@ -11527,7 +11686,7 @@ async function makeConfig(argv) {
         "Next: run npm install (or pnpm install / yarn) in this directory, then npm run dev."
       );
     }
-    if (argv.interactive) {
+    if (interactive) {
       printInteractiveWrapUp(interactiveHasPaidPlans);
     }
   } catch (error) {
@@ -11539,7 +11698,7 @@ async function makeConfig(argv) {
 
 // src/cli/cmds/config.ts
 var config_default = {
-  desc: "Create or update apitogo.config.json from pages, OpenAPI, and optional site/theme/auth flags",
+  desc: "Create or update apitogo.config.json (interactive on TTY: backend, OpenAPI, pages, plans)",
   command: "config",
   aliases: ["make-config"],
   builder: (yargs2) => yargs2.option("dir", {
@@ -11555,8 +11714,7 @@ var config_default = {
   }).option("interactive", {
     alias: "i",
     type: "boolean",
-    describe: "Interactive wizard: site title, OpenAPI path, custom pages, and gateway plans",
-    default: false
+    describe: "Interactive wizard (default on TTY). Apply backend, OpenAPI, pages, and plans immediately. Use --no-interactive for CI/flags-only."
   }).option("site", {
     type: "string",
     describe: "JSON object merged into site"
@@ -12023,10 +12181,11 @@ async function init2(argv) {
       dir,
       pagesDir: "pages",
       title: argv.name,
-      force: false
+      force: false,
+      interactive: false
     });
     printResultToConsole(
-      `Portal scaffolded in ${dir}. Next: apitogo config -i, apitogo dev, then apitogo apply.`
+      `Portal scaffolded in ${dir}. Next: apitogo config, apitogo dev, then apitogo apply.`
     );
   } catch (error) {
     await printCriticalFailureToConsoleAndExit(

package/docs/cli/commands.md

@@ -12,7 +12,7 @@ Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). Platform
 | Command | Role |
 | ------- | ---- |
 | `init` | Scaffold portal locally (no platform calls) |
-| `config` / `make-config` | Write or update `apitogo.config.json` (interactive: OpenAPI, pages, plans) |
+| `config` / `make-config` | Write or update `apitogo.config.json` (interactive: backend, OpenAPI, pages, plans) |
 | `dev` | Local preview server |
 | `build` | Production build (`--preview` to serve locally) |
 | `apply` | Publish config to platform (apihub + portal) |
@@ -24,7 +24,7 @@ Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). Platform
 | Command | Role |
 | ------- | ---- |
 | `init [dir]` | Create `package.json`, stubs, and initial `apitogo.config.json` |
-| `config` | Merge pages nav, wire OpenAPI, patch site/theme/auth; `-i` wizard for OpenAPI, custom pages, plans |
+| `config` | Interactive on TTY: backend, OpenAPI, pages, plans (apply each immediately); flags for site/theme/auth |
 
 `npm create @lukoweb/apitogo@latest` is an interactive alternative to `init` for new folders.
 

package/docs/cli/overview.md

@@ -14,7 +14,7 @@ local files, preview with `apitogo dev`, and publish to APItoGo hosting with `ap
 ## What you get
 
 - Scaffold a local portal site (`npm create @lukoweb/apitogo@latest` or `apitogo init`)
-- Shape OpenAPI, plans, docs pages, and site title via `apitogo config -i` and file edits
+- Shape backend, OpenAPI, plans, and docs pages via `apitogo config` and file edits
 - Preview locally (`apitogo dev`)
 - Publish to APItoGo hosting (`apitogo apply`) with platform plans **Free**, **Starter**, or
   **Professional**
@@ -47,10 +47,11 @@ Common CLI shape tasks:
 
 | Change                              | How                                              |
 | ----------------------------------- | ------------------------------------------------ |
-| OpenAPI + API Reference nav         | `apitogo config` or `apitogo config -i` (openapi) |
-| Custom docs pages                   | `apitogo config -i` (page) or add under `pages/` |
-| Gateway / API plans                 | `apitogo config -i` (plan) or edit manifest      |
-| Site title                          | `apitogo config -i` or `--title`                 |
+| Backend runtime                     | `apitogo config` (backend)                       |
+| OpenAPI + API Reference nav         | `apitogo config` (openapi)                       |
+| Custom docs pages                   | `apitogo config` (page) or add under `pages/`    |
+| Gateway / API plans                 | `apitogo config` (plan) or edit manifest         |
+| Site title                          | `--title` or edit `apitogo.config.json`          |
 | Theme, fonts, branding, projectId   | Edit `apitogo.config.json`                       |
 
 Home page content often lives in `landing/LandingPage.tsx`. Site footer can live under

package/docs/cli/setup.md

@@ -28,7 +28,7 @@ need a global install — scaffold commands add it to your project and `npm inst
 ```bash
 npm create @lukoweb/apitogo@latest
 cd your-project-name
-npx apitogo config -i    # interactive: title, OpenAPI, pages, plans
+npx apitogo config       # interactive: backend, OpenAPI, pages, plans
 npm run dev
 ```
 
@@ -40,7 +40,7 @@ Non-interactive example:
 ```bash
 npm create @lukoweb/apitogo@latest my-portal -- --yes --typescript
 cd my-portal
-npx apitogo config -i
+npx apitogo config
 ```
 
 ### Scaffold into an existing folder
@@ -52,18 +52,18 @@ before other `apitogo` commands:
 npx @lukoweb/apitogo init ./dev-portal
 cd ./dev-portal
 npm install
-npx apitogo config -i
+npx apitogo config
 npm run dev
 ```
 
-`apitogo init` is local only — it does not call the platform. After `config -i`, run `npm run dev`
+`apitogo init` is local only — it does not call the platform. After `config`, run `npm run dev`
 to preview, then `apitogo apply` when ready to go live.
 
 ### How to run `apitogo`
 
 | Situation | Command |
 | --------- | ------- |
-| After `npm create` or `npm install` in the project | `npx apitogo <command>` (e.g. `npx apitogo config -i`) |
+| After `npm create` or `npm install` in the project | `npx apitogo <command>` (e.g. `npx apitogo config`) |
 | Same, if `node_modules/.bin` is on your PATH | `apitogo <command>` |
 | One-off, no project yet | `npx @lukoweb/apitogo <command>` |
 | Optional global install | `npm install -g @lukoweb/apitogo` then `apitogo <command>` anywhere |

package/docs/cli/shape.md

@@ -18,7 +18,7 @@ Requires the **`apitogo`** CLI (`@lukoweb/apitogo`). If you have not installed i
 ```bash
 npm create @lukoweb/apitogo@latest my-portal -- --yes
 cd my-portal
-npx apitogo config -i      # title, OpenAPI, pages, plans
+npx apitogo config         # backend, OpenAPI, pages, plans (apply each immediately)
 npm run dev                # http://localhost:3000
 ```
 
@@ -28,18 +28,20 @@ Or scaffold into an existing folder (`npm install` is required after `init`):
 npx @lukoweb/apitogo init ./dev-portal --name "Books API"
 cd ./dev-portal
 npm install
-npx apitogo config -i
+npx apitogo config
 npm run dev
 ```
 
 `apitogo init` does **not** call the platform. Run `apitogo apply` when you are ready to go live.
 
-## Interactive config (`apitogo config -i`)
+## Interactive config (`apitogo config`)
 
-After **site title**, the wizard loops until you type `done`:
+On a TTY, bare `apitogo config` opens the wizard. Each choice is written immediately; the loop
+continues until you type `done`:
 
 | Choice | What it does |
 | ------ | ------------ |
+| `backend` | Set `backend.sourceDirectory`, `runtime`, and platform `runtimeVersion` |
 | `openapi` | Link an OpenAPI file by **relative path** in `apitogo.config.json` |
 | `page` | Create `pages/<slug>.tsx` and wire it in navigation |
 | `plan` | Add a gateway plan (title, price, rate limit, monthly quota) |
@@ -64,14 +66,14 @@ stubs when missing. Scans `pages/` for navigation and wires OpenAPI when a spec
 npx apitogo config
 npx apitogo config --title "Books API"
 npx apitogo config --theme '{"light":{"primary":"#111111"}}'
-npx apitogo config -i
+npx apitogo config --no-interactive
 ```
 
 Common flags:
 
 | Flag | Purpose |
 | ---- | ------- |
-| `--interactive` / `-i` | Wizard: title, OpenAPI, custom pages, plans |
+| `--interactive` / `-i` | Force wizard (default on TTY). `--no-interactive` skips it |
 | `--title` | Set `site.title` |
 | `--theme`, `--site`, `--authentication` | Deep-merge JSON into config |
 | `--pages-dir` | Folder to scan (default: `pages`) |
@@ -112,7 +114,7 @@ If you already have `pages/` and an OpenAPI spec:
 ```bash
 npx @lukoweb/apitogo init .
 npm install
-npx apitogo config -i
+npx apitogo config
 npm run dev
 ```
 

package/docs/configuration/authentication.md

@@ -30,7 +30,7 @@ Backend API URL (`apitogo apply` writes this to `.env` after the portal backend
 VITE_APITOGO_AUTHENTICATION_API_BASE_URL=https://your-dev-portal-api.example.com
 ```
 
-You do not need to enter this URL in `apitogo config -i`. Or set `authentication.apiBaseUrl` in JSON /
+You do not need to enter this URL in `apitogo config`. Or set `authentication.apiBaseUrl` in JSON /
 `APITOGO_CONFIG_AUTHENTICATION__API_BASE_URL` in `.env` manually.
 
 ### Local demo mode

package/docs/configuration/make-config.mdx

@@ -10,7 +10,8 @@ description:
 The **`apitogo config`** (alias: `make-config`) command writes **`apitogo.config.json`**. It can scaffold a portal
 project (package.json, tsconfig, landing and user-panel stubs, thin `apitogo.config.tsx`) when those
 files are missing, merge **site / theme / authentication** from flags, run an **interactive wizard**
-with `-i`, scan `pages/` for navigation, and wire OpenAPI plus an **API Reference** link.
+on a TTY (apply each change immediately), scan `pages/` for navigation, and wire OpenAPI plus an
+**API Reference** link.
 
 Landing and user panel are **always enabled** on new configs. **Authentication is enabled by default**
 on new scaffolds. The command does **not** change `redirects`.
@@ -34,31 +35,37 @@ Run config from the project root with `npx apitogo config` (or `apitogo config`
    **`apitogo.config.tsx`** wrapper only if that file does not already exist (existing TSX is left
    alone).
 3. **Patches site, theme, and auth** from `--site`, `--theme`, `--authentication`, `--title`, or
-   `--interactive`.
+   the interactive wizard.
 4. **Merges `navigation`** from `.md` / `.mdx` / `.tsx` files under your pages directory into a
    Documentation category when those files exist. **Missing or empty `pages/` is fine** (common for
    portal-only sites) — existing navigation is left alone. Other nav items are kept. Use
    **`--force`** to rebuild Documentation items from disk when pages are present (API Reference is
    still kept when OpenAPI is wired).
-5. **Wires OpenAPI** when a spec is found (non-interactive) or when you enter a path in `-i`:
+5. **Wires OpenAPI** when a spec is found (non-interactive) or when you enter a path in the wizard:
    `apis: [{ type: "file", input, path: "api" }]` and a top-level **API Reference** link to `/api` if
    that link is missing. Interactive mode stores a **relative file path** in `apis[0].input` (for
    example `./openapi.yaml` or `../api/openapi.yaml`).
-6. **Interactive only** — can scaffold **custom pages** under `pages/` and append **gateway plans**
-   to `modules.userPanel.plans.items`.
+6. **Interactive only** — can set **backend** (`sourceDirectory`, `runtime`, `runtimeVersion`),
+   scaffold **custom pages** under `pages/`, and append **gateway plans** to
+   `modules.userPanel.plans.items`. Each choice is written immediately.
 
-## Interactive wizard (`-i`)
+## Interactive wizard
+
+On a TTY, bare `apitogo config` opens the wizard (no `-i` required). `-i` still works as an alias.
+Use `--no-interactive` (or pass flags like `--title`) for CI / non-TTY.
 
 ```bash
-npx apitogo config -i
+npx apitogo config
 ```
 
-1. **Site title**
-2. **Loop** until you type `done`:
+1. **Loop** until you type `done` (default):
+   - **`backend`** — source directory, runtime (`dotnet` / `nodejs` / `python`), platform
+     `runtimeVersion` (writes `backend` in `apitogo.config.json` immediately)
    - **`openapi`** — path to your OpenAPI file (relative link in config; empty skips)
-   - **`page`** — page title + URL path (writes `pages/<slug>.tsx` and wires navigation)
-   - **`plan`** — plan title, price (USD/month), rate limit (calls/min), monthly quota
-3. **Wrap-up** — links to [docs.apitogo.com](https://docs.apitogo.com) for further configuration
+   - **`page`** — page title + URL path (writes `pages/<slug>.tsx` and wires navigation immediately)
+   - **`plan`** — plan title, price (USD/month), rate limit (calls/min), monthly quota (writes
+     immediately)
+2. **Wrap-up** — links to [docs.apitogo.com](https://docs.apitogo.com) for further configuration
 
 The wizard does **not** ask for fonts, colors, logo alt text, or the auth API base URL. Authentication
 stays **enabled**; `apitogo apply` writes `VITE_APITOGO_AUTHENTICATION_API_BASE_URL` to `.env` after
@@ -83,8 +90,8 @@ npx apitogo config
 | ------------------------- | --------------------------------------------------------------------------- |
 | `--pages-dir <dir>`       | Folder to scan for `.md` / `.mdx` / `.tsx` (default: `pages`)               |
 | `--dir <path>`            | Project root (default: current directory)                                   |
-| `--interactive` / `-i`    | Wizard: site title, OpenAPI path, custom pages, gateway plans                 |
-| `--title <string>`        | Set `site.title`                                                            |
+| `--interactive` / `-i`    | Force the wizard (default on TTY). Use `--no-interactive` to skip.          |
+| `--title <string>`        | Set `site.title` (non-interactive)                                          |
 | `--site <json>`           | Deep-merge a JSON object into `site`                                        |
 | `--theme <json>`          | Deep-merge a JSON object into `theme`                                       |
 | `--authentication <json>` | Deep-merge a JSON object into `authentication` (secrets stay in `.env`)     |
@@ -93,9 +100,10 @@ npx apitogo config
 Examples:
 
 ```bash
+npx apitogo config
 npx apitogo config --title "Books API"
 npx apitogo config --theme '{"light":{"primary":"#111111"}}'
-npx apitogo config -i
+npx apitogo config --no-interactive
 ```
 
 Theme and fonts are edited in `apitogo.config.json` or via MCP — not in the interactive wizard. See

package/docs/configuration/manifest.md

@@ -57,7 +57,7 @@ metadata, with optional `.env` overrides for secrets and local tweaks.
 - **Site name / logo:** only `site.title` and `site.logo` (platform branding is derived at publish).
 - **OpenAPI path:** `backend.openApiPath` is derived from `apis[0].input`.
 - **Billing / account plans:** use `modules.userPanel.plans.enabled` and store the plan catalog in
-  `modules.userPanel.plans.items`. Add plans with `apitogo config -i` or edit the manifest by hand.
+  `modules.userPanel.plans.items`. Add plans with `apitogo config` or edit the manifest by hand.
   See [Gateway plans](./plans.md). Legacy root `plans` is migrated on load.
 - **Docs / API keys:** configure under `modules.docs` and `modules.userPanel.apiKeys` only.
 

package/docs/configuration/overview.md

@@ -160,7 +160,7 @@ Put navigation in `apitogo.config.json`, or keep large trees in a separate modul
 ## Related
 
 - [Manifest (`apitogo.config.json`)](./manifest.md)
-- [Make config (CLI)](./make-config.mdx) — interactive wizard (`apitogo config -i`)
+- [Make config (CLI)](./make-config.mdx) — interactive wizard (`apitogo config`)
 - [Gateway plans](./plans.md)
 - [Authentication](./authentication.md)
 - [MCP overview](../mcp/overview.md)

package/docs/configuration/plans.md

@@ -14,12 +14,12 @@ Store the catalog under `modules.userPanel.plans.items` in `apitogo.config.json`
 
 ## Shape with the CLI
 
-`apitogo config -i` can add plans interactively (title, price, rate limit, monthly quota). You can
-also edit the manifest by hand or use MCP `update_dev_portal_manifest`.
+`apitogo config` can add plans interactively (title, price, rate limit, monthly quota). Each plan is
+written immediately. You can also edit the manifest by hand or use MCP `update_dev_portal_manifest`.
 
 ```bash
-npx apitogo config -i
-# loop: plan → enter title, price, policies → done
+npx apitogo config
+# choose plan → enter title, price, policies → done when finished
 ```
 
 ## Canonical shape

package/docs/guides/custom-pages.md

@@ -13,8 +13,8 @@ Start by creating the page you want to add.
 
 ## CLI scaffold
 
-`apitogo config -i` can create a starter page under `pages/` and wire it into navigation. Choose
-`page` in the wizard loop, then edit the generated `.tsx` file.
+`apitogo config` can create a starter page under `pages/` and wire it into navigation immediately.
+Choose `page` in the wizard loop, then edit the generated `.tsx` file.
 
 Predefined UI components (Callout, Card, Button, Heading, and more) are documented under
 [/docs/components](/docs/components).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.81",
+  "version": "0.1.82",
   "type": "module",
   "sideEffects": [
     "**/*.css",