@voltx/cli 0.1.0 → 0.2.0

package/dist/chunk-H2SJO7GX.mjs

@@ -0,0 +1,102 @@
+import {
+  __require,
+  printWelcomeBanner
+} from "./chunk-RH5Q7I3S.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+async function createProject(options) {
+  const { name, template = "blank" } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  const templateDeps = {
+    blank: { "@voltx/core": "^0.1.0" },
+    chatbot: {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    }
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    scripts: {
+      dev: "voltx dev",
+      build: "voltx build",
+      start: "voltx start"
+    },
+    dependencies: templateDeps[template] ?? templateDeps["blank"]
+  };
+  fs.writeFileSync(
+    path.join(targetDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "openai",
+    model: "gpt-4o",
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
+  const indexContent = `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`;
+  fs.writeFileSync(path.join(targetDir, "src", "index.ts"), indexContent);
+  fs.writeFileSync(
+    path.join(targetDir, ".env.example"),
+    "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
+  );
+  printWelcomeBanner(name);
+}
+var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
+  const projectName = process.argv[2];
+  if (!projectName) {
+    console.log("Usage: create-voltx-app <project-name> [--template chatbot]");
+    process.exit(1);
+  }
+  const templateFlag = process.argv.indexOf("--template");
+  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+  createProject({ name: projectName, template }).catch((err) => {
+    console.error("[voltx] Error:", err);
+    process.exit(1);
+  });
+}
+
+export {
+  createProject
+};

package/dist/chunk-H4YMCUJC.mjs

@@ -0,0 +1,99 @@
+import {
+  __require,
+  printWelcomeBanner
+} from "./chunk-RH5Q7I3S.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+async function createProject(options) {
+  const { name, template = "blank" } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  const templateDeps = {
+    blank: { "@voltx/core": "^0.1.0" },
+    chatbot: {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    }
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    scripts: {
+      dev: "voltx dev",
+      build: "voltx build",
+      start: "voltx start"
+    },
+    dependencies: templateDeps[template] ?? templateDeps["blank"]
+  };
+  fs.writeFileSync(
+    path.join(targetDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "openai",
+    model: "gpt-4o",
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
+  const indexContent = `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`;
+  fs.writeFileSync(path.join(targetDir, "src", "index.ts"), indexContent);
+  fs.writeFileSync(
+    path.join(targetDir, ".env.example"),
+    "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
+  );
+  printWelcomeBanner(name);
+}
+var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
+  const projectName = process.argv[2];
+  if (!projectName) {
+    console.log("Usage: create-voltx-app <project-name> [--template chatbot]");
+    process.exit(1);
+  }
+  const templateFlag = process.argv.indexOf("--template");
+  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+  createProject({ name: projectName, template }).catch((err) => {
+    console.error("[voltx] Error:", err);
+    process.exit(1);
+  });
+}
+
+export {
+  createProject
+};

package/dist/chunk-YID3JCVU.mjs

@@ -0,0 +1,131 @@
+import {
+  __require,
+  printWelcomeBanner
+} from "./chunk-RH5Q7I3S.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+async function createProject(options) {
+  const { name, template = "blank" } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  const templateDeps = {
+    blank: { "@voltx/core": "^0.1.0" },
+    chatbot: {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    }
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    scripts: {
+      dev: "tsx src/index.ts",
+      build: "tsc",
+      start: "node dist/index.js"
+    },
+    dependencies: templateDeps[template] ?? templateDeps["blank"],
+    devDependencies: {
+      typescript: "^5.7.0",
+      tsx: "^4.21.0",
+      "@types/node": "^22.0.0"
+    }
+  };
+  fs.writeFileSync(
+    path.join(targetDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "openai",
+    model: "gpt-4o",
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
+  const indexContent = `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`;
+  fs.writeFileSync(path.join(targetDir, "src", "index.ts"), indexContent);
+  fs.writeFileSync(
+    path.join(targetDir, ".env.example"),
+    "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, ".gitignore"),
+    "node_modules\ndist\n.env\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )
+  );
+  printWelcomeBanner(name);
+}
+var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
+  const projectName = process.argv[2];
+  if (!projectName) {
+    console.log("Usage: create-voltx-app <project-name> [--template chatbot]");
+    process.exit(1);
+  }
+  const templateFlag = process.argv.indexOf("--template");
+  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+  createProject({ name: projectName, template }).catch((err) => {
+    console.error("[voltx] Error:", err);
+    process.exit(1);
+  });
+}
+
+export {
+  createProject
+};

package/dist/cli.js

@@ -1,11 +1,296 @@
 #!/usr/bin/env node
 "use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/welcome.ts
+function rgb(r, g, b, text) {
+  return `${ESC}38;2;${r};${g};${b}m${text}${RESET}`;
+}
+function lerp(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+function gradientLine(text, from, to) {
+  const len = text.length;
+  if (len === 0) return "";
+  return text.split("").map((char, i) => {
+    const t = len === 1 ? 0 : i / (len - 1);
+    const r = lerp(from.r, to.r, t);
+    const g = lerp(from.g, to.g, t);
+    const b = lerp(from.b, to.b, t);
+    return rgb(r, g, b, char);
+  }).join("");
+}
+function gradientBlock(lines, colors) {
+  return lines.map((line, i) => {
+    const t = lines.length === 1 ? 0 : i / (lines.length - 1);
+    const segIndex = t * (colors.length - 1);
+    const fromIdx = Math.floor(segIndex);
+    const toIdx = Math.min(fromIdx + 1, colors.length - 1);
+    const localT = segIndex - fromIdx;
+    const from = {
+      r: lerp(colors[fromIdx].r, colors[toIdx].r, localT),
+      g: lerp(colors[fromIdx].g, colors[toIdx].g, localT),
+      b: lerp(colors[fromIdx].b, colors[toIdx].b, localT)
+    };
+    const to = {
+      r: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].r, colors[Math.min(toIdx + 1, colors.length - 1)].r, localT),
+      g: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].g, colors[Math.min(toIdx + 1, colors.length - 1)].g, localT),
+      b: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].b, colors[Math.min(toIdx + 1, colors.length - 1)].b, localT)
+    };
+    return gradientLine(line, from, to);
+  }).join("\n");
+}
+function dimRule(width = 48) {
+  return `  ${rgb(60, 60, 80, "\u2500".repeat(width))}`;
+}
+function printWelcomeBanner(projectName) {
+  console.log("");
+  console.log(gradientBlock(VOLTX_BANNER, VOLTX_COLORS));
+  console.log("");
+  console.log(
+    `  ${ITALIC}${rgb(180, 180, 220, "The AI-first full-stack framework")}${RESET}`
+  );
+  console.log("");
+  if (projectName) {
+    console.log(
+      `  ${ITALIC}${rgb(120, 220, 180, `Thank you for choosing VoltX! \u26A1`)}${RESET}`
+    );
+    console.log(
+      `  ${ITALIC}${rgb(160, 160, 200, `Your project "${projectName}" is ready to go.`)}${RESET}`
+    );
+    console.log("");
+    console.log(`  ${rgb(100, 180, 255, "Next steps:")}`);
+    console.log(`  ${rgb(200, 200, 220, `  cd ${projectName}`)}`);
+    console.log(`  ${rgb(200, 200, 220, "  pnpm install")}`);
+    console.log(`  ${rgb(200, 200, 220, "  pnpm dev")}`);
+    console.log("");
+    console.log(dimRule());
+    console.log("");
+    console.log(
+      `  ${rgb(255, 200, 80, "\u2615")} ${ITALIC}${rgb(200, 180, 140, "Love VoltX? Support us and fuel the next update:")}${RESET}`
+    );
+    console.log(
+      `     ${rgb(255, 180, 100, "https://buymeacoffee.com/promptlyai")}`
+    );
+    console.log("");
+    console.log(dimRule());
+    console.log("");
+    console.log(
+      `  ${ITALIC}${rgb(140, 140, 170, "Docs: https://voltx.co.in  \u2022  GitHub: github.com/codewithshail/voltx")}${RESET}`
+    );
+    console.log(
+      `  ${ITALIC}${rgb(100, 100, 130, "Made with \u2665 by the Promptly AI Team")}${RESET}`
+    );
+    console.log("");
+  }
+}
+var ESC, RESET, ITALIC, VOLTX_BANNER, VOLTX_COLORS;
+var init_welcome = __esm({
+  "src/welcome.ts"() {
+    "use strict";
+    ESC = "\x1B[";
+    RESET = `${ESC}0m`;
+    ITALIC = `${ESC}3m`;
+    VOLTX_BANNER = [
+      "  \u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557",
+      "  \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D",
+      "  \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551    \u255A\u2588\u2588\u2588\u2554\u255D ",
+      "  \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551    \u2588\u2588\u2554\u2588\u2588\u2557 ",
+      "   \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2554\u255D \u2588\u2588\u2557",
+      "    \u255A\u2550\u2550\u2550\u255D   \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D"
+    ];
+    VOLTX_COLORS = [
+      { r: 0, g: 180, b: 255 },
+      // electric blue
+      { r: 120, g: 80, b: 255 },
+      // purple
+      { r: 255, g: 50, b: 180 },
+      // hot pink
+      { r: 255, g: 120, b: 50 }
+      // orange
+    ];
+  }
+});
+
+// src/create.ts
+var create_exports = {};
+__export(create_exports, {
+  createProject: () => createProject
+});
+async function createProject(options) {
+  const { name, template = "blank" } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  const templateDeps = {
+    blank: { "@voltx/core": "^0.1.0" },
+    chatbot: {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.1.0",
+      "@voltx/agents": "^0.1.0",
+      "@voltx/memory": "^0.1.0",
+      "@voltx/rag": "^0.1.0",
+      "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
+      "@voltx/ui": "^0.1.0"
+    }
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    scripts: {
+      dev: "tsx src/index.ts",
+      build: "tsc",
+      start: "node dist/index.js"
+    },
+    dependencies: templateDeps[template] ?? templateDeps["blank"],
+    devDependencies: {
+      typescript: "^5.7.0",
+      tsx: "^4.21.0",
+      "@types/node": "^22.0.0"
+    }
+  };
+  fs.writeFileSync(
+    path.join(targetDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "openai",
+    model: "gpt-4o",
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
+  const indexContent = `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`;
+  fs.writeFileSync(path.join(targetDir, "src", "index.ts"), indexContent);
+  fs.writeFileSync(
+    path.join(targetDir, ".env.example"),
+    "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, ".gitignore"),
+    "node_modules\ndist\n.env\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )
+  );
+  printWelcomeBanner(name);
+}
+var fs, path, isDirectRun;
+var init_create = __esm({
+  "src/create.ts"() {
+    "use strict";
+    fs = __toESM(require("fs"));
+    path = __toESM(require("path"));
+    init_welcome();
+    isDirectRun = typeof require !== "undefined" && require.main === module && process.argv[1]?.includes("create");
+    if (isDirectRun) {
+      const projectName = process.argv[2];
+      if (!projectName) {
+        console.log("Usage: create-voltx-app <project-name> [--template chatbot]");
+        process.exit(1);
+      }
+      const templateFlag = process.argv.indexOf("--template");
+      const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+      createProject({ name: projectName, template }).catch((err) => {
+        console.error("[voltx] Error:", err);
+        process.exit(1);
+      });
+    }
+  }
+});
 
 // src/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
 async function main() {
   switch (command) {
+    case "create": {
+      const projectName = args[1];
+      if (!projectName) {
+        console.error("[voltx] Usage: voltx create <project-name> [--template chatbot|rag-app|agent-app]");
+        process.exit(1);
+      }
+      const templateFlag = args.indexOf("--template");
+      const template = templateFlag !== -1 ? args[templateFlag + 1] : "blank";
+      const { createProject: createProject2 } = await Promise.resolve().then(() => (init_create(), create_exports));
+      await createProject2({ name: projectName, template });
+      break;
+    }
     case "dev": {
       console.log("[voltx] Starting dev server...");
       console.log("[voltx] Dev server not yet implemented \u2014 coming in Phase 2");
@@ -23,15 +308,19 @@ async function main() {
     }
     default: {
       console.log(`
-  voltx \u2014 The AI-first full-stack framework
+  \u26A1 voltx \u2014 The AI-first full-stack framework
 
   Usage:
-    voltx dev          Start the development server
-    voltx build        Build for production
-    voltx start        Start the production server
+    voltx create <name>  Create a new VoltX project
+    voltx dev            Start the development server
+    voltx build          Build for production
+    voltx start          Start the production server
+
+  Options:
+    --template <type>    Template: chatbot, rag-app, agent-app, blank (default)
 
-  To create a new project:
-    create-voltx-app <project-name>
+  Example:
+    voltx create my-app --template chatbot
       `);
     }
   }

package/dist/cli.mjs

@@ -5,6 +5,18 @@ var args = process.argv.slice(2);
 var command = args[0];
 async function main() {
   switch (command) {
+    case "create": {
+      const projectName = args[1];
+      if (!projectName) {
+        console.error("[voltx] Usage: voltx create <project-name> [--template chatbot|rag-app|agent-app]");
+        process.exit(1);
+      }
+      const templateFlag = args.indexOf("--template");
+      const template = templateFlag !== -1 ? args[templateFlag + 1] : "blank";
+      const { createProject } = await import("./create.mjs");
+      await createProject({ name: projectName, template });
+      break;
+    }
     case "dev": {
       console.log("[voltx] Starting dev server...");
       console.log("[voltx] Dev server not yet implemented \u2014 coming in Phase 2");
@@ -22,15 +34,19 @@ async function main() {
     }
     default: {
       console.log(`
-  voltx \u2014 The AI-first full-stack framework
+  \u26A1 voltx \u2014 The AI-first full-stack framework
 
   Usage:
-    voltx dev          Start the development server
-    voltx build        Build for production
-    voltx start        Start the production server
+    voltx create <name>  Create a new VoltX project
+    voltx dev            Start the development server
+    voltx build          Build for production
+    voltx start          Start the production server
+
+  Options:
+    --template <type>    Template: chatbot, rag-app, agent-app, blank (default)
 
-  To create a new project:
-    create-voltx-app <project-name>
+  Example:
+    voltx create my-app --template chatbot
       `);
     }
   }

package/dist/create.js

@@ -156,12 +156,14 @@ async function createProject(options) {
       "@voltx/core": "^0.1.0",
       "@voltx/agents": "^0.1.0",
       "@voltx/memory": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     },
     "rag-app": {
       "@voltx/core": "^0.1.0",
       "@voltx/rag": "^0.1.0",
       "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     },
     "agent-app": {
@@ -170,6 +172,7 @@ async function createProject(options) {
       "@voltx/memory": "^0.1.0",
       "@voltx/rag": "^0.1.0",
       "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     }
   };
@@ -178,11 +181,16 @@ async function createProject(options) {
     version: "0.1.0",
     private: true,
     scripts: {
-      dev: "voltx dev",
-      build: "voltx build",
-      start: "voltx start"
+      dev: "tsx src/index.ts",
+      build: "tsc",
+      start: "node dist/index.js"
     },
-    dependencies: templateDeps[template] ?? templateDeps["blank"]
+    dependencies: templateDeps[template] ?? templateDeps["blank"],
+    devDependencies: {
+      typescript: "^5.7.0",
+      tsx: "^4.21.0",
+      "@types/node": "^22.0.0"
+    }
   };
   fs.writeFileSync(
     path.join(targetDir, "package.json"),
@@ -213,9 +221,34 @@ app.start();
     path.join(targetDir, ".env.example"),
     "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
   );
+  fs.writeFileSync(
+    path.join(targetDir, ".gitignore"),
+    "node_modules\ndist\n.env\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )
+  );
   printWelcomeBanner(name);
 }
-if (require.main === module) {
+var isDirectRun = typeof require !== "undefined" && require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
   const projectName = process.argv[2];
   if (!projectName) {
     console.log("Usage: create-voltx-app <project-name> [--template chatbot]");

package/dist/create.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createProject
-} from "./chunk-77A5TSPB.mjs";
+} from "./chunk-YID3JCVU.mjs";
 import "./chunk-RH5Q7I3S.mjs";
 export {
   createProject

package/dist/index.js

@@ -158,12 +158,14 @@ async function createProject(options) {
       "@voltx/core": "^0.1.0",
       "@voltx/agents": "^0.1.0",
       "@voltx/memory": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     },
     "rag-app": {
       "@voltx/core": "^0.1.0",
       "@voltx/rag": "^0.1.0",
       "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     },
     "agent-app": {
@@ -172,6 +174,7 @@ async function createProject(options) {
       "@voltx/memory": "^0.1.0",
       "@voltx/rag": "^0.1.0",
       "@voltx/db": "^0.1.0",
+      "@voltx/auth": "^0.1.0",
       "@voltx/ui": "^0.1.0"
     }
   };
@@ -180,11 +183,16 @@ async function createProject(options) {
     version: "0.1.0",
     private: true,
     scripts: {
-      dev: "voltx dev",
-      build: "voltx build",
-      start: "voltx start"
+      dev: "tsx src/index.ts",
+      build: "tsc",
+      start: "node dist/index.js"
     },
-    dependencies: templateDeps[template] ?? templateDeps["blank"]
+    dependencies: templateDeps[template] ?? templateDeps["blank"],
+    devDependencies: {
+      typescript: "^5.7.0",
+      tsx: "^4.21.0",
+      "@types/node": "^22.0.0"
+    }
   };
   fs.writeFileSync(
     path.join(targetDir, "package.json"),
@@ -215,9 +223,34 @@ app.start();
     path.join(targetDir, ".env.example"),
     "OPENAI_API_KEY=your-key-here\nDATABASE_URL=\n"
   );
+  fs.writeFileSync(
+    path.join(targetDir, ".gitignore"),
+    "node_modules\ndist\n.env\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )
+  );
   printWelcomeBanner(name);
 }
-if (require.main === module) {
+var isDirectRun = typeof require !== "undefined" && require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
   const projectName = process.argv[2];
   if (!projectName) {
     console.log("Usage: create-voltx-app <project-name> [--template chatbot]");

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   createProject
-} from "./chunk-77A5TSPB.mjs";
+} from "./chunk-YID3JCVU.mjs";
 import "./chunk-RH5Q7I3S.mjs";
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltx/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "VoltX CLI — create-voltx-app scaffolding and dev server",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,7 +17,7 @@
     }
   },
   "dependencies": {
-    "@voltx/core": "0.1.0"
+    "@voltx/core": "0.2.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",