create-apiagex 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aditya Gupta and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# create-apiagex
+
+## English
+
+`create-apiagex` is the installer CLI for starting a new Apiagex project.
+
+Current CLI behavior:
+
+- Prints help with `create-apiagex --help`.
+- Prints version with `create-apiagex --version`.
+- Prompts for project name and setup choices in an interactive terminal.
+- Supports `--yes` and setup flags for CI/non-interactive scaffolding.
+- Validates that the target folder is a safe slug like `my-cms`.
+- Refuses to overwrite an existing non-empty folder.
+- 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.
+
+Generated starter files:
+
+- `package.json`
+- `.gitignore`
+- `.env.example`
+- `apiagex.config.json`
+- `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 `package.json` depends on `apiagex-server` and exposes `npm run dev`, `npm run start`, `npm run smoke`, and `npm run build`.
+
+The generated starter README points users to `/doc`, `/readme`, and `/adminui`, includes practical owner/schema/entry/role/webhook/realtime flow, and explains common errors.
+
+The generated `docs/README.md` explains generated API shape, access control, webhooks, realtime, relation docs, payloads, populate options, Admin UI entry pickers, and common errors.
+
+The generated-project test verifies this scaffold without network installs by creating a temporary project, running the runtime smoke command, starting Apiagex on a temporary port/database, and checking `/api/health`, `/adminui`, `/doc`, and `/readme`.
+
+Example:
+
+```bash
+npm create apiagex@latest my-cms
+npx create-apiagex my-cms
+npm run build -w create-apiagex
+node packages/create-apiagex/dist/index.js my-cms --dry-run
+node packages/create-apiagex/dist/index.js my-cms --yes
+node packages/create-apiagex/dist/index.js --dry-run
+```
+
+Local workspace test before publishing:
+
+```bash
+npm run build -w create-apiagex
+cd newproject
+npx create-apiagex my-cms --yes
+```
+
+After scaffolding:
+
+```bash
+cd my-cms
+npm install
+npm run dev
+```
+
+## Hinglish
+
+`create-apiagex` new Apiagex project start karne ke liye installer CLI hai.
+
+Current CLI behavior:
+
+- `create-apiagex --help` se help print hoti hai.
+- `create-apiagex --version` se version print hota hai.
+- Interactive terminal me project name aur setup choices puche jaate hain.
+- CI/non-interactive scaffold ke liye `--yes` aur setup flags support hain.
+- Target folder safe slug hona chahiye, jaise `my-cms`.
+- Existing non-empty folder overwrite nahi hota.
+- `--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.
+
+Generated starter files:
+
+- `package.json`
+- `.gitignore`
+- `.env.example`
+- `apiagex.config.json`
+- `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 `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.
+
+Generated starter README users ko `/doc`, `/readme`, aur `/adminui` par point karta hai, practical owner/schema/entry/role/webhook/realtime flow include karta hai, aur common errors explain karta hai.
+
+Generated `docs/README.md` generated API shape, access control, webhooks, realtime, relation docs, payloads, populate options, Admin UI entry pickers, aur common errors explain karta hai.
+
+Generated-project test network install ke bina scaffold verify karta hai: temporary project create karta hai, runtime smoke command chalata hai, temporary port/database par Apiagex start karta hai, aur `/api/health`, `/adminui`, `/doc`, plus `/readme` check karta hai.
+
+Example:
+
+```bash
+npm create apiagex@latest my-cms
+npx create-apiagex my-cms
+npm run build -w create-apiagex
+node packages/create-apiagex/dist/index.js my-cms --dry-run
+node packages/create-apiagex/dist/index.js my-cms --yes
+node packages/create-apiagex/dist/index.js --dry-run
+```
+
+Publish se pehle local workspace test:
+
+```bash
+npm run build -w create-apiagex
+cd newproject
+npx create-apiagex my-cms --yes
+```
+
+Scaffold ke baad:
+
+```bash
+cd my-cms
+npm install
+npm run dev
+```

package/dist/args.d.ts

@@ -0,0 +1,4 @@
+import type { CliOptions } from "./create-apiagex.type.js";
+export declare function parseArgs(args: string[]): CliOptions | string;
+export declare function validateProjectSlug(target: string): string | undefined;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +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"}

package/dist/args.js

@@ -0,0 +1,62 @@
+export function parseArgs(args) {
+    const options = { dryRun: false, help: false, version: false, yes: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index] ?? "";
+        if (arg === "--help" || arg === "-h")
+            options.help = true;
+        else if (arg === "--version" || arg === "-v")
+            options.version = true;
+        else if (arg === "--dry-run")
+            options.dryRun = true;
+        else if (arg === "--yes" || arg === "-y")
+            options.yes = true;
+        else if (arg === "--install")
+            options.installDependencies = true;
+        else if (arg === "--no-install")
+            options.installDependencies = false;
+        else if (arg === "--git")
+            options.initGit = true;
+        else if (arg === "--no-git")
+            options.initGit = false;
+        else if (arg === "--owner")
+            options.bootstrapOwner = true;
+        else if (arg === "--no-owner")
+            options.bootstrapOwner = false;
+        else if (arg === "--package-manager") {
+            const value = args[index + 1];
+            if (!isPackageManager(value))
+                return "Use --package-manager npm, pnpm, or yarn.";
+            options.packageManager = value;
+            index += 1;
+        }
+        else if (arg === "--setup") {
+            const value = args[index + 1];
+            if (!isSetupMode(value))
+                return "Use --setup quickstart or custom.";
+            options.setupMode = value;
+            index += 1;
+        }
+        else if (arg.startsWith("-"))
+            return `Unknown option: ${arg}`;
+        else if (options.target)
+            return "Only one target folder is supported.";
+        else
+            options.target = arg;
+    }
+    return options;
+}
+export function validateProjectSlug(target) {
+    if (!/^[a-z][a-z0-9-]*$/.test(target))
+        return "Target folder must be a safe slug like my-cms.";
+    if (target.includes("--"))
+        return "Target folder cannot contain repeated hyphens.";
+    if (target.endsWith("-"))
+        return "Target folder cannot end with a hyphen.";
+    return undefined;
+}
+function isPackageManager(value) {
+    return value === "npm" || value === "pnpm" || value === "yarn";
+}
+function isSetupMode(value) {
+    return value === "quickstart" || value === "custom";
+}

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

@@ -0,0 +1,44 @@
+import type { Readable, Writable } from "node:stream";
+export type PackageManager = "npm" | "pnpm" | "yarn";
+export type SetupMode = "custom" | "quickstart";
+export type CliOptions = {
+    bootstrapOwner?: boolean;
+    dryRun: boolean;
+    help: boolean;
+    initGit?: boolean;
+    installDependencies?: boolean;
+    packageManager?: PackageManager;
+    setupMode?: SetupMode;
+    target?: string;
+    version: boolean;
+    yes: boolean;
+};
+export type CliResult = {
+    code: number;
+    stderr: string;
+    stdout: string;
+};
+export type PromptQuestion = {
+    defaultValue: string;
+    message: string;
+};
+export type PromptFn = (question: PromptQuestion) => Promise<string>;
+export type RunCliOptions = {
+    interactive?: boolean;
+    prompt?: PromptFn;
+    stdin?: Readable;
+    stdout?: Writable;
+};
+export type ScaffoldAnswers = {
+    bootstrapOwner: boolean;
+    initGit: boolean;
+    installDependencies: boolean;
+    packageManager: PackageManager;
+    setupMode: SetupMode;
+    target: string;
+};
+export type ScaffoldFile = {
+    content: string;
+    path: string;
+};
+//# sourceMappingURL=create-apiagex.type.d.ts.map

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

@@ -0,0 +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"}

package/dist/create-apiagex.type.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import type { CliResult, RunCliOptions } from "./create-apiagex.type.js";
+export declare function runCli(args: string[], cwd?: string, io?: RunCliOptions): Promise<CliResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,EAAE,EAAE,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4B5G"}

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { realpathSync } from "node:fs";
+import { mkdir, readdir, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+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.1";
+export async function runCli(args, cwd = process.cwd(), io = {}) {
+    const parsed = parseArgs(args);
+    if (typeof parsed === "string")
+        return fail(parsed);
+    if (parsed.help)
+        return ok(renderHelp());
+    if (parsed.version)
+        return ok(`create-apiagex ${packageVersion}\n`);
+    const answers = await resolveAnswers(parsed, io);
+    if (typeof answers === "string")
+        return fail(answers);
+    const validationError = validateProjectSlug(answers.target);
+    if (validationError)
+        return fail(validationError);
+    const targetDir = resolve(cwd, answers.target);
+    const folderState = await inspectTargetFolder(targetDir);
+    if (folderState === "non-empty")
+        return fail(`Refusing to overwrite non-empty folder: ${targetDir}`);
+    const projectName = basename(targetDir);
+    const files = createScaffoldFiles({ ...answers, target: projectName });
+    const plan = renderPlan(projectName, targetDir, files, answers, parsed.dryRun);
+    if (parsed.dryRun)
+        return ok(plan);
+    await mkdir(targetDir, { recursive: true });
+    for (const file of files) {
+        const filePath = join(targetDir, file.path);
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, file.content, "utf8");
+    }
+    return ok(`${plan}\nCreated ${files.length} files.\n`);
+}
+async function inspectTargetFolder(targetDir) {
+    if (!existsSync(targetDir))
+        return "missing";
+    const entries = await readdir(targetDir);
+    return entries.length === 0 ? "empty" : "non-empty";
+}
+function renderHelp() {
+    return `create-apiagex ${packageVersion}
+
+Usage:
+  create-apiagex [target-folder] [options]
+
+Options:
+  --setup quickstart|custom      Choose starter setup mode.
+  --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.
+  --dry-run                      Print the scaffold plan without writing files.
+  -y, --yes                      Use defaults for missing options.
+  -h, --help                     Show help.
+  -v, --version                  Show version.
+
+Rules:
+  Target folder must be a safe slug like my-cms.
+  Existing non-empty folders are never overwritten.
+`;
+}
+function ok(stdout) {
+    return { code: 0, stdout, stderr: "" };
+}
+function fail(message) {
+    return { code: 1, stdout: "", stderr: `${message}\n` };
+}
+if (isDirectRun()) {
+    const result = await runCli(process.argv.slice(2), process.cwd(), { interactive: process.stdin.isTTY });
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    process.exitCode = result.code;
+}
+function isDirectRun() {
+    const entry = process.argv[1];
+    return Boolean(entry && realpathSync(entry) === fileURLToPath(import.meta.url));
+}

package/dist/prompts.d.ts

@@ -0,0 +1,3 @@
+import type { CliOptions, RunCliOptions, ScaffoldAnswers } from "./create-apiagex.type.js";
+export declare function resolveAnswers(options: CliOptions, io?: RunCliOptions): Promise<ScaffoldAnswers | string>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +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"}

package/dist/prompts.js

@@ -0,0 +1,47 @@
+import { createInterface } from "node:readline/promises";
+export async function resolveAnswers(options, io = {}) {
+    const prompt = io.prompt ?? nodePrompt(io);
+    const canAsk = Boolean((io.interactive || io.prompt) && !options.yes);
+    const target = options.target ?? (canAsk ? await ask(prompt, "Project name", "my-apiagex") : undefined);
+    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 packageManager = options.packageManager ?? await choiceAnswer(prompt, canAsk, "Package manager", "npm", ["npm", "pnpm", "yarn"]);
+    return {
+        bootstrapOwner: await boolAnswer(prompt, canAsk, "Bootstrap owner during scaffold?", options.bootstrapOwner, false),
+        initGit: await boolAnswer(prompt, canAsk, "Initialize git repository?", options.initGit, true),
+        installDependencies: await boolAnswer(prompt, canAsk, "Install dependencies after scaffold?", options.installDependencies, false),
+        packageManager,
+        setupMode,
+        target,
+    };
+}
+async function boolAnswer(prompt, canAsk, message, value, defaultValue) {
+    if (value !== undefined || !canAsk)
+        return value ?? defaultValue;
+    const answer = (await ask(prompt, message, defaultValue ? "yes" : "no")).toLowerCase();
+    return answer === "y" || answer === "yes" || answer === "true";
+}
+async function choiceAnswer(prompt, canAsk, message, defaultValue, allowed) {
+    if (!canAsk)
+        return defaultValue;
+    const answer = await ask(prompt, `${message} (${allowed.join("/")})`, defaultValue);
+    return allowed.includes(answer) ? answer : defaultValue;
+}
+async function ask(prompt, message, defaultValue) {
+    const answer = (await prompt({ defaultValue, message })).trim();
+    return answer || defaultValue;
+}
+function nodePrompt(io) {
+    return async ({ defaultValue, message }) => {
+        const input = io.stdin ?? process.stdin;
+        const output = io.stdout ?? process.stdout;
+        const rl = createInterface({ input, output });
+        try {
+            return await rl.question(`${message} (${defaultValue}): `);
+        }
+        finally {
+            rl.close();
+        }
+    };
+}

package/dist/scaffold.d.ts

@@ -0,0 +1,4 @@
+import type { ScaffoldAnswers, ScaffoldFile } from "./create-apiagex.type.js";
+export declare function createScaffoldFiles(answers: ScaffoldAnswers): ScaffoldFile[];
+export declare function renderPlan(projectName: string, targetDir: string, files: ScaffoldFile[], answers: ScaffoldAnswers, dryRun: boolean): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +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"}

package/dist/scaffold.js

@@ -0,0 +1,175 @@
+export function createScaffoldFiles(answers) {
+    return [
+        {
+            path: "package.json",
+            content: `${JSON.stringify({
+                name: answers.target,
+                version: "0.1.0",
+                private: true,
+                type: "module",
+                scripts: {
+                    dev: "apiagex dev",
+                    start: "apiagex start",
+                    build: "apiagex build",
+                    smoke: "apiagex smoke",
+                },
+                dependencies: {
+                    "apiagex-server": "^0.6.1",
+                },
+            }, null, 2)}\n`,
+        },
+        {
+            path: "README.md",
+            content: starterReadme(answers),
+        },
+        {
+            path: ".gitignore",
+            content: "node_modules\n.env\ndist\n.apiagex\n",
+        },
+        {
+            path: ".env.example",
+            content: "APIAGEX_DATABASE_PATH=.apiagex/apiagex.sqlite\nAPIAGEX_UPLOADS_PATH=.apiagex/uploads\nPORT=4000\nHOST=127.0.0.1\n",
+        },
+        {
+            path: "apiagex.config.json",
+            content: `${JSON.stringify({
+                database: { provider: "sqlite", url: "file:.apiagex/apiagex.sqlite" },
+                project: { packageManager: answers.packageManager, setupMode: answers.setupMode },
+            }, null, 2)}\n`,
+        },
+        {
+            path: "docs/README.md",
+            content: docsReadme(),
+        },
+    ];
+}
+export function renderPlan(projectName, targetDir, files, answers, dryRun) {
+    const mode = dryRun ? "Dry run only. No files were written." : "Scaffolding project files.";
+    const fileList = files.map((file) => `- ${file.path}`).join("\n");
+    return [
+        `create-apiagex will create ${projectName} at ${targetDir}.`,
+        mode,
+        "",
+        "Selected setup:",
+        `- Setup mode: ${answers.setupMode}`,
+        `- 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"}`,
+        "",
+        "Files:",
+        fileList,
+        "",
+        "Next commands:",
+        `cd ${projectName}`,
+        installCommand(answers.packageManager),
+        runCommand(answers.packageManager, "dev"),
+        "",
+    ].join("\n");
+}
+function starterReadme(answers) {
+    return `# ${answers.target}
+
+Generated Apiagex starter.
+
+## What this project gives you
+
+English: Apiagex runs one server with /api, /adminui, /doc, and /readme. Use the Admin UI to create schemas, entries, API roles, users, webhooks, and realtime settings.
+
+Hinglish: Apiagex ek server chalata hai jisme /api, /adminui, /doc, aur /readme hote hain. Schemas, entries, API roles, users, webhooks, aur realtime settings ke liye Admin UI use karo.
+
+## Next commands
+
+\`\`\`bash
+${installCommand(answers.packageManager)}
+${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.
+
+## Scripts
+
+- \`${runCommand(answers.packageManager, "dev")}\`: start the local Apiagex server.
+- \`${runCommand(answers.packageManager, "start")}\`: start the server for regular runtime use.
+- \`${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.
+
+- APIAGEX_DATABASE_PATH: SQLite database path. Default .apiagex/apiagex.sqlite.
+- APIAGEX_UPLOADS_PATH: upload folder. Default .apiagex/uploads.
+- PORT: server port. Default 4000.
+- HOST: server host. Default 127.0.0.1.
+
+## Practical flow
+
+English:
+
+1. Create the first owner 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.
+5. Use Webhooks for external server notifications and Realtime API for live browser screens.
+
+Hinglish:
+
+1. /adminui se first owner 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.
+5. External server notifications ke liye Webhooks aur live browser screens ke liye Realtime API use karo.
+
+## Common errors
+
+- OWNER_ALREADY_BOOTSTRAPPED: owner already exists; use the same form to login.
+- API_PERMISSION_DENIED: content API role is missing the required permission.
+- API_TOKEN_INVALID: token is wrong or revoked.
+- REALTIME_SESSION_INVALID: realtime session token was reused or expired.
+
+## Relation Modeling
+
+English: Create the target schema first, then add relation fields to the source schema in /adminui. Use one-to-one for Profile to User, many-to-one for Article to Category, one-to-many for Author to Articles, and many-to-many for Articles to Tags.
+
+Hinglish: Pehle target schema banao, phir /adminui me source schema par relation fields add karo. Profile to User ke liye one-to-one, Article to Category ke liye many-to-one, Author to Articles ke liye one-to-many, aur Articles to Tags ke liye many-to-many use karo.
+`;
+}
+function docsReadme() {
+    return `# Apiagex Project Docs
+
+Use /doc for generated API docs and /readme for the project summary.
+
+## Owner and Admin UI
+
+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.
+
+## Generated APIs
+
+English: Every schema creates /api/content/:schemaSlug. Send entry data as { "data": { ... } }.
+
+Hinglish: Har schema /api/content/:schemaSlug create karta hai. Entry data { "data": { ... } } shape me bhejo.
+
+## Access control
+
+English: Content API roles are separate from Admin UI roles. Give getAll, get, create, update, delete, or manage per schema.
+
+Hinglish: Content API roles Admin UI roles se alag hain. Har schema ke liye getAll, get, create, update, delete, ya manage do.
+
+## Webhooks and Realtime
+
+English: Webhooks call external URLs after content changes. Realtime API sends WebSocket events only for enabled collections.
+
+Hinglish: Webhooks content change ke baad external URLs call karte hain. Realtime API sirf enabled collections ke liye WebSocket events bhejta hai.
+
+Relation docs: /doc explains relation field types, entry payloads, populate query options, Admin UI entry pickers, and common errors.
+`;
+}
+function installCommand(packageManager) {
+    return packageManager === "yarn" ? "yarn install" : `${packageManager} install`;
+}
+function runCommand(packageManager, script) {
+    return packageManager === "npm" ? `npm run ${script}` : `${packageManager} ${script}`;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-apiagex",
+  "version": "0.6.1",
+  "description": "Installer CLI for creating Apiagex CMS projects.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bestmaa/apiagex.git",
+    "directory": "packages/create-apiagex"
+  },
+  "bugs": {
+    "url": "https://github.com/bestmaa/apiagex/issues"
+  },
+  "homepage": "https://github.com/bestmaa/apiagex#readme",
+  "keywords": [
+    "apiagex",
+    "create-apiagex",
+    "headless-cms",
+    "cms",
+    "scaffold"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "create-apiagex": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -b && node ../../scripts/set-bin-permissions.mjs dist/index.js",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  }
+}