@voltx/cli 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,65 @@
+<p align="center">
+  <strong>@voltx/cli</strong><br/>
+  <em>CLI tools for the VoltX framework</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@voltx/cli"><img src="https://img.shields.io/npm/v/@voltx/cli?color=blue" alt="npm" /></a>
+  <a href="https://www.npmjs.com/package/@voltx/cli"><img src="https://img.shields.io/npm/dm/@voltx/cli" alt="downloads" /></a>
+  <a href="https://github.com/codewithshail/voltx/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@voltx/cli" alt="license" /></a>
+</p>
+
+---
+
+Command-line tools for the [VoltX](https://github.com/codewithshail/voltx) framework. Scaffold new projects, run the dev server, and build for production.
+
+## Installation
+
+```bash
+npm install -g @voltx/cli
+```
+
+Or use directly with npx:
+
+```bash
+npx @voltx/cli create my-app
+```
+
+## Commands
+
+### Create a New Project
+
+```bash
+voltx create my-app
+voltx create my-app --template chatbot
+voltx create my-app --template rag-app
+voltx create my-app --template agent-app
+```
+
+### Available Templates
+
+| Template | Description |
+|----------|-------------|
+| `blank` | Minimal server with file-based routing |
+| `chatbot` | Streaming chat with AI + conversation memory |
+| `rag-app` | Document Q&A with embeddings + vector search |
+| `agent-app` | Autonomous agent with tools + memory |
+
+## Programmatic Usage
+
+```ts
+import { createProject } from "@voltx/cli";
+
+await createProject({
+  name: "my-app",
+  template: "chatbot",
+});
+```
+
+## Part of VoltX
+
+This package is part of the [VoltX](https://github.com/codewithshail/voltx) framework. See the [monorepo](https://github.com/codewithshail/voltx) for full documentation.
+
+## License
+
+[MIT](https://github.com/codewithshail/voltx/blob/main/LICENSE) — Made by the [Promptly AI Team](https://buymeacoffee.com/promptlyai)

package/dist/build.d.mts

@@ -0,0 +1,19 @@
+interface BuildOptions {
+    /** Entry file (default: src/index.ts) */
+    entry?: string;
+    /** Output directory (default: dist) */
+    outDir?: string;
+    /** Minify output (default: true) */
+    minify?: boolean;
+    /** Generate sourcemaps (default: false) */
+    sourcemap?: boolean;
+}
+/**
+ * Build the VoltX app for production.
+ *
+ * Uses tsup to bundle the server-side TypeScript into a single optimized JS file.
+ * If a frontend directory exists (src/frontend), also builds it with Vite.
+ */
+declare function runBuild(options?: BuildOptions): Promise<void>;
+
+export { type BuildOptions, runBuild };

package/dist/build.d.ts

@@ -0,0 +1,19 @@
+interface BuildOptions {
+    /** Entry file (default: src/index.ts) */
+    entry?: string;
+    /** Output directory (default: dist) */
+    outDir?: string;
+    /** Minify output (default: true) */
+    minify?: boolean;
+    /** Generate sourcemaps (default: false) */
+    sourcemap?: boolean;
+}
+/**
+ * Build the VoltX app for production.
+ *
+ * Uses tsup to bundle the server-side TypeScript into a single optimized JS file.
+ * If a frontend directory exists (src/frontend), also builds it with Vite.
+ */
+declare function runBuild(options?: BuildOptions): Promise<void>;
+
+export { type BuildOptions, runBuild };

package/dist/build.js

@@ -0,0 +1,145 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/build.ts
+var build_exports = {};
+__export(build_exports, {
+  runBuild: () => runBuild
+});
+module.exports = __toCommonJS(build_exports);
+var import_node_child_process = require("child_process");
+var import_node_path = require("path");
+var import_node_fs = require("fs");
+async function runBuild(options = {}) {
+  const cwd = process.cwd();
+  const {
+    entry = findEntryPoint(cwd),
+    outDir = "dist",
+    minify = true,
+    sourcemap = false
+  } = options;
+  if (!entry) {
+    console.error("[voltx] Could not find entry point. Expected src/index.ts");
+    process.exit(1);
+  }
+  const entryPath = (0, import_node_path.resolve)(cwd, entry);
+  if (!(0, import_node_fs.existsSync)(entryPath)) {
+    console.error(`[voltx] Entry file not found: ${entry}`);
+    process.exit(1);
+  }
+  console.log("");
+  console.log("  \u26A1 VoltX Build");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(`  Entry:   ${entry}`);
+  console.log(`  Output:  ${outDir}/`);
+  console.log(`  Minify:  ${minify}`);
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log("");
+  (0, import_node_fs.mkdirSync)((0, import_node_path.resolve)(cwd, outDir), { recursive: true });
+  console.log("  [1/2] Building server...");
+  const tsupArgs = [
+    entry,
+    "--format",
+    "esm",
+    "--out-dir",
+    outDir,
+    "--clean",
+    "--target",
+    "node20"
+  ];
+  if (minify) tsupArgs.push("--minify");
+  if (sourcemap) tsupArgs.push("--sourcemap");
+  tsupArgs.push("--no-splitting");
+  const tsupBin = findBin(cwd, "tsup");
+  await runCommand(
+    tsupBin ?? "npx",
+    tsupBin ? tsupArgs : ["tsup", ...tsupArgs],
+    cwd
+  );
+  console.log("  \u2713 Server built successfully");
+  const frontendDir = (0, import_node_path.resolve)(cwd, "src", "frontend");
+  const viteConfig = (0, import_node_path.resolve)(cwd, "vite.config.ts");
+  const hasFrontend = (0, import_node_fs.existsSync)(frontendDir) || (0, import_node_fs.existsSync)(viteConfig);
+  if (hasFrontend) {
+    console.log("  [2/2] Building frontend...");
+    const viteBin = findBin(cwd, "vite");
+    const viteArgs = ["build", "--outDir", (0, import_node_path.join)(outDir, "public")];
+    await runCommand(
+      viteBin ?? "npx",
+      viteBin ? viteArgs : ["vite", ...viteArgs],
+      cwd
+    );
+    console.log("  \u2713 Frontend built successfully");
+  } else {
+    console.log("  [2/2] No frontend found, skipping...");
+  }
+  console.log("");
+  console.log("  \u26A1 Build complete!");
+  console.log(`  Run \`voltx start\` to start the production server.`);
+  console.log("");
+}
+function findEntryPoint(cwd) {
+  const candidates = [
+    "src/index.ts",
+    "src/index.js",
+    "src/index.mts",
+    "src/main.ts",
+    "src/main.js"
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, candidate))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function findBin(cwd, name) {
+  const paths = [
+    (0, import_node_path.join)(cwd, "node_modules", ".bin", name),
+    (0, import_node_path.join)(cwd, "..", "node_modules", ".bin", name),
+    (0, import_node_path.join)(cwd, "..", "..", "node_modules", ".bin", name)
+  ];
+  for (const p of paths) {
+    if ((0, import_node_fs.existsSync)(p)) return p;
+  }
+  return null;
+}
+function runCommand(cmd, args, cwd) {
+  return new Promise((resolve2, reject) => {
+    const child = (0, import_node_child_process.spawn)(cmd, args, {
+      cwd,
+      stdio: "inherit",
+      env: { ...process.env, NODE_ENV: "production" }
+    });
+    child.on("error", (err) => {
+      if (err.code === "ENOENT") {
+        console.error(`[voltx] ${cmd} not found. Install it with: npm install -D ${cmd}`);
+      }
+      reject(err);
+    });
+    child.on("exit", (code) => {
+      if (code === 0) resolve2();
+      else reject(new Error(`${cmd} exited with code ${code}`));
+    });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runBuild
+});

package/dist/build.mjs

@@ -0,0 +1,7 @@
+import {
+  runBuild
+} from "./chunk-ZB2F3WTS.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  runBuild
+};

package/dist/chunk-AONHLE42.mjs

@@ -0,0 +1,141 @@
+// src/generate.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+async function runGenerate(options) {
+  const cwd = process.cwd();
+  const { type, name } = options;
+  switch (type) {
+    case "route":
+      generateRoute(cwd, name, options.method);
+      break;
+    case "agent":
+      generateAgent(cwd, name);
+      break;
+    case "tool":
+      generateTool(cwd, name);
+      break;
+    case "job":
+      generateJob(cwd, name);
+      break;
+    default:
+      console.error(`[voltx] Unknown generator type: ${type}`);
+      console.error("[voltx] Available: route, agent, tool, job");
+      process.exit(1);
+  }
+}
+function generateRoute(cwd, name, method = "POST") {
+  const routePath = name.startsWith("/") ? name.slice(1) : name;
+  const filePath = join(cwd, "src", "routes", `${routePath}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Route already exists: src/routes/${routePath}.ts`);
+    process.exit(1);
+  }
+  const upperMethod = method.toUpperCase();
+  const urlPath = "/" + routePath;
+  const content = `// ${upperMethod} ${urlPath}
+import type { Context } from "@voltx/server";
+
+export async function ${upperMethod}(c: Context) {
+  return c.json({ message: "Hello from ${urlPath}" });
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created route: src/routes/${routePath}.ts`);
+  console.log(`    ${upperMethod} ${urlPath}`);
+}
+function generateAgent(cwd, name) {
+  const filePath = join(cwd, "src", "agents", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Agent already exists: src/agents/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Agent: ${name}
+import { createAgent } from "@voltx/agents";
+
+export const ${toCamelCase(name)} = createAgent({
+  name: "${name}",
+  model: "cerebras:llama-4-scout-17b-16e",
+  instructions: "You are a helpful AI assistant named ${name}.",
+  tools: [
+    // Add tools here:
+    // {
+    //   name: "example",
+    //   description: "An example tool",
+    //   parameters: { type: "object", properties: { input: { type: "string" } }, required: ["input"] },
+    //   execute: async (params) => \`Processed: \${params.input}\`,
+    // },
+  ],
+});
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created agent: src/agents/${name}.ts`);
+}
+function generateTool(cwd, name) {
+  const filePath = join(cwd, "src", "tools", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Tool already exists: src/tools/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Tool: ${name}
+
+export const ${toCamelCase(name)}Tool = {
+  name: "${name}",
+  description: "TODO: Describe what this tool does",
+  parameters: {
+    type: "object" as const,
+    properties: {
+      input: { type: "string", description: "The input to process" },
+    },
+    required: ["input"],
+  },
+  execute: async (params: { input: string }): Promise<string> => {
+    // TODO: Implement tool logic
+    return \`${name} result for: \${params.input}\`;
+  },
+};
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created tool: src/tools/${name}.ts`);
+}
+function generateJob(cwd, name) {
+  const filePath = join(cwd, "src", "jobs", `${name}.ts`);
+  if (existsSync(filePath)) {
+    console.error(`[voltx] Job already exists: src/jobs/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Job: ${name}
+// Runs on a schedule or triggered via ctx.jobs.enqueue("${name}", data)
+
+export const config = {
+  // Cron schedule (uncomment to enable):
+  // schedule: "0 */6 * * *",  // every 6 hours
+  //
+  // Or make it a queue job (triggered on-demand):
+  queue: true,
+  retries: 3,
+  timeout: "5m",
+};
+
+export async function run(ctx: any, data?: Record<string, unknown>) {
+  console.log("[job:${name}] Running...", data);
+
+  // TODO: Implement job logic
+
+  console.log("[job:${name}] Done.");
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created job: src/jobs/${name}.ts`);
+}
+function writeFileSafe(filePath, content) {
+  const dir = dirname(filePath);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(filePath, content, "utf-8");
+}
+function toCamelCase(str) {
+  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase()).replace(/^(.)/, (_, c) => c.toLowerCase());
+}
+
+export {
+  runGenerate
+};

package/dist/chunk-BIE3F5AW.mjs

@@ -0,0 +1,261 @@
+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.2.0",
+      "@voltx/server": "^0.2.0"
+    },
+    chatbot: {
+      "@voltx/core": "^0.2.0",
+      "@voltx/ai": "^0.2.0",
+      "@voltx/server": "^0.2.0",
+      "@voltx/memory": "^0.2.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.2.0",
+      "@voltx/ai": "^0.2.0",
+      "@voltx/server": "^0.2.0",
+      "@voltx/rag": "^0.2.0",
+      "@voltx/db": "^0.2.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.2.0",
+      "@voltx/ai": "^0.2.0",
+      "@voltx/server": "^0.2.0",
+      "@voltx/agents": "^0.2.0",
+      "@voltx/memory": "^0.2.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 hasDb = template === "rag-app" || template === "agent-app";
+  const provider = template === "rag-app" ? "openai" : "cerebras";
+  const model = template === "rag-app" ? "gpt-4o" : "llama-4-scout-17b-16e";
+  let configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "${provider}",
+    model: "${model}",
+  },`;
+  if (hasDb) {
+    configContent += `
+  db: {
+    url: process.env.DATABASE_URL,
+  },`;
+  }
+  configContent += `
+  server: {
+    routesDir: "src/routes",
+    staticDir: "public",
+    cors: true,
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes", "api"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
+  fs.writeFileSync(
+    path.join(targetDir, "src", "index.ts"),
+    `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "src", "routes", "index.ts"),
+    `// GET / \u2014 Health check
+import type { Context } from "@voltx/server";
+
+export function GET(c: Context) {
+  return c.json({ name: "${name}", status: "ok" });
+}
+`
+  );
+  if (template === "chatbot" || template === "agent-app") {
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "chat.ts"),
+      `// POST /api/chat \u2014 Streaming chat with conversation memory
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createMemory } from "@voltx/memory";
+
+// In-memory for dev; swap to createMemory("postgres", { url }) for production
+const memory = createMemory({ maxMessages: 50 });
+
+export async function POST(c: Context) {
+  const { messages, conversationId = "default" } = await c.req.json();
+
+  // Store the latest user message
+  const lastMessage = messages[messages.length - 1];
+  if (lastMessage?.role === "user") {
+    await memory.add(conversationId, { role: "user", content: lastMessage.content });
+  }
+
+  // Get conversation history from memory
+  const history = await memory.get(conversationId);
+
+  const result = await streamText({
+    model: "cerebras:llama-4-scout-17b-16e",
+    system: "You are a helpful AI assistant.",
+    messages: history.map((m) => ({ role: m.role, content: m.content })),
+  });
+
+  // Store assistant response after stream completes
+  result.text.then(async (text) => {
+    await memory.add(conversationId, { role: "assistant", content: text });
+  });
+
+  return result.toSSEResponse();
+}
+`
+    );
+  }
+  if (template === "rag-app") {
+    fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "rag"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "rag", "query.ts"),
+      `// POST /api/rag/query \u2014 Query documents with RAG
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+const vectorStore = createVectorStore(); // swap to "pinecone" or "pgvector" for production
+const embedder = createEmbedder({ model: "openai:text-embedding-3-small" });
+const rag = createRAGPipeline({ embedder, vectorStore });
+
+export async function POST(c: Context) {
+  const { question } = await c.req.json();
+
+  const context = await rag.getContext(question, { topK: 5 });
+
+  const result = await streamText({
+    model: "openai:gpt-4o",
+    system: \`Answer the user's question based on the following context. If the context doesn't contain relevant information, say so.\\n\\nContext:\\n\${context}\`,
+    messages: [{ role: "user", content: question }],
+  });
+
+  return result.toSSEResponse();
+}
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "rag", "ingest.ts"),
+      `// POST /api/rag/ingest \u2014 Ingest documents into the vector store
+import type { Context } from "@voltx/server";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+const vectorStore = createVectorStore();
+const embedder = createEmbedder({ model: "openai:text-embedding-3-small" });
+const rag = createRAGPipeline({ embedder, vectorStore });
+
+export async function POST(c: Context) {
+  const { text, idPrefix } = await c.req.json();
+
+  if (!text || typeof text !== "string") {
+    return c.json({ error: "Missing 'text' field" }, 400);
+  }
+
+  const result = await rag.ingest(text, idPrefix ?? "doc");
+  return c.json({ status: "ok", chunks: result.chunks, ids: result.ids });
+}
+`
+    );
+  }
+  let envContent = "";
+  if (template === "rag-app") {
+    envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nOPENAI_API_KEY=sk-...\n\n";
+    envContent += "# \u2500\u2500\u2500 Database (Neon Postgres) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n\n";
+    envContent += "# \u2500\u2500\u2500 Vector Database (Pinecone) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPINECONE_API_KEY=pc-...\nPINECONE_INDEX=voltx-embeddings\n\n";
+  } else if (template === "chatbot" || template === "agent-app") {
+    envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nCEREBRAS_API_KEY=csk-...\n\n";
+    if (template === "agent-app") {
+      envContent += "# \u2500\u2500\u2500 Database (Neon Postgres \u2014 optional) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
+    }
+  } else {
+    envContent += "# \u2500\u2500\u2500 LLM Provider (add your key) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
+  }
+  envContent += "# \u2500\u2500\u2500 App \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPORT=3000\nNODE_ENV=development\n";
+  fs.writeFileSync(path.join(targetDir, ".env.example"), envContent);
+  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
+};