@jskit-ai/create-app 0.1.0 → 0.1.2

package/README.md

@@ -17,6 +17,8 @@ jskit-create-app --interactive
 - `--template <name>` template name under `templates/` (default `base-shell`)
 - `--title <text>` override the generated app title placeholder
 - `--target <path>` output directory (default `./<app-name>`)
+- `--initial-bundles <preset>` optional framework preset: `none`, `db`, or `db-auth`
+- `--db-provider <provider>` provider for `db` presets: `mysql` or `postgres`
 - `--force` allow writes into non-empty target directories
 - `--dry-run` preview writes only
 - `--interactive` prompt for app values

package/bin/jskit-create-app.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
-import process from "node:process";
-import { runCli } from "../src/index.js";
+import { runCliEntrypoint } from "../src/shared/cliEntrypoint.js";
+import { runCli } from "../src/shared/index.js";
 
-const exitCode = await runCli(process.argv.slice(2));
-if (exitCode !== 0) {
-  process.exit(exitCode);
-}
+await runCliEntrypoint(runCli);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/create-app",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Scaffold minimal JSKIT app shells.",
   "type": "module",
   "files": [
@@ -16,8 +16,9 @@
     "jskit-create-app": "bin/jskit-create-app.js"
   },
   "exports": {
-    ".": "./src/index.js"
+    ".": "./src/shared/index.js"
   },
+  "dependencies": {},
   "engines": {
     "node": "20.x"
   },

package/src/shared/cliEntrypoint.js

@@ -0,0 +1,25 @@
+import process from "node:process";
+
+function shellQuote(value) {
+  const raw = String(value ?? "");
+  if (!raw) {
+    return "''";
+  }
+  if (/^[A-Za-z0-9_./:=+,-]+$/.test(raw)) {
+    return raw;
+  }
+  return `'${raw.replace(/'/g, "'\\''")}'`;
+}
+
+async function runCliEntrypoint(runCli, argv = process.argv.slice(2)) {
+  if (typeof runCli !== "function") {
+    throw new TypeError("runCliEntrypoint requires a runCli function");
+  }
+
+  const exitCode = await runCli(argv);
+  if (exitCode !== 0) {
+    process.exit(exitCode);
+  }
+}
+
+export { shellQuote, runCliEntrypoint };

package/src/{index.js → shared/index.js}

@@ -3,9 +3,15 @@ import path from "node:path";
 import process from "node:process";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
+import { shellQuote } from "./cliEntrypoint.js";
 
 const DEFAULT_TEMPLATE = "base-shell";
-const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const DEFAULT_INITIAL_BUNDLES = "none";
+const DEFAULT_DB_PROVIDER = "mysql";
+const INITIAL_BUNDLE_PRESETS = new Set(["none", "db", "db-auth"]);
+const DB_PROVIDERS = new Set(["mysql", "postgres"]);
+const ALLOWED_EXISTING_TARGET_ENTRIES = new Set([".git"]);
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 const TEMPLATES_ROOT = path.join(PACKAGE_ROOT, "templates");
 
 function createCliError(message, { showUsage = false, exitCode = 1 } = {}) {
@@ -15,17 +21,6 @@ function createCliError(message, { showUsage = false, exitCode = 1 } = {}) {
   return error;
 }
 
-function shellQuote(value) {
-  const raw = String(value ?? "");
-  if (!raw) {
-    return "''";
-  }
-  if (/^[A-Za-z0-9_./:=+,-]+$/.test(raw)) {
-    return raw;
-  }
-  return `'${raw.replace(/'/g, "'\\''")}'`;
-}
-
 function toAppTitle(appName) {
   const words = String(appName)
     .trim()
@@ -36,6 +31,53 @@ function toAppTitle(appName) {
   return words.length > 0 ? words.join(" ") : "App";
 }
 
+function normalizeInitialBundlesPreset(value, { showUsage = true } = {}) {
+  const normalized = String(value || DEFAULT_INITIAL_BUNDLES).trim().toLowerCase();
+  if (INITIAL_BUNDLE_PRESETS.has(normalized)) {
+    return normalized;
+  }
+
+  throw createCliError(
+    `Invalid --initial-bundles value "${value}". Expected one of: none, db, db-auth.`,
+    { showUsage }
+  );
+}
+
+function normalizeDbProvider(value, { showUsage = true } = {}) {
+  const normalized = String(value || DEFAULT_DB_PROVIDER).trim().toLowerCase();
+  if (DB_PROVIDERS.has(normalized)) {
+    return normalized;
+  }
+
+  throw createCliError(
+    `Invalid --db-provider value "${value}". Expected one of: mysql, postgres.`,
+    { showUsage }
+  );
+}
+
+function buildInitialBundleCommands(initialBundles, dbProvider) {
+  const normalizedPreset = normalizeInitialBundlesPreset(initialBundles, { showUsage: false });
+  const normalizedProvider = normalizeDbProvider(dbProvider, { showUsage: false });
+
+  const commands = [];
+  if (normalizedPreset === "db" || normalizedPreset === "db-auth") {
+    commands.push(`npx jskit add db --provider ${normalizedProvider} --no-install`);
+  }
+  if (normalizedPreset === "db-auth") {
+    commands.push("npx jskit add auth-base --no-install");
+  }
+
+  return commands;
+}
+
+function buildProgressiveBundleCommands(dbProvider) {
+  const normalizedProvider = normalizeDbProvider(dbProvider, { showUsage: false });
+  return [
+    `npx jskit add db --provider ${normalizedProvider} --no-install`,
+    "npx jskit add auth-base --no-install"
+  ];
+}
+
 function validateAppName(appName, { showUsage = true } = {}) {
   if (!appName || typeof appName !== "string") {
     throw createCliError("Missing app name.", { showUsage });
@@ -69,6 +111,8 @@ function parseCliArgs(argv) {
     appTitle: null,
     template: DEFAULT_TEMPLATE,
     target: null,
+    initialBundles: DEFAULT_INITIAL_BUNDLES,
+    dbProvider: DEFAULT_DB_PROVIDER,
     force: false,
     dryRun: false,
     help: false,
@@ -136,6 +180,30 @@ function parseCliArgs(argv) {
       continue;
     }
 
+    if (arg === "--initial-bundles") {
+      const { value, nextIndex } = parseOptionWithValue(args, index, "--initial-bundles");
+      options.initialBundles = value;
+      index = nextIndex;
+      continue;
+    }
+
+    if (arg.startsWith("--initial-bundles=")) {
+      options.initialBundles = arg.slice("--initial-bundles=".length);
+      continue;
+    }
+
+    if (arg === "--db-provider") {
+      const { value, nextIndex } = parseOptionWithValue(args, index, "--db-provider");
+      options.dbProvider = value;
+      index = nextIndex;
+      continue;
+    }
+
+    if (arg.startsWith("--db-provider=")) {
+      options.dbProvider = arg.slice("--db-provider=".length);
+      continue;
+    }
+
     if (arg.startsWith("-")) {
       throw createCliError(`Unknown option: ${arg}`, {
         showUsage: true
@@ -171,6 +239,8 @@ function printUsage(stream = process.stderr) {
   stream.write(`  --template <name>  Template folder under templates/ (default: ${DEFAULT_TEMPLATE})\n`);
   stream.write("  --title <text>     App title used for template replacements\n");
   stream.write("  --target <path>    Target directory (default: ./<app-name>)\n");
+  stream.write("  --initial-bundles <preset>  Optional bundle preset: none | db | db-auth (default: none)\n");
+  stream.write("  --db-provider <provider>    Database provider for db presets: mysql | postgres (default: mysql)\n");
   stream.write("  --force            Allow writing into a non-empty target directory\n");
   stream.write("  --dry-run          Print planned writes without changing the filesystem\n");
   stream.write("  --interactive      Prompt for app values instead of passing all flags\n");
@@ -233,7 +303,8 @@ async function ensureTargetDirectoryState(targetDirectory, { force = false, dryR
   }
 
   const entries = await readdir(targetDirectory);
-  if (entries.length > 0 && !force) {
+  const blockingEntries = entries.filter((entry) => !ALLOWED_EXISTING_TARGET_ENTRIES.has(entry));
+  if (blockingEntries.length > 0 && !force) {
     throw createCliError(
       `Target directory is not empty: ${targetDirectory}. Use --force to allow writing into it.`
     );
@@ -335,11 +406,24 @@ async function askYesNoQuestion(readline, label, defaultValue) {
   }
 }
 
-async function collectInteractiveOptions({ parsed, stdout = process.stdout, stderr = process.stderr, stdin = process.stdin }) {
-  const readline = createInterface({
+function createReadlineInterface({ stdin = process.stdin, stdout = process.stdout } = {}) {
+  return createInterface({
     input: stdin,
     output: stdout
   });
+}
+
+async function collectInteractiveOptions({
+  parsed,
+  stdout = process.stdout,
+  stderr = process.stderr,
+  stdin = process.stdin,
+  readlineFactory = createReadlineInterface
+}) {
+  const readline = readlineFactory({
+    stdin,
+    stdout
+  });
 
   try {
     let appName = String(parsed.appName || "").trim();
@@ -368,12 +452,42 @@ async function collectInteractiveOptions({ parsed, stdout = process.stdout, stde
       Boolean(parsed.force)
     );
 
+    let initialBundles = normalizeInitialBundlesPreset(parsed.initialBundles, { showUsage: false });
+    while (true) {
+      const candidate = await askQuestion(
+        readline,
+        "Initial bundle preset (none|db|db-auth)",
+        initialBundles
+      );
+      try {
+        initialBundles = normalizeInitialBundlesPreset(candidate, { showUsage: false });
+        break;
+      } catch (error) {
+        stderr.write(`Error: ${error?.message || String(error)}\n`);
+      }
+    }
+
+    let dbProvider = normalizeDbProvider(parsed.dbProvider, { showUsage: false });
+    if (initialBundles === "db" || initialBundles === "db-auth") {
+      while (true) {
+        const candidate = await askQuestion(readline, "DB provider (mysql|postgres)", dbProvider);
+        try {
+          dbProvider = normalizeDbProvider(candidate, { showUsage: false });
+          break;
+        } catch (error) {
+          stderr.write(`Error: ${error?.message || String(error)}\n`);
+        }
+      }
+    }
+
     return {
       appName,
       appTitle,
       target,
       template,
-      force
+      force,
+      initialBundles,
+      dbProvider
     };
   } finally {
     readline.close();
@@ -385,6 +499,8 @@ export async function createApp({
   appTitle = null,
   template = DEFAULT_TEMPLATE,
   target = null,
+  initialBundles = DEFAULT_INITIAL_BUNDLES,
+  dbProvider = DEFAULT_DB_PROVIDER,
   force = false,
   dryRun = false,
   cwd = process.cwd()
@@ -393,6 +509,8 @@ export async function createApp({
   validateAppName(resolvedAppName);
 
   const resolvedAppTitle = String(appTitle || "").trim() || toAppTitle(resolvedAppName);
+  const resolvedInitialBundles = normalizeInitialBundlesPreset(initialBundles);
+  const resolvedDbProvider = normalizeDbProvider(dbProvider);
 
   const resolvedCwd = path.resolve(cwd);
   const targetDirectory = path.resolve(resolvedCwd, target ? String(target) : resolvedAppName);
@@ -419,6 +537,10 @@ export async function createApp({
     appName: resolvedAppName,
     appTitle: resolvedAppTitle,
     template: String(template),
+    initialBundles: resolvedInitialBundles,
+    dbProvider: resolvedDbProvider,
+    selectedBundleCommands: buildInitialBundleCommands(resolvedInitialBundles, resolvedDbProvider),
+    progressiveBundleCommands: buildProgressiveBundleCommands(resolvedDbProvider),
     targetDirectory,
     dryRun,
     touchedFiles
@@ -431,7 +553,8 @@ export async function runCli(
     stdout = process.stdout,
     stderr = process.stderr,
     stdin = process.stdin,
-    cwd = process.cwd()
+    cwd = process.cwd(),
+    readlineFactory = createReadlineInterface
   } = {}
 ) {
   try {
@@ -449,7 +572,8 @@ export async function runCli(
             parsed,
             stdout,
             stderr,
-            stdin
+            stdin,
+            readlineFactory
           }))
         }
       : parsed;
@@ -459,6 +583,8 @@ export async function runCli(
       appTitle: resolvedOptions.appTitle,
       template: resolvedOptions.template,
       target: resolvedOptions.target,
+      initialBundles: resolvedOptions.initialBundles,
+      dbProvider: resolvedOptions.dbProvider,
       force: resolvedOptions.force,
       dryRun: resolvedOptions.dryRun,
       cwd
@@ -484,6 +610,19 @@ export async function runCli(
       stdout.write(`- cd ${shellQuote(targetLabel)}\n`);
       stdout.write("- npm install\n");
       stdout.write("- npm run dev\n");
+
+      stdout.write("\n");
+      if (result.selectedBundleCommands.length > 0) {
+        stdout.write(`Initial framework bundle commands (${result.initialBundles}):\n`);
+        for (const command of result.selectedBundleCommands) {
+          stdout.write(`- ${command}\n`);
+        }
+      } else {
+        stdout.write("Add framework capabilities when ready:\n");
+        for (const command of result.progressiveBundleCommands) {
+          stdout.write(`- ${command}\n`);
+        }
+      }
     }
 
     return 0;

package/templates/base-shell/Procfile

@@ -0,0 +1 @@
+web: npm run start

package/templates/base-shell/README.md

@@ -9,7 +9,6 @@ This is the smallest practical JSKIT app host:
 - tiny Fastify server (`/api/v1/health`)
 - tiny Vue client shell
 - standardized scripts via `@jskit-ai/app-scripts`
-- framework composition seed file: `framework/app.manifest.mjs`
 
 ## What This Is Not
 
@@ -31,3 +30,10 @@ npm run server
 npm run test
 npm run test:client
 ```
+
+## Progressive Bundles
+
+```bash
+npx jskit add db --provider mysql --no-install
+npx jskit add auth-base --no-install
+```

package/templates/base-shell/package.json

@@ -7,6 +7,9 @@
   "engines": {
     "node": "20.x"
   },
+  "bin": {
+    "jskit": "node_modules/@jskit-ai/jskit/packages/tooling/jskit/bin/jskit.js"
+  },
   "scripts": {
     "server": "jskit-app-scripts server",
     "start": "jskit-app-scripts start",
@@ -20,11 +23,14 @@
   },
   "dependencies": {
     "@jskit-ai/app-scripts": "0.1.0",
+    "@jskit-ai/server-runtime-core": "file:node_modules/@jskit-ai/jskit/packages/runtime/server-runtime-core",
+    "@jskit-ai/surface-routing": "file:node_modules/@jskit-ai/jskit/packages/surface-routing",  
     "fastify": "^5.7.4",
     "vue": "^3.5.13"
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.0",
+    "@jskit-ai/jskit": "github:mobily-enterprises/jskit-ai",
     "@vitejs/plugin-vue": "^5.2.1",
     "eslint": "^9.39.1",
     "vite": "^6.1.0",

package/templates/base-shell/package.json.ACTUAL_CORRECT

@@ -0,0 +1,38 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Minimal JSKIT base app (Fastify + Vue)",
+  "engines": {
+    "node": "20.x"
+  },
+  "bin": {
+    "jskit": "node_modules/@jskit-ai/jskit/packages/tooling/jskit/bin/jskit.js"
+  },
+  "scripts": {
+    "server": "jskit-app-scripts server",
+    "start": "jskit-app-scripts start",
+    "dev": "jskit-app-scripts dev",
+    "build": "jskit-app-scripts build",
+    "preview": "jskit-app-scripts preview",
+    "lint": "jskit-app-scripts lint",
+    "lint:process-env": "jskit-app-scripts lint:process-env",
+    "test": "jskit-app-scripts test",
+    "test:client": "jskit-app-scripts test:client"
+  },
+  "dependencies": {
+    "@jskit-ai/app-scripts": "0.1.0",
+    "@jskit-ai/server-runtime-core": "file:node_modules/@jskit-ai/jskit/packages/runtime/server-runtime-core",
+    "fastify": "^5.7.4",
+    "vue": "^3.5.13"
+  },
+  "devDependencies": {
+    "@jskit-ai/config-eslint": "0.1.0",
+    "@jskit-ai/jskit": "github:mobily-enterprises/jskit-ai",
+    "@vitejs/plugin-vue": "^5.2.1",
+    "eslint": "^9.39.1",
+    "vite": "^6.1.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/base-shell/server.js

@@ -1,15 +1,87 @@
 import Fastify from "fastify";
 import { resolveRuntimeEnv } from "./server/lib/runtimeEnv.js";
+import { registerApiRouteDefinitions } from "@jskit-ai/server-runtime-core/apiRouteRegistration";
+import { createServerRuntimeFromApp, applyContributedRuntimeLifecycle } from "@jskit-ai/server-runtime-core/serverContributions";
+import path from "node:path";
 
-function createServer() {
-  const app = Fastify({ logger: true });
-
+function registerFallbackHealthRoute(app) {
   app.get("/api/v1/health", async () => {
     return {
       ok: true,
       app: "__APP_NAME__"
     };
   });
+}
+
+async function registerContributedRuntime(app, { appRoot, runtimeEnv }) {
+  try {
+    const composed = await createServerRuntimeFromApp({
+      appRoot,
+      strict: false,
+      dependencies: {
+        env: runtimeEnv,
+        logger: app.log
+      },
+      routeConfig: {}
+    });
+
+    const routeCount = Array.isArray(composed.routes) ? composed.routes.length : 0;
+    if (routeCount > 0) {
+      registerApiRouteDefinitions(app, {
+        routes: composed.routes
+      });
+    }
+
+    const lifecycleResult = await applyContributedRuntimeLifecycle({
+      app,
+      runtimeResult: composed,
+      dependencies: {
+        env: runtimeEnv,
+        logger: app.log
+      }
+    });
+
+    app.log.info(
+      {
+        routeCount,
+        pluginCount: lifecycleResult.pluginCount,
+        workerCount: lifecycleResult.workerCount,
+        onBootCount: lifecycleResult.onBootCount,
+        packageOrder: composed.packageOrder
+      },
+      "Registered JSKIT contributed server runtime."
+    );
+
+    return {
+      enabled: true,
+      routeCount,
+      pluginCount: lifecycleResult.pluginCount,
+      workerCount: lifecycleResult.workerCount,
+      onBootCount: lifecycleResult.onBootCount
+    };
+  } catch (error) {
+    const message = String(error?.message || "");
+    if (message.includes("Lock file not found:")) {
+      return {
+        enabled: false,
+        routeCount: 0
+      };
+    }
+    throw error;
+  }
+}
+
+async function createServer() {
+  const app = Fastify({ logger: true });
+  const runtimeEnv = resolveRuntimeEnv();
+  const appRoot = path.resolve(process.cwd());
+  const contributed = await registerContributedRuntime(app, {
+    appRoot,
+    runtimeEnv
+  });
+  if (!contributed.enabled || contributed.routeCount < 1) {
+    registerFallbackHealthRoute(app);
+  }
 
   return app;
 }
@@ -18,7 +90,7 @@ async function startServer(options = {}) {
   const runtimeEnv = resolveRuntimeEnv();
   const port = Number(options?.port) || runtimeEnv.PORT;
   const host = String(options?.host || "").trim() || runtimeEnv.HOST;
-  const app = createServer();
+  const app = await createServer();
   await app.listen({ port, host });
   return app;
 }

package/templates/base-shell/src/App.vue

@@ -0,0 +1,24 @@
+<script setup>
+import { onMounted, ref } from "vue";
+
+const appTitle = "__APP_TITLE__";
+const health = ref("loading...");
+
+onMounted(async () => {
+  try {
+    const response = await fetch("/api/v1/health");
+    const payload = await response.json();
+    health.value = payload?.ok ? "ok" : "unhealthy";
+  } catch {
+    health.value = "unreachable";
+  }
+});
+</script>
+
+<template>
+  <main style="font-family: sans-serif; max-width: 48rem; margin: 3rem auto; padding: 0 1rem;">
+    <h1>{{ appTitle }}</h1>
+    <p>Minimal starter shell is running.</p>
+    <p><strong>Health:</strong> {{ health }}</p>
+  </main>
+</template>

package/templates/base-shell/src/main.js

@@ -1,30 +1,4 @@
-import { createApp, onMounted, ref } from "vue";
-
-const App = {
-  setup() {
-    const health = ref("loading...");
-
-    onMounted(async () => {
-      try {
-        const response = await fetch("/api/v1/health");
-        const payload = await response.json();
-        health.value = payload?.ok ? "ok" : "unhealthy";
-      } catch {
-        health.value = "unreachable";
-      }
-    });
-
-    return {
-      health
-    };
-  },
-  template: `
-    <main style="font-family: sans-serif; max-width: 48rem; margin: 3rem auto; padding: 0 1rem;">
-      <h1>__APP_TITLE__</h1>
-      <p>Minimal starter shell is running.</p>
-      <p><strong>Health:</strong> {{ health }}</p>
-    </main>
-  `
-};
+import { createApp } from "vue";
+import App from "./App.vue";
 
 createApp(App).mount("#app");

package/templates/base-shell/tests/server/minimalShell.contract.test.js

@@ -2,7 +2,7 @@ import assert from "node:assert/strict";
 import test from "node:test";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { readdir, readFile } from "node:fs/promises";
+import { access, readdir, readFile } from "node:fs/promises";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -10,12 +10,14 @@ const APP_ROOT = path.resolve(__dirname, "../..");
 
 const EXPECTED_RUNTIME_DEPENDENCIES = Object.freeze([
   "@jskit-ai/app-scripts",
+  "@jskit-ai/server-runtime-core",
   "fastify",
   "vue"
 ]);
 
 const EXPECTED_DEV_DEPENDENCIES = Object.freeze([
   "@jskit-ai/config-eslint",
+  "@jskit-ai/jskit",
   "@vitejs/plugin-vue",
   "eslint",
   "vite",
@@ -23,20 +25,22 @@ const EXPECTED_DEV_DEPENDENCIES = Object.freeze([
 ]);
 
 const EXPECTED_TOP_LEVEL_ENTRIES = Object.freeze([
+  "Procfile",
   "README.md",
   "app.scripts.config.mjs",
   "bin",
   "eslint.config.mjs",
   "favicon.svg",
-  "framework",
   "gitignore",
   "index.html",
   "package.json",
+  "package.json.ACTUAL_CORRECT",
   "server.js",
   "server",
   "src",
   "tests",
-  "vite.config.mjs"
+  "vite.config.mjs",
+  "vite.shared.mjs"
 ]);
 
 async function readPackageJson() {
@@ -87,14 +91,6 @@ test("starter shell keeps a strict top-level footprint", async () => {
   assert.deepEqual(sortStrings(entries), sortStrings(EXPECTED_TOP_LEVEL_ENTRIES));
 });
 
-test("manifest scaffold exists with strict core-only defaults", async () => {
-  const manifestModule = await import(path.join(APP_ROOT, "framework/app.manifest.mjs"));
-  const manifest = manifestModule?.default;
-
-  assert.equal(manifest.manifestVersion, 1);
-  assert.equal(manifest.appId, "__APP_NAME__");
-  assert.equal(manifest.profileId, "web-saas-default");
-  assert.equal(manifest.mode, "strict");
-  assert.equal(manifest.enforceProfileRequired, true);
-  assert.deepEqual(manifest.optionalModulePacks, ["core"]);
+test("legacy app.manifest scaffold is removed from starter shell", async () => {
+  await assert.rejects(access(path.join(APP_ROOT, "framework/app.manifest.mjs")), /ENOENT/);
 });

package/templates/base-shell/tests/server/smoke.test.js

@@ -3,7 +3,7 @@ import test from "node:test";
 import { createServer } from "../../server.js";
 
 test("GET /api/v1/health returns ok payload", async () => {
-  const app = createServer();
+  const app = await createServer();
   const response = await app.inject({
     method: "GET",
     url: "/api/v1/health"

package/templates/base-shell/vite.config.mjs

@@ -1,19 +1,33 @@
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-
-function toPositiveInt(value, fallback) {
-  const parsed = Number.parseInt(String(value || "").trim(), 10);
-  if (Number.isInteger(parsed) && parsed > 0) {
-    return parsed;
-  }
-  return fallback;
-}
+import { toPositiveInt } from "./vite.shared.mjs";
 
 const devPort = toPositiveInt(process.env.VITE_DEV_PORT, 5173);
 const apiProxyTarget = String(process.env.VITE_API_PROXY_TARGET || "").trim() || "http://localhost:3000";
+const clientEntry = (() => {
+  const normalized = String(process.env.VITE_CLIENT_ENTRY || "").trim();
+  if (!normalized) {
+    return "/src/main.js";
+  }
+  if (normalized.startsWith("/")) {
+    return normalized;
+  }
+  if (normalized.startsWith("src/")) {
+    return `/${normalized}`;
+  }
+  return `/src/${normalized}`;
+})();
 
 export default defineConfig({
-  plugins: [vue()],
+  plugins: [
+    vue(),
+    {
+      name: "jskit-client-entry",
+      transformIndexHtml(source) {
+        return String(source || "").replace(/\/src\/main\.js/g, clientEntry);
+      }
+    }
+  ],
   test: {
     include: ["tests/client/**/*.vitest.js"]
   },

package/templates/base-shell/vite.shared.mjs

@@ -0,0 +1,9 @@
+function toPositiveInt(value, fallback) {
+  const parsed = Number.parseInt(String(value || "").trim(), 10);
+  if (Number.isInteger(parsed) && parsed > 0) {
+    return parsed;
+  }
+  return fallback;
+}
+
+export { toPositiveInt };

package/templates/base-shell/framework/app.manifest.mjs

@@ -1,8 +0,0 @@
-export default Object.freeze({
-  manifestVersion: 1,
-  appId: "__APP_NAME__",
-  profileId: "web-saas-default",
-  mode: "strict",
-  enforceProfileRequired: true,
-  optionalModulePacks: ["core"]
-});