create-apiagex 0.6.2 → 0.6.3

package/README.md

@@ -15,18 +15,20 @@ Current CLI behavior:
 - Supports `--dry-run` to show the scaffold plan without writing files.
 - Creates a small starter scaffold when the target folder is missing or empty.
 
-Interactive setup asks for setup mode, package manager, dependency install preference, git init preference, and owner bootstrap preference.
+Interactive setup asks for setup mode, SQLite database path, host, port, package manager, dependency install preference, git init preference, and optional first owner bootstrap credentials. Postgres and MySQL are planned providers, but SQLite is the supported provider today.
 
 Generated starter files:
 
 - `package.json`
 - `.gitignore`
+- `.env`
 - `.env.example`
 - `apiagex.config.json`
+- `src/index.js`
 - `README.md`
 - `docs/README.md`
 
-The generated `.env.example` documents `APIAGEX_DATABASE_PATH=.apiagex/apiagex.sqlite` and `APIAGEX_UPLOADS_PATH=.apiagex/uploads` for local persistence.
+The generated `.env` stores local setup values such as `APIAGEX_DATABASE_PROVIDER`, `APIAGEX_DATABASE_PATH`, `APIAGEX_UPLOADS_PATH`, `APIAGEX_SECRET`, `HOST`, and `PORT`. If owner bootstrap is enabled, `.env` also contains `APIAGEX_OWNER_EMAIL` and `APIAGEX_OWNER_PASSWORD`; remove the password after the first successful start.
 
 The generated `package.json` depends on `@apiagex/server` and exposes `npm run dev`, `npm run start`, `npm run smoke`, and `npm run build`.
 
@@ -78,18 +80,20 @@ Current CLI behavior:
 - `--dry-run` scaffold plan dikhata hai bina files likhe.
 - Target folder missing ya empty ho to small starter scaffold create hota hai.
 
-Interactive setup setup mode, package manager, dependency install preference, git init preference, aur owner bootstrap preference puchta hai.
+Interactive setup setup mode, SQLite database path, host, port, package manager, dependency install preference, git init preference, aur optional first owner bootstrap credentials puchta hai. Postgres aur MySQL planned providers hain, lekin aaj SQLite supported provider hai.
 
 Generated starter files:
 
 - `package.json`
 - `.gitignore`
+- `.env`
 - `.env.example`
 - `apiagex.config.json`
+- `src/index.js`
 - `README.md`
 - `docs/README.md`
 
-Generated `.env.example` local persistence ke liye `APIAGEX_DATABASE_PATH=.apiagex/apiagex.sqlite` aur `APIAGEX_UPLOADS_PATH=.apiagex/uploads` document karta hai.
+Generated `.env` local setup values store karta hai, jaise `APIAGEX_DATABASE_PROVIDER`, `APIAGEX_DATABASE_PATH`, `APIAGEX_UPLOADS_PATH`, `APIAGEX_SECRET`, `HOST`, aur `PORT`. Owner bootstrap enable ho to `.env` me `APIAGEX_OWNER_EMAIL` aur `APIAGEX_OWNER_PASSWORD` bhi hota hai; first successful start ke baad password hata do.
 
 Generated `package.json` `@apiagex/server` par depend karta hai aur `npm run dev`, `npm run start`, `npm run smoke`, aur `npm run build` expose karta hai.
 

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,0BAA0B,CAAC;AAEtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,MAAM,CA6B7D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtE"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA+C,MAAM,0BAA0B,CAAC;AAExG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,MAAM,CAiE7D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtE"}

package/dist/args.js

@@ -22,6 +22,56 @@ export function parseArgs(args) {
             options.bootstrapOwner = true;
         else if (arg === "--no-owner")
             options.bootstrapOwner = false;
+        else if (arg === "--database") {
+            const value = args[index + 1];
+            if (!isDatabaseProvider(value))
+                return "Use --database sqlite. Postgres and MySQL are planned but not available yet.";
+            options.databaseProvider = value;
+            index += 1;
+        }
+        else if (arg === "--database-path") {
+            const value = args[index + 1];
+            if (!value)
+                return "Use --database-path with a SQLite database path.";
+            options.databasePath = value;
+            index += 1;
+        }
+        else if (arg === "--host") {
+            const value = args[index + 1];
+            if (!value)
+                return "Use --host with a host value.";
+            options.host = value;
+            index += 1;
+        }
+        else if (arg === "--port") {
+            const value = args[index + 1];
+            if (!value || !/^\d+$/.test(value))
+                return "Use --port with a numeric port.";
+            options.port = value;
+            index += 1;
+        }
+        else if (arg === "--app-secret") {
+            const value = args[index + 1];
+            if (!value)
+                return "Use --app-secret with a non-empty secret.";
+            options.appSecret = value;
+            index += 1;
+        }
+        else if (arg === "--owner-email") {
+            const value = args[index + 1];
+            if (!value)
+                return "Use --owner-email with an email address.";
+            options.ownerEmail = value;
+            index += 1;
+        }
+        else if (arg === "--owner-password") {
+            const value = args[index + 1];
+            if (!value)
+                return "Use --owner-password with a password.";
+            options.ownerPassword = value;
+            index += 1;
+            options.bootstrapOwner = true;
+        }
         else if (arg === "--package-manager") {
             const value = args[index + 1];
             if (!isPackageManager(value))
@@ -57,6 +107,9 @@ export function validateProjectSlug(target) {
 function isPackageManager(value) {
     return value === "npm" || value === "pnpm" || value === "yarn";
 }
+function isDatabaseProvider(value) {
+    return value === "sqlite";
+}
 function isSetupMode(value) {
     return value === "quickstart" || value === "custom";
 }

package/dist/create-apiagex.type.d.ts

@@ -1,13 +1,21 @@
 import type { Readable, Writable } from "node:stream";
 export type PackageManager = "npm" | "pnpm" | "yarn";
 export type SetupMode = "custom" | "quickstart";
+export type DatabaseProvider = "sqlite";
 export type CliOptions = {
+    appSecret?: string;
     bootstrapOwner?: boolean;
+    databasePath?: string;
+    databaseProvider?: DatabaseProvider;
     dryRun: boolean;
     help: boolean;
+    host?: string;
     initGit?: boolean;
     installDependencies?: boolean;
+    ownerEmail?: string;
+    ownerPassword?: string;
     packageManager?: PackageManager;
+    port?: string;
     setupMode?: SetupMode;
     target?: string;
     version: boolean;
@@ -30,10 +38,17 @@ export type RunCliOptions = {
     stdout?: Writable;
 };
 export type ScaffoldAnswers = {
+    appSecret: string;
     bootstrapOwner: boolean;
+    databasePath: string;
+    databaseProvider: DatabaseProvider;
+    host: string;
     initGit: boolean;
     installDependencies: boolean;
+    ownerEmail?: string;
+    ownerPassword?: string;
     packageManager: PackageManager;
+    port: string;
     setupMode: SetupMode;
     target: string;
 };

package/dist/create-apiagex.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-apiagex.type.d.ts","sourceRoot":"","sources":["../src/create-apiagex.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}
+{"version":3,"file":"create-apiagex.type.d.ts","sourceRoot":"","sources":["../src/create-apiagex.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 import { parseArgs, validateProjectSlug } from "./args.js";
 import { resolveAnswers } from "./prompts.js";
 import { createScaffoldFiles, renderPlan } from "./scaffold.js";
-const packageVersion = "0.6.2";
+const packageVersion = "0.6.3";
 export async function runCli(args, cwd = process.cwd(), io = {}) {
     const parsed = parseArgs(args);
     if (typeof parsed === "string")
@@ -53,10 +53,17 @@ Usage:
 
 Options:
   --setup quickstart|custom      Choose starter setup mode.
+  --database sqlite              Choose database provider. Postgres and MySQL are planned.
+  --database-path <path>         Set the SQLite database path.
+  --host <host>                  Set the server host.
+  --port <port>                  Set the server port.
+  --app-secret <secret>          Set APIAGEX_SECRET instead of generating one.
+  --owner-email <email>          Set first owner email when owner bootstrap is enabled.
+  --owner-password <password>    Set first owner password and enable owner bootstrap.
   --package-manager npm|pnpm|yarn
   --install, --no-install        Record whether dependencies should be installed after scaffold.
   --git, --no-git                Record whether git should be initialized after scaffold.
-  --owner, --no-owner            Record whether owner setup should happen now or in Admin UI.
+  --owner, --no-owner            Configure first owner bootstrap on first server start.
   --dry-run                      Print the scaffold plan without writing files.
   -y, --yes                      Use defaults for missing options.
   -h, --help                     Show help.

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,CAenH"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,CAkCnH"}

package/dist/prompts.js

@@ -1,4 +1,5 @@
 import { createInterface } from "node:readline/promises";
+import { randomBytes } from "node:crypto";
 export async function resolveAnswers(options, io = {}) {
     const prompt = io.prompt ?? nodePrompt(io);
     const canAsk = Boolean((io.interactive || io.prompt) && !options.yes);
@@ -6,12 +7,31 @@ export async function resolveAnswers(options, io = {}) {
     if (!target)
         return "Target folder is required. Run create-apiagex --help for usage.";
     const setupMode = options.setupMode ?? await choiceAnswer(prompt, canAsk, "Setup mode", "quickstart", ["quickstart", "custom"]);
+    const databaseProvider = options.databaseProvider ?? "sqlite";
+    const databasePath = options.databasePath ?? await setupAnswer(prompt, canAsk, setupMode, "SQLite database path", ".apiagex/apiagex.sqlite");
+    const host = options.host ?? await setupAnswer(prompt, canAsk, setupMode, "Server host", "127.0.0.1");
+    const port = options.port ?? await setupAnswer(prompt, canAsk, setupMode, "Server port", "4000");
+    const appSecret = options.appSecret ?? generateSecret();
     const packageManager = options.packageManager ?? await choiceAnswer(prompt, canAsk, "Package manager", "npm", ["npm", "pnpm", "yarn"]);
+    const bootstrapOwner = await boolAnswer(prompt, canAsk, "Create first owner during first server start?", options.bootstrapOwner, false);
+    const ownerEmail = bootstrapOwner
+        ? options.ownerEmail ?? await setupAnswer(prompt, canAsk, setupMode, "Owner email", "owner@apiagex.local")
+        : undefined;
+    const ownerPassword = bootstrapOwner
+        ? options.ownerPassword ?? await setupAnswer(prompt, canAsk, setupMode, "Owner password", generatePassword())
+        : undefined;
     return {
-        bootstrapOwner: await boolAnswer(prompt, canAsk, "Bootstrap owner during scaffold?", options.bootstrapOwner, false),
+        appSecret,
+        bootstrapOwner,
+        databasePath,
+        databaseProvider,
+        host,
         initGit: await boolAnswer(prompt, canAsk, "Initialize git repository?", options.initGit, true),
         installDependencies: await boolAnswer(prompt, canAsk, "Install dependencies after scaffold?", options.installDependencies, false),
+        ...(ownerEmail === undefined ? {} : { ownerEmail }),
+        ...(ownerPassword === undefined ? {} : { ownerPassword }),
         packageManager,
+        port,
         setupMode,
         target,
     };
@@ -28,10 +48,21 @@ async function choiceAnswer(prompt, canAsk, message, defaultValue, allowed) {
     const answer = await ask(prompt, `${message} (${allowed.join("/")})`, defaultValue);
     return allowed.includes(answer) ? answer : defaultValue;
 }
+async function setupAnswer(prompt, canAsk, setupMode, message, defaultValue) {
+    if (!canAsk || setupMode !== "custom")
+        return defaultValue;
+    return ask(prompt, message, defaultValue);
+}
 async function ask(prompt, message, defaultValue) {
     const answer = (await prompt({ defaultValue, message })).trim();
     return answer || defaultValue;
 }
+function generateSecret() {
+    return randomBytes(32).toString("base64url");
+}
+function generatePassword() {
+    return `Apiagex-${randomBytes(9).toString("base64url")}1!`;
+}
 function nodePrompt(io) {
     return async ({ defaultValue, message }) => {
         const input = io.stdin ?? process.stdin;

package/dist/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE9E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,EAAE,CAoD5E;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAuB3I"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE9E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,EAAE,CAiE5E;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CA0B3I"}

package/dist/scaffold.js

@@ -8,13 +8,13 @@ export function createScaffoldFiles(answers) {
                 private: true,
                 type: "module",
                 scripts: {
-                    dev: "apiagex dev",
-                    start: "apiagex start",
+                    dev: "node --env-file=.env src/index.js",
+                    start: "node --env-file=.env src/index.js",
                     build: "apiagex build",
                     smoke: "apiagex smoke",
                 },
                 dependencies: {
-                    "@apiagex/server": "^0.6.2",
+                    "@apiagex/server": "^0.6.3",
                 },
             }, null, 2)}\n`,
         },
@@ -26,17 +26,30 @@ export function createScaffoldFiles(answers) {
             path: ".gitignore",
             content: "node_modules\n.env\ndist\n.apiagex\n",
         },
+        {
+            path: ".env",
+            content: envFile(answers, true),
+        },
         {
             path: ".env.example",
-            content: "APIAGEX_DATABASE_PATH=.apiagex/apiagex.sqlite\nAPIAGEX_UPLOADS_PATH=.apiagex/uploads\nPORT=4000\nHOST=127.0.0.1\n",
+            content: envFile(answers, false),
         },
         {
             path: "apiagex.config.json",
             content: `${JSON.stringify({
-                database: { provider: "sqlite", url: "file:.apiagex/apiagex.sqlite" },
-                project: { packageManager: answers.packageManager, setupMode: answers.setupMode },
+                database: { provider: answers.databaseProvider, path: answers.databasePath },
+                project: {
+                    appSecretEnv: "APIAGEX_SECRET",
+                    packageManager: answers.packageManager,
+                    setupMode: answers.setupMode,
+                },
+                server: { host: answers.host, port: Number(answers.port) },
             }, null, 2)}\n`,
         },
+        {
+            path: "src/index.js",
+            content: serverEntryFile(),
+        },
         {
             path: "docs/README.md",
             content: docsReadme(),
@@ -52,10 +65,13 @@ export function renderPlan(projectName, targetDir, files, answers, dryRun) {
         "",
         "Selected setup:",
         `- Setup mode: ${answers.setupMode}`,
+        `- Database: ${answers.databaseProvider}`,
+        `- SQLite path: ${answers.databasePath}`,
+        `- Server: http://${answers.host}:${answers.port}`,
         `- Package manager: ${answers.packageManager}`,
         `- Install dependencies: ${answers.installDependencies ? "yes" : "no"}`,
         `- Initialize git: ${answers.initGit ? "yes" : "no"}`,
-        `- Owner setup: ${answers.bootstrapOwner ? "create now" : "create from Admin UI"}`,
+        `- Owner setup: ${answers.bootstrapOwner ? "create from .env on first start" : "create from Admin UI"}`,
         "",
         "Files:",
         fileList,
@@ -86,28 +102,32 @@ ${runCommand(answers.packageManager, "dev")}
 \`\`\`
 
 Open http://127.0.0.1:4000/adminui to create the first owner. Open /doc for API docs and /readme for the readable project summary.
+If .env contains APIAGEX_OWNER_EMAIL and APIAGEX_OWNER_PASSWORD, the first owner is created automatically on first server start. Remove APIAGEX_OWNER_PASSWORD from .env after the first successful start.
 
 ## Scripts
 
-- \`${runCommand(answers.packageManager, "dev")}\`: start the local Apiagex server.
-- \`${runCommand(answers.packageManager, "start")}\`: start the server for regular runtime use.
+- \`${runCommand(answers.packageManager, "dev")}\`: start src/index.js with .env.
+- \`${runCommand(answers.packageManager, "start")}\`: start src/index.js with .env.
 - \`${runCommand(answers.packageManager, "smoke")}\`: verify the runtime health route.
 - \`${runCommand(answers.packageManager, "build")}\`: print runtime build guidance.
 
 ## Environment
 
-Copy .env.example to .env if you need custom paths.
+The installer creates .env for local use. Copy .env.example to .env again if you need to reset local settings.
 
+- APIAGEX_DATABASE_PROVIDER: sqlite today. Postgres and MySQL are planned.
 - APIAGEX_DATABASE_PATH: SQLite database path. Default .apiagex/apiagex.sqlite.
 - APIAGEX_UPLOADS_PATH: upload folder. Default .apiagex/uploads.
+- APIAGEX_SECRET: app secret generated during setup.
 - PORT: server port. Default 4000.
 - HOST: server host. Default 127.0.0.1.
+- APIAGEX_OWNER_EMAIL and APIAGEX_OWNER_PASSWORD: optional first owner bootstrap values. Remove the password after first start.
 
 ## Practical flow
 
 English:
 
-1. Create the first owner from /adminui.
+1. Start the server. If owner env values exist, Apiagex creates the first owner automatically; otherwise create it from /adminui.
 2. Create a schema, for example Article with a required title field.
 3. Create entries from Entries or call POST /api/content/article.
 4. Create Content Roles, save permissions, then create users or API tokens.
@@ -115,7 +135,7 @@ English:
 
 Hinglish:
 
-1. /adminui se first owner create karo.
+1. Server start karo. Owner env values hain to Apiagex first owner automatic create karega; nahi hain to /adminui se create karo.
 2. Schema banao, jaise required title field ke saath Article.
 3. Entries screen se entry banao ya POST /api/content/article call karo.
 4. Content Roles banao, permissions save karo, phir users ya API tokens create karo.
@@ -144,7 +164,7 @@ Use /doc for generated API docs and /readme for the project summary.
 
 English: Open /adminui, create the first owner, then use the same page for later logins.
 
-Hinglish: /adminui open karo, first owner create karo, phir later login ke liye same page use karo.
+Hinglish: /adminui open karo, first owner create karo ya .env owner bootstrap use karo, phir later login ke liye same page use karo.
 
 ## Generated APIs
 
@@ -167,6 +187,38 @@ Hinglish: Webhooks content change ke baad external URLs call karte hain. Realtim
 Relation docs: /doc explains relation field types, entry payloads, populate query options, Admin UI entry pickers, and common errors.
 `;
 }
+function envFile(answers, includeSecrets) {
+    const lines = [
+        `APIAGEX_DATABASE_PROVIDER=${answers.databaseProvider}`,
+        `APIAGEX_DATABASE_PATH=${answers.databasePath}`,
+        "APIAGEX_UPLOADS_PATH=.apiagex/uploads",
+        `APIAGEX_SECRET=${includeSecrets ? answers.appSecret : "change-me"}`,
+        `HOST=${answers.host}`,
+        `PORT=${answers.port}`,
+    ];
+    if (answers.bootstrapOwner) {
+        lines.push(`APIAGEX_OWNER_EMAIL=${answers.ownerEmail ?? "owner@apiagex.local"}`, `APIAGEX_OWNER_PASSWORD=${includeSecrets ? answers.ownerPassword ?? "" : "change-me-after-first-start"}`);
+    }
+    else {
+        lines.push("# APIAGEX_OWNER_EMAIL=owner@apiagex.local", "# APIAGEX_OWNER_PASSWORD=change-me-after-first-start");
+    }
+    return `${lines.join("\n")}\n`;
+}
+function serverEntryFile() {
+    return `import { startApiagex } from "@apiagex/server";
+
+const ownerEmail = process.env.APIAGEX_OWNER_EMAIL;
+const ownerPassword = process.env.APIAGEX_OWNER_PASSWORD;
+
+await startApiagex({
+  host: process.env.HOST ?? "127.0.0.1",
+  port: Number(process.env.PORT ?? 4000),
+  initialOwner: ownerEmail && ownerPassword
+    ? { email: ownerEmail, password: ownerPassword }
+    : undefined,
+});
+`;
+}
 function installCommand(packageManager) {
     return packageManager === "yarn" ? "yarn install" : `${packageManager} install`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-apiagex",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Installer CLI for creating Apiagex CMS projects.",
   "type": "module",
   "license": "MIT",