@voltx/cli 0.3.3 → 0.3.5

package/dist/index.js

@@ -148,70 +148,72 @@ function printWelcomeBanner(projectName) {
 }
 
 // src/create.ts
+var VV = {
+  "@voltx/core": "^0.3.1",
+  "@voltx/server": "^0.3.1",
+  "@voltx/cli": "^0.3.5",
+  "@voltx/ai": "^0.3.0",
+  "@voltx/agents": "^0.3.1",
+  "@voltx/memory": "^0.3.0",
+  "@voltx/db": "^0.3.0",
+  "@voltx/rag": "^0.3.1",
+  "@voltx/auth": "^0.3.0"
+};
+function v(pkg) {
+  return VV[pkg] ?? "^0.3.0";
+}
+var TEMPLATE_DEPS = {
+  blank: { "@voltx/core": v("@voltx/core"), "@voltx/server": v("@voltx/server") },
+  chatbot: { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/memory": v("@voltx/memory") },
+  "rag-app": { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/rag": v("@voltx/rag"), "@voltx/db": v("@voltx/db") },
+  "agent-app": { "@voltx/core": v("@voltx/core"), "@voltx/ai": v("@voltx/ai"), "@voltx/server": v("@voltx/server"), "@voltx/agents": v("@voltx/agents"), "@voltx/memory": v("@voltx/memory") }
+};
 async function createProject(options) {
-  const { name, template = "blank", auth = "none" } = options;
+  const { name, template = "blank", auth = "none", shadcn = false } = 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.3.0",
-      "@voltx/server": "^0.3.0"
-    },
-    chatbot: {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/memory": "^0.3.0"
-    },
-    "rag-app": {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/rag": "^0.3.0",
-      "@voltx/db": "^0.3.0"
-    },
-    "agent-app": {
-      "@voltx/core": "^0.3.0",
-      "@voltx/ai": "^0.3.0",
-      "@voltx/server": "^0.3.0",
-      "@voltx/agents": "^0.3.0",
-      "@voltx/memory": "^0.3.0"
-    }
-  };
-  const packageJson = {
+  const provider = template === "rag-app" ? "openai" : "cerebras";
+  const model = template === "rag-app" ? "gpt-4o" : "llama3.1-8b";
+  const hasDb = template === "rag-app" || template === "agent-app" || auth === "better-auth";
+  const deps = { ...TEMPLATE_DEPS[template] ?? TEMPLATE_DEPS["blank"], "@voltx/cli": v("@voltx/cli") };
+  if (auth === "better-auth") {
+    deps["@voltx/auth"] = v("@voltx/auth");
+    deps["better-auth"] = "^1.5.0";
+  } else if (auth === "jwt") {
+    deps["@voltx/auth"] = v("@voltx/auth");
+    deps["jose"] = "^6.0.0";
+  }
+  const devDeps = { typescript: "^5.7.0", tsx: "^4.21.0", tsup: "^8.0.0", "@types/node": "^22.0.0" };
+  deps["hono"] = "^4.7.0";
+  deps["@hono/node-server"] = "^1.14.0";
+  deps["react"] = "^19.0.0";
+  deps["react-dom"] = "^19.0.0";
+  deps["tailwindcss"] = "^4.0.0";
+  devDeps["vite"] = "^6.0.0";
+  devDeps["@hono/vite-dev-server"] = "^0.7.0";
+  devDeps["@vitejs/plugin-react"] = "^4.3.0";
+  devDeps["@tailwindcss/vite"] = "^4.0.0";
+  devDeps["@types/react"] = "^19.0.0";
+  devDeps["@types/react-dom"] = "^19.0.0";
+  if (shadcn) {
+    deps["class-variance-authority"] = "^0.7.0";
+    deps["clsx"] = "^2.1.0";
+    deps["tailwind-merge"] = "^3.0.0";
+    deps["lucide-react"] = "^0.468.0";
+  }
+  fs.writeFileSync(path.join(targetDir, "package.json"), JSON.stringify({
     name,
     version: "0.1.0",
     private: true,
-    scripts: {
-      dev: "voltx dev",
-      build: "voltx build",
-      start: "voltx start"
-    },
-    dependencies: {
-      ...templateDeps[template] ?? templateDeps["blank"],
-      "@voltx/cli": "^0.3.0",
-      ...auth === "better-auth" ? { "@voltx/auth": "^0.3.0", "better-auth": "^1.5.0" } : {},
-      ...auth === "jwt" ? { "@voltx/auth": "^0.3.0", "jose": "^6.0.0" } : {}
-    },
-    devDependencies: {
-      typescript: "^5.7.0",
-      tsx: "^4.21.0",
-      tsup: "^8.0.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" || auth === "better-auth";
-  const provider = template === "rag-app" ? "openai" : "cerebras";
-  const model = template === "rag-app" ? "gpt-4o" : "llama3.1-8b";
-  let configContent = `import { defineConfig } from "@voltx/core";
+    scripts: { dev: "voltx dev", build: "voltx build", start: "voltx start" },
+    dependencies: deps,
+    devDependencies: devDeps
+  }, null, 2));
+  let config = `import { defineConfig } from "@voltx/core";
 
 export default defineConfig({
   name: "${name}",
@@ -220,41 +222,63 @@ export default defineConfig({
     provider: "${provider}",
     model: "${model}",
   },`;
-  if (hasDb) {
-    configContent += `
+  if (hasDb) config += `
   db: {
     url: process.env.DATABASE_URL,
   },`;
-  }
-  if (auth !== "none") {
-    configContent += `
+  if (auth !== "none") config += `
   auth: {
     provider: "${auth}",
   },`;
-  }
-  configContent += `
+  config += `
   server: {
-    routesDir: "src/routes",
+    routesDir: "api",
     staticDir: "public",
     cors: true,
   },
 });
 `;
-  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
-  fs.mkdirSync(path.join(targetDir, "src", "routes", "api"), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), config);
+  fs.mkdirSync(path.join(targetDir, "api"), { recursive: true });
   fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "components"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "hooks"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, "public", "favicon.svg"), generateFaviconSVG());
+  fs.writeFileSync(path.join(targetDir, "public", "robots.txt"), generateRobotsTxt());
+  fs.writeFileSync(path.join(targetDir, "public", "site.webmanifest"), generateWebManifest(name));
+  const tsconfig = {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      outDir: "dist",
+      baseUrl: ".",
+      paths: { "@/*": ["./src/*"] },
+      jsx: "react-jsx"
+    },
+    include: ["src", "api", "server.ts", "voltx.config.ts"]
+  };
+  if (template === "agent-app") tsconfig.include.push("agents", "tools");
+  fs.writeFileSync(path.join(targetDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  fs.writeFileSync(path.join(targetDir, "server.ts"), generateServerEntry(name, template));
+  fs.writeFileSync(path.join(targetDir, "vite.config.ts"), generateViteConfigFile("server.ts"));
+  fs.writeFileSync(path.join(targetDir, "src", "entry-client.tsx"), generateEntryClient());
+  fs.writeFileSync(path.join(targetDir, "src", "entry-server.tsx"), generateEntryServer());
+  fs.writeFileSync(path.join(targetDir, "src", "layout.tsx"), generateLayoutComponent(name));
+  fs.writeFileSync(path.join(targetDir, "src", "globals.css"), generateGlobalCSS(shadcn));
+  if (shadcn) {
+    fs.writeFileSync(path.join(targetDir, "src", "lib", "utils.ts"), generateCnUtil());
+    fs.writeFileSync(path.join(targetDir, "components.json"), generateComponentsJson());
+  }
+  fs.writeFileSync(path.join(targetDir, "src", "app.tsx"), generateAppComponent(name, template));
   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
+    path.join(targetDir, "api", "index.ts"),
+    `// GET /api \u2014 Health check
 import type { Context } from "@voltx/server";
 
 export function GET(c: Context) {
@@ -264,25 +288,22 @@ export function GET(c: Context) {
   );
   if (template === "chatbot" || template === "agent-app") {
     fs.writeFileSync(
-      path.join(targetDir, "src", "routes", "api", "chat.ts"),
+      path.join(targetDir, "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({
@@ -291,7 +312,6 @@ export async function POST(c: Context) {
     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 });
   });
@@ -302,44 +322,72 @@ export async function POST(c: Context) {
     );
   }
   if (template === "agent-app") {
-    fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
-    fs.mkdirSync(path.join(targetDir, "src", "tools"), { recursive: true });
-    fs.writeFileSync(
-      path.join(targetDir, "src", "agents", "assistant.ts"),
-      `import { createAgent } from "@voltx/agents";
-import { searchTool } from "../tools/search";
+    fs.mkdirSync(path.join(targetDir, "agents"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "tools"), { recursive: true });
+    fs.writeFileSync(path.join(targetDir, "tools", "calculator.ts"), `// Calculator tool \u2014 evaluates math expressions (no API key needed)
+import type { Tool } from "@voltx/agents";
 
-export const assistant = createAgent({
-  name: "assistant",
-  model: "${provider}:${model}",
-  instructions: "You are a helpful AI assistant. Use your tools when needed.",
-  tools: [searchTool],
-  maxIterations: 5,
-});
-`
-    );
-    fs.writeFileSync(
-      path.join(targetDir, "src", "tools", "search.ts"),
-      `import type { Tool } from "@voltx/agents";
+export const calculatorTool: Tool = {
+  name: "calculator",
+  description: "Evaluate a math expression. Supports +, -, *, /, %, parentheses, and Math functions.",
+  parameters: {
+    type: "object",
+    properties: { expression: { type: "string", description: "The math expression to evaluate" } },
+    required: ["expression"],
+  },
+  async execute(args: { expression: string }) {
+    try {
+      const safe = args.expression.replace(/[^0-9+\\-*/.()%\\s,]|(?<!Math)\\.[a-z]/gi, (match) => {
+        if (args.expression.includes("Math.")) return match;
+        throw new Error("Invalid character: " + match);
+      });
+      const result = new Function("return " + safe)();
+      return \`\${args.expression} = \${result}\`;
+    } catch (err) {
+      return \`Error: \${err instanceof Error ? err.message : String(err)}\`;
+    }
+  },
+};
+`);
+    fs.writeFileSync(path.join(targetDir, "tools", "datetime.ts"), `// Date & time tool \u2014 returns current date, time, timezone (no API key needed)
+import type { Tool } from "@voltx/agents";
 
-export const searchTool: Tool = {
-  name: "search",
-  description: "Search for information on a topic.",
+export const datetimeTool: Tool = {
+  name: "datetime",
+  description: "Get the current date, time, day of week, and timezone.",
   parameters: {
     type: "object",
-    properties: { query: { type: "string", description: "The search query" } },
-    required: ["query"],
+    properties: { timezone: { type: "string", description: "Optional IANA timezone. Defaults to server timezone." } },
   },
-  async execute(args: { query: string }) {
-    return \`Search results for "\${args.query}": Placeholder \u2014 connect a real search API.\`;
+  async execute(args: { timezone?: string }) {
+    const now = new Date();
+    const tz = args.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const formatted = now.toLocaleString("en-US", {
+      timeZone: tz, weekday: "long", year: "numeric", month: "long", day: "numeric",
+      hour: "2-digit", minute: "2-digit", second: "2-digit", hour12: true,
+    });
+    return \`Current date/time (\${tz}): \${formatted}\`;
   },
 };
-`
-    );
+`);
+    fs.writeFileSync(path.join(targetDir, "agents", "assistant.ts"), `// AI Agent \u2014 autonomous assistant with tools
+import { createAgent } from "@voltx/agents";
+import { calculatorTool } from "../tools/calculator";
+import { datetimeTool } from "../tools/datetime";
+
+export const assistant = createAgent({
+  name: "assistant",
+  model: "${provider}:${model}",
+  instructions: "You are a helpful AI assistant with access to tools: Calculator, Date & Time. Use them when needed to answer questions accurately.",
+  tools: [calculatorTool, datetimeTool],
+  maxIterations: 5,
+});
+`);
     fs.writeFileSync(
-      path.join(targetDir, "src", "routes", "api", "agent.ts"),
-      `import type { Context } from "@voltx/server";
-import { assistant } from "../../agents/assistant";
+      path.join(targetDir, "api", "agent.ts"),
+      `// POST /api/agent \u2014 Run the AI agent
+import type { Context } from "@voltx/server";
+import { assistant } from "../agents/assistant";
 
 export async function POST(c: Context) {
   const { input } = await c.req.json();
@@ -352,36 +400,33 @@ export async function POST(c: Context) {
   }
   if (template === "rag-app") {
     const embedModel = "openai:text-embedding-3-small";
-    fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "rag"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "api", "rag"), { recursive: true });
     fs.writeFileSync(
-      path.join(targetDir, "src", "routes", "api", "rag", "query.ts"),
+      path.join(targetDir, "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 vectorStore = createVectorStore();
 const embedder = createEmbedder({ model: "${embedModel}" });
 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: "${provider}:${model}",
-    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}\`,
+    system: \`Answer based on context. If not relevant, 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"),
+      path.join(targetDir, "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";
@@ -393,11 +438,7 @@ 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);
-  }
-
+  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 });
 }
@@ -405,12 +446,12 @@ export async function POST(c: Context) {
     );
   }
   if (auth === "better-auth") {
-    fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "auth"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "api", "auth"), { recursive: true });
     fs.writeFileSync(
-      path.join(targetDir, "src", "routes", "api", "auth", "[...path].ts"),
+      path.join(targetDir, "api", "auth", "[...path].ts"),
       `// ALL /api/auth/* \u2014 Better Auth handler
 import type { Context } from "@voltx/server";
-import { auth } from "../../../lib/auth";
+import { auth } from "../../src/lib/auth";
 import { createAuthHandler } from "@voltx/auth";
 
 const handler = createAuthHandler(auth);
@@ -419,11 +460,9 @@ export const GET = (c: Context) => handler(c);
 export const POST = (c: Context) => handler(c);
 `
     );
-    fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
     fs.writeFileSync(
       path.join(targetDir, "src", "lib", "auth.ts"),
-      `// Auth configuration \u2014 Better Auth with DB-backed sessions
-import { createAuth, createAuthMiddleware } from "@voltx/auth";
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
 
 export const auth = createAuth("better-auth", {
   database: process.env.DATABASE_URL!,
@@ -437,11 +476,9 @@ export const authMiddleware = createAuthMiddleware({
 `
     );
   } else if (auth === "jwt") {
-    fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
     fs.writeFileSync(
       path.join(targetDir, "src", "lib", "auth.ts"),
-      `// Auth configuration \u2014 JWT (stateless)
-import { createAuth, createAuthMiddleware } from "@voltx/auth";
+      `import { createAuth, createAuthMiddleware } from "@voltx/auth";
 
 export const jwt = createAuth("jwt", {
   secret: process.env.JWT_SECRET!,
@@ -455,18 +492,13 @@ export const authMiddleware = createAuthMiddleware({
 `
     );
     fs.writeFileSync(
-      path.join(targetDir, "src", "routes", "api", "auth.ts"),
-      `// POST /api/auth/login \u2014 Example JWT login route
-import type { Context } from "@voltx/server";
-import { jwt } from "../../lib/auth";
+      path.join(targetDir, "api", "auth.ts"),
+      `import type { Context } from "@voltx/server";
+import { jwt } from "../src/lib/auth";
 
 export async function POST(c: Context) {
   const { email, password } = await c.req.json();
-
-  if (!email || !password) {
-    return c.json({ error: "Email and password are required" }, 400);
-  }
-
+  if (!email || !password) return c.json({ error: "Email and password are required" }, 400);
   const token = await jwt.sign({ sub: email, email });
   return c.json({ token });
 }
@@ -476,74 +508,667 @@ export async function POST(c: Context) {
   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";
+    envContent += "# \u2500\u2500\u2500 Database \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\nDATABASE_URL=\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 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\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
   }
   if (auth === "better-auth") {
-    envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \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\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n";
-    if (template !== "rag-app" && template !== "agent-app") {
-      envContent += "DATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n";
-    }
-    envContent += "# GITHUB_CLIENT_ID=\n# GITHUB_CLIENT_SECRET=\n\n";
+    envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \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\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n\n";
   } else if (auth === "jwt") {
     envContent += "# \u2500\u2500\u2500 Auth (JWT) \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\nJWT_SECRET=your-jwt-secret-key\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
-    )
-  );
+  fs.writeFileSync(path.join(targetDir, ".gitignore"), "node_modules\ndist\n.env\n.env.local\n.env.*.local\nvite.config.voltx.ts\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] [--auth jwt]");
-    process.exit(1);
+function generateServerEntry(projectName, template) {
+  const imports = [];
+  const mounts = [];
+  imports.push('import { GET as healthGET } from "./api/index";');
+  mounts.push('app.get("/api", healthGET);');
+  if (template === "chatbot" || template === "agent-app") {
+    imports.push('import { POST as chatPOST } from "./api/chat";');
+    mounts.push('app.post("/api/chat", chatPOST);');
   }
-  const templateFlag = process.argv.indexOf("--template");
-  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
-  const authFlag = process.argv.indexOf("--auth");
-  const auth = authFlag !== -1 ? process.argv[authFlag + 1] : "none";
-  createProject({ name: projectName, template, auth }).catch((err) => {
-    console.error("[voltx] Error:", err);
-    process.exit(1);
+  if (template === "agent-app") {
+    imports.push('import { POST as agentPOST } from "./api/agent";');
+    mounts.push('app.post("/api/agent", agentPOST);');
+  }
+  if (template === "rag-app") {
+    imports.push('import { POST as ragQueryPOST } from "./api/rag/query";');
+    imports.push('import { POST as ragIngestPOST } from "./api/rag/ingest";');
+    mounts.push('app.post("/api/rag/query", ragQueryPOST);');
+    mounts.push('app.post("/api/rag/ingest", ragIngestPOST);');
+  }
+  return `import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { registerSSR } from "@voltx/server";
+import { loadEnv } from "@voltx/core";
+${imports.join("\n")}
+
+loadEnv(process.env.NODE_ENV ?? "development");
+
+const isProd = process.env.NODE_ENV === "production";
+const app = new Hono();
+
+// \u2500\u2500 API Routes \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+${mounts.join("\n")}
+
+// \u2500\u2500 Static assets (production) \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\u2500\u2500
+if (isProd) {
+  app.use("/assets/*", serveStatic({ root: "./dist/client/" }));
+  app.use("/favicon.svg", serveStatic({ root: "./public/" }));
+  app.use("/robots.txt", serveStatic({ root: "./public/" }));
+  app.use("/site.webmanifest", serveStatic({ root: "./public/" }));
+}
+
+// \u2500\u2500 SSR catch-all \u2014 renders React on the server \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
+registerSSR(app, null, {
+  title: "${projectName}",
+  entryServer: "src/entry-server.tsx",
+  entryClient: "src/entry-client.tsx",
+});
+
+export default app;
+
+if (isProd) {
+  const port = Number(process.env.PORT) || 3000;
+  serve({ fetch: app.fetch, port }, (info) => {
+    console.log(\`\\n  \u26A1 ${projectName} running at http://localhost:\${info.port}\\n\`);
   });
 }
+`;
+}
+function generateViteConfigFile(entry) {
+  return `import { defineConfig } from "vite";
+import devServer from "@hono/vite-dev-server";
+import react from "@vitejs/plugin-react";
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      "@": "/src",
+    },
+  },
+  plugins: [
+    react(),
+    tailwindcss(),
+    devServer({
+      entry: "${entry}",
+      exclude: [
+        /.*\\.tsx?($|\\?)/,
+        /.*\\.(s?css|less)($|\\?)/,
+        /.*\\.(svg|png|jpg|jpeg|gif|webp|ico)($|\\?)/,
+        /^\\/@.+$/,
+        /^\\/favicon\\.svg$/,
+        /^\\/node_modules\\/.*/,
+        /^\\/src\\/.*/,
+      ],
+      injectClientScript: false,
+    }),
+  ],
+});
+`;
+}
+function generateEntryClient() {
+  return `import React from "react";
+import { hydrateRoot } from "react-dom/client";
+import Layout from "./layout";
+import App from "./app";
+import "./globals.css";
+
+hydrateRoot(
+  document.getElementById("root")!,
+  <React.StrictMode>
+    <Layout>
+      <App />
+    </Layout>
+  </React.StrictMode>
+);
+`;
+}
+function generateEntryServer() {
+  return `import React from "react";
+import { renderToReadableStream } from "react-dom/server";
+import Layout from "./layout";
+import App from "./app";
+
+export async function render(_url: string): Promise<ReadableStream> {
+  const stream = await renderToReadableStream(
+    <React.StrictMode>
+      <Layout>
+        <App />
+      </Layout>
+    </React.StrictMode>,
+    {
+      onError(error: unknown) {
+        console.error("[voltx] SSR render error:", error);
+      },
+    }
+  );
+  return stream;
+}
+`;
+}
+function generateLayoutComponent(projectName) {
+  return `import React from "react";
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="min-h-screen bg-background text-foreground font-sans">
+      <header className="border-b border-border px-6 py-3 flex items-center justify-between">
+        <div className="flex items-center gap-2">
+          <span className="text-xl">\u26A1</span>
+          <span className="font-semibold">${projectName}</span>
+        </div>
+        <a href="https://github.com/codewithshail/voltx" target="_blank" rel="noopener noreferrer" className="text-muted text-sm hover:text-foreground transition-colors">
+          Built with VoltX
+        </a>
+      </header>
+      <main>{children}</main>
+    </div>
+  );
+}
+`;
+}
+function generateGlobalCSS(useShadcn = false) {
+  if (useShadcn) {
+    return `@import "tailwindcss";
+
+@theme inline {
+  --radius-sm: 0.25rem;
+  --radius-md: 0.375rem;
+  --radius-lg: 0.5rem;
+  --radius-xl: 0.75rem;
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+  --color-chart-1: hsl(var(--chart-1));
+  --color-chart-2: hsl(var(--chart-2));
+  --color-chart-3: hsl(var(--chart-3));
+  --color-chart-4: hsl(var(--chart-4));
+  --color-chart-5: hsl(var(--chart-5));
+  --color-sidebar: hsl(var(--sidebar));
+  --color-sidebar-foreground: hsl(var(--sidebar-foreground));
+  --color-sidebar-primary: hsl(var(--sidebar-primary));
+  --color-sidebar-primary-foreground: hsl(var(--sidebar-primary-foreground));
+  --color-sidebar-accent: hsl(var(--sidebar-accent));
+  --color-sidebar-accent-foreground: hsl(var(--sidebar-accent-foreground));
+  --color-sidebar-border: hsl(var(--sidebar-border));
+  --color-sidebar-ring: hsl(var(--sidebar-ring));
+}
+
+:root {
+  --background: 0 0% 4%;
+  --foreground: 0 0% 93%;
+  --card: 0 0% 6%;
+  --card-foreground: 0 0% 93%;
+  --popover: 0 0% 6%;
+  --popover-foreground: 0 0% 93%;
+  --primary: 0 0% 93%;
+  --primary-foreground: 0 0% 6%;
+  --secondary: 0 0% 12%;
+  --secondary-foreground: 0 0% 93%;
+  --muted: 0 0% 12%;
+  --muted-foreground: 0 0% 55%;
+  --accent: 0 0% 12%;
+  --accent-foreground: 0 0% 93%;
+  --destructive: 0 62% 50%;
+  --border: 0 0% 14%;
+  --input: 0 0% 14%;
+  --ring: 0 0% 83%;
+  --chart-1: 220 70% 50%;
+  --chart-2: 160 60% 45%;
+  --chart-3: 30 80% 55%;
+  --chart-4: 280 65% 60%;
+  --chart-5: 340 75% 55%;
+  --sidebar: 0 0% 5%;
+  --sidebar-foreground: 0 0% 93%;
+  --sidebar-primary: 0 0% 93%;
+  --sidebar-primary-foreground: 0 0% 6%;
+  --sidebar-accent: 0 0% 12%;
+  --sidebar-accent-foreground: 0 0% 93%;
+  --sidebar-border: 0 0% 14%;
+  --sidebar-ring: 0 0% 83%;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+  border-color: var(--color-border);
+}
+
+html,
+body {
+  height: 100%;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: system-ui, -apple-system, sans-serif;
+  -webkit-font-smoothing: antialiased;
+}
+
+#root {
+  height: 100%;
+}
+`;
+  }
+  return `@import "tailwindcss";
+
+@theme {
+  --color-background: #0a0a0a;
+  --color-foreground: #ededed;
+  --color-muted: #888888;
+  --color-border: #222222;
+  --color-primary: #2563eb;
+  --color-accent: #a78bfa;
+  --font-sans: system-ui, -apple-system, sans-serif;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html,
+body {
+  height: 100%;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: var(--font-sans);
+  -webkit-font-smoothing: antialiased;
+}
+
+#root {
+  height: 100%;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+`;
+}
+function generateCnUtil() {
+  return `import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+`;
+}
+function generateComponentsJson() {
+  return JSON.stringify({
+    "$schema": "https://ui.shadcn.com/schema.json",
+    style: "new-york",
+    rsc: false,
+    tsx: true,
+    tailwind: {
+      config: "",
+      css: "src/globals.css",
+      baseColor: "neutral",
+      cssVariables: true
+    },
+    aliases: {
+      components: "@/components",
+      utils: "@/lib/utils",
+      ui: "@/components/ui",
+      lib: "@/lib",
+      hooks: "@/hooks"
+    }
+  }, null, 2) + "\n";
+}
+function generateAppComponent(projectName, template) {
+  if (template === "blank") {
+    return `import React, { useState, useEffect } from "react";
+
+export default function App() {
+  const [status, setStatus] = useState<string>("checking...");
+
+  useEffect(() => {
+    fetch("/api")
+      .then((res) => res.json())
+      .then((data) => setStatus(data.status || "ok"))
+      .catch(() => setStatus("error"));
+  }, []);
+
+  return (
+    <div className="flex flex-col items-center justify-center min-h-[calc(100vh-60px)] px-6 py-12">
+      <div className="text-center max-w-2xl w-full">
+        {/* Hero */}
+        <div className="relative mb-8">
+          <div className="absolute inset-0 blur-3xl opacity-20 bg-gradient-to-r from-blue-500 via-purple-500 to-blue-500 rounded-full" />
+          <div className="relative text-7xl mb-4">\u26A1</div>
+        </div>
+        <h1 className="text-5xl font-bold tracking-tight mb-3 bg-gradient-to-r from-white to-white/60 bg-clip-text text-transparent">
+          \${"\${projectName}"}
+        </h1>
+        <p className="text-muted text-lg mb-10">The AI-first full-stack framework</p>
+
+        {/* Status cards */}
+        <div className="flex gap-4 justify-center mb-10">
+          <div className="px-6 py-4 rounded-xl bg-white/5 border border-border backdrop-blur-sm">
+            <div className="text-xs text-muted mb-1 uppercase tracking-wider">Server</div>
+            <div className={\`text-sm font-medium \${status === "ok" ? "text-emerald-400" : "text-red-400"}\`}>
+              <span className={\`inline-block w-2 h-2 rounded-full mr-2 \${status === "ok" ? "bg-emerald-400 animate-pulse" : "bg-red-400"}\`} />
+              {status}
+            </div>
+          </div>
+          <div className="px-6 py-4 rounded-xl bg-white/5 border border-border backdrop-blur-sm">
+            <div className="text-xs text-muted mb-1 uppercase tracking-wider">Frontend</div>
+            <div className="text-sm font-medium text-emerald-400">
+              <span className="inline-block w-2 h-2 rounded-full mr-2 bg-emerald-400 animate-pulse" />
+              React + Vite
+            </div>
+          </div>
+          <div className="px-6 py-4 rounded-xl bg-white/5 border border-border backdrop-blur-sm">
+            <div className="text-xs text-muted mb-1 uppercase tracking-wider">CSS</div>
+            <div className="text-sm font-medium text-sky-400">Tailwind v4</div>
+          </div>
+        </div>
+
+        {/* Get started */}
+        <div className="bg-white/[0.03] border border-border rounded-2xl p-8 text-left backdrop-blur-sm">
+          <h2 className="text-sm font-medium text-muted mb-6 uppercase tracking-wider">Get started</h2>
+          <div className="space-y-4">
+            <div className="flex items-start gap-4">
+              <div className="w-8 h-8 rounded-lg bg-purple-500/10 border border-purple-500/20 flex items-center justify-center text-purple-400 text-sm shrink-0">1</div>
+              <div>
+                <code className="text-purple-400 text-sm">src/app.tsx</code>
+                <p className="text-muted text-sm mt-1">Edit this file to build your UI</p>
+              </div>
+            </div>
+            <div className="flex items-start gap-4">
+              <div className="w-8 h-8 rounded-lg bg-blue-500/10 border border-blue-500/20 flex items-center justify-center text-blue-400 text-sm shrink-0">2</div>
+              <div>
+                <code className="text-blue-400 text-sm">api/</code>
+                <p className="text-muted text-sm mt-1">Add API routes here (file-based routing)</p>
+              </div>
+            </div>
+            <div className="flex items-start gap-4">
+              <div className="w-8 h-8 rounded-lg bg-emerald-500/10 border border-emerald-500/20 flex items-center justify-center text-emerald-400 text-sm shrink-0">3</div>
+              <div>
+                <code className="text-emerald-400 text-sm">src/components/</code>
+                <p className="text-muted text-sm mt-1">Create React components with Tailwind CSS</p>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        {/* Links */}
+        <div className="flex gap-6 justify-center mt-8">
+          <a href="https://github.com/codewithshail/voltx" target="_blank" rel="noopener noreferrer" className="text-sm text-muted hover:text-foreground transition-colors">
+            GitHub \u2192
+          </a>
+          <a href="https://voltx.co.in" target="_blank" rel="noopener noreferrer" className="text-sm text-muted hover:text-foreground transition-colors">
+            Docs \u2192
+          </a>
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+  }
+  const apiEndpoint = template === "agent-app" ? "/api/agent" : template === "rag-app" ? "/api/rag/query" : "/api/chat";
+  const isAgent = template === "agent-app";
+  const isRag = template === "rag-app";
+  let emptyStateTitle = "Start a conversation";
+  let emptyStateHint = "Type a message below to chat with AI";
+  let accentColor = "blue";
+  let inputPlaceholder = "Type a message...";
+  if (isAgent) {
+    emptyStateTitle = "Talk to your AI agent";
+    emptyStateHint = "The agent can use tools like Calculator and Date/Time";
+    accentColor = "purple";
+    inputPlaceholder = "Ask the agent anything...";
+  } else if (isRag) {
+    emptyStateTitle = "Ask your documents";
+    emptyStateHint = "Query your knowledge base \u2014 ingest docs via POST /api/rag/ingest";
+    accentColor = "emerald";
+    inputPlaceholder = "Ask a question about your documents...";
+  }
+  return `import React, { useState, useRef, useEffect, useCallback } from "react";
+
+interface Message {
+  id: string;
+  role: "user" | "assistant";
+  content: string;
+}
+
+export default function App() {
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [input, setInput] = useState("");
+  const [isLoading, setIsLoading] = useState(false);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  useEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+  }, [messages]);
+
+  useEffect(() => {
+    inputRef.current?.focus();
+  }, []);
+
+  const sendMessage = useCallback(async () => {
+    const text = input.trim();
+    if (!text || isLoading) return;
+
+    const userMsg: Message = { id: crypto.randomUUID(), role: "user", content: text };
+    setMessages((prev) => [...prev, userMsg]);
+    setInput("");
+    setIsLoading(true);
+
+    const assistantMsg: Message = { id: crypto.randomUUID(), role: "assistant", content: "" };
+    setMessages((prev) => [...prev, assistantMsg]);
+
+    try {${isAgent ? `
+      const res = await fetch("${apiEndpoint}", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ input: text }),
+      });
+      const data = await res.json();
+      setMessages((prev) =>
+        prev.map((m) => m.id === assistantMsg.id ? { ...m, content: data.content || "No response" } : m)
+      );` : `
+      const res = await fetch("${apiEndpoint}", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({${isRag ? ` question: text ` : ` messages: [...messages, { role: "user", content: text }] `}}),
+      });
+
+      if (!res.body) throw new Error("No response body");
+
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let fullContent = "";
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\\n");
+        buffer = lines.pop() ?? "";
+
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          const data = line.slice(6);
+          if (data === "[DONE]") break;
+          try {
+            const parsed = JSON.parse(data);
+            const chunk = parsed.textDelta ?? parsed.content ?? parsed.choices?.[0]?.delta?.content ?? "";
+            if (chunk) {
+              fullContent += chunk;
+              setMessages((prev) =>
+                prev.map((m) => m.id === assistantMsg.id ? { ...m, content: fullContent } : m)
+              );
+            }
+          } catch {}
+        }
+      }`}
+    } catch (err) {
+      setMessages((prev) =>
+        prev.map((m) => m.id === assistantMsg.id ? { ...m, content: "Error: " + (err instanceof Error ? err.message : String(err)) } : m)
+      );
+    } finally {
+      setIsLoading(false);
+    }
+  }, [input, isLoading, messages]);
+
+  return (
+    <div className="h-[calc(100vh-60px)] flex flex-col">
+      <main className="flex-1 overflow-y-auto px-4 py-6">
+        <div className="max-w-3xl mx-auto">
+          {messages.length === 0 && (
+            <div className="flex flex-col items-center justify-center h-[60vh] text-center">
+              <div className="relative mb-6">
+                <div className="absolute inset-0 blur-2xl opacity-20 bg-${accentColor}-500 rounded-full" />
+                <div className="relative text-5xl">\u26A1</div>
+              </div>
+              <h2 className="text-2xl font-semibold mb-2">${emptyStateTitle}</h2>
+              <p className="text-muted text-sm max-w-md">${emptyStateHint}</p>
+              <div className="flex gap-2 mt-6">
+                ${isAgent ? `<button onClick={() => { setInput("What is 42 * 17?"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  What is 42 \xD7 17?
+                </button>
+                <button onClick={() => { setInput("What day is it today?"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  What day is it?
+                </button>` : isRag ? `<button onClick={() => { setInput("Summarize the main topics"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  Summarize main topics
+                </button>
+                <button onClick={() => { setInput("What are the key findings?"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  Key findings
+                </button>` : `<button onClick={() => { setInput("Hello! What can you do?"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  Hello! What can you do?
+                </button>
+                <button onClick={() => { setInput("Tell me a fun fact"); }} className="px-3 py-1.5 text-xs rounded-full bg-white/5 border border-border text-muted hover:text-foreground hover:border-${accentColor}-500/50 transition-all cursor-pointer">
+                  Tell me a fun fact
+                </button>`}
+              </div>
+            </div>
+          )}
+          {messages.map((msg) => (
+            <div key={msg.id} className={\`mb-6 flex \${msg.role === "user" ? "justify-end" : "justify-start"}\`}>
+              <div className={\`flex items-start gap-3 max-w-[80%] \${msg.role === "user" ? "flex-row-reverse" : ""}\`}>
+                <div className={\`w-8 h-8 rounded-full flex items-center justify-center text-sm shrink-0 \${
+                  msg.role === "user" ? "bg-${accentColor}-500 text-white" : "bg-white/10 text-muted"
+                }\`}>
+                  {msg.role === "user" ? "Y" : "\u26A1"}
+                </div>
+                <div className={\`px-4 py-3 rounded-2xl whitespace-pre-wrap leading-relaxed text-sm \${
+                  msg.role === "user"
+                    ? "bg-${accentColor}-500 text-white rounded-br-md"
+                    : "bg-white/[0.05] border border-border rounded-bl-md"
+                }\`}>
+                  {msg.content || (isLoading && msg.role === "assistant" ? (
+                    <span className="flex gap-1">
+                      <span className="w-2 h-2 bg-muted rounded-full animate-bounce [animation-delay:0ms]" />
+                      <span className="w-2 h-2 bg-muted rounded-full animate-bounce [animation-delay:150ms]" />
+                      <span className="w-2 h-2 bg-muted rounded-full animate-bounce [animation-delay:300ms]" />
+                    </span>
+                  ) : "")}
+                </div>
+              </div>
+            </div>
+          ))}
+          <div ref={messagesEndRef} />
+        </div>
+      </main>
+      <footer className="border-t border-border px-4 py-4">
+        <form onSubmit={(e) => { e.preventDefault(); sendMessage(); }} className="max-w-3xl mx-auto flex gap-3">
+          <input
+            ref={inputRef}
+            value={input}
+            onChange={(e) => setInput(e.target.value)}
+            placeholder="${inputPlaceholder}"
+            disabled={isLoading}
+            className="flex-1 px-4 py-3 rounded-xl bg-white/[0.05] border border-border text-foreground placeholder:text-muted/50 outline-none focus:border-${accentColor}-500/50 focus:ring-1 focus:ring-${accentColor}-500/25 transition-all disabled:opacity-50"
+          />
+          <button
+            type="submit"
+            disabled={isLoading || !input.trim()}
+            className="px-6 py-3 rounded-xl font-medium text-sm transition-all disabled:opacity-30 disabled:cursor-not-allowed bg-${accentColor}-500 hover:bg-${accentColor}-400 text-white cursor-pointer"
+          >
+            {isLoading ? (
+              <svg className="w-5 h-5 animate-spin" viewBox="0 0 24 24" fill="none">
+                <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
+                <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" />
+              </svg>
+            ) : "Send"}
+          </button>
+        </form>
+      </footer>
+    </div>
+  );
+}
+`;
+}
+function generateFaviconSVG() {
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="6" fill="#0a0a0a"/>
+  <path d="M18.5 4L8 18h7l-1.5 10L24 14h-7l1.5-10z" fill="#facc15" stroke="#facc15" stroke-width="0.5" stroke-linejoin="round"/>
+</svg>
+`;
+}
+function generateRobotsTxt() {
+  return `# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Allow: /
+
+Sitemap: /sitemap.xml
+`;
+}
+function generateWebManifest(projectName) {
+  return JSON.stringify({
+    name: projectName,
+    short_name: projectName,
+    icons: [
+      { src: "/favicon.svg", sizes: "any", type: "image/svg+xml" }
+    ],
+    theme_color: "#0a0a0a",
+    background_color: "#0a0a0a",
+    display: "standalone"
+  }, null, 2) + "\n";
+}
 
 // src/dev.ts
 var import_node_child_process = require("child_process");
 var import_node_path = require("path");
 var import_node_fs = require("fs");
+var import_core = require("@voltx/core");
 async function runDev(options = {}) {
   const cwd = process.cwd();
   const {
@@ -552,7 +1177,7 @@ async function runDev(options = {}) {
     clearScreen = true
   } = options;
   if (!entry) {
-    console.error("[voltx] Could not find entry point. Expected src/index.ts or src/index.js");
+    console.error("[voltx] Could not find entry point. Expected server.ts or src/index.ts");
     process.exit(1);
   }
   const entryPath = (0, import_node_path.resolve)(cwd, entry);
@@ -560,56 +1185,124 @@ async function runDev(options = {}) {
     console.error(`[voltx] Entry file not found: ${entry}`);
     process.exit(1);
   }
-  const envFile = (0, import_node_path.resolve)(cwd, ".env");
+  (0, import_core.loadEnv)("development", cwd);
+  const hasViteConfig = (0, import_node_fs.existsSync)((0, import_node_path.resolve)(cwd, "vite.config.ts"));
+  const hasServerEntry = (0, import_node_fs.existsSync)((0, import_node_path.resolve)(cwd, "server.ts"));
+  const isFullStack = hasViteConfig || hasServerEntry;
+  if (isFullStack) {
+    await startViteDevServer(cwd, port, entry, options);
+  } else {
+    await startTsxWatch(cwd, port, entry, options);
+  }
+}
+async function startViteDevServer(cwd, port, entry, options) {
+  const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
+  printDevBanner(entry, resolvedPort, true);
+  const userViteConfig = (0, import_node_path.resolve)(cwd, "vite.config.ts");
+  const hasUserViteConfig = (0, import_node_fs.existsSync)(userViteConfig);
+  let tempConfigPath = null;
+  if (!hasUserViteConfig) {
+    tempConfigPath = (0, import_node_path.resolve)(cwd, "vite.config.voltx.ts");
+    const viteConfigContent = generateViteConfig(entry, resolvedPort);
+    (0, import_node_fs.writeFileSync)(tempConfigPath, viteConfigContent, "utf-8");
+  }
   const env = {
     ...process.env,
     NODE_ENV: "development"
   };
-  if ((0, import_node_fs.existsSync)(envFile)) {
-    const envContent = (0, import_node_fs.readFileSync)(envFile, "utf-8");
-    for (const line of envContent.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const eqIdx = trimmed.indexOf("=");
-      if (eqIdx === -1) continue;
-      const key = trimmed.slice(0, eqIdx).trim();
-      const value = trimmed.slice(eqIdx + 1).trim();
-      env[key] = value;
+  if (port) {
+    env.PORT = String(port);
+  }
+  const viteBin = findBin(cwd, "vite");
+  const viteArgs = ["dev"];
+  if (tempConfigPath) {
+    viteArgs.push("--config", tempConfigPath);
+  }
+  viteArgs.push("--port", String(resolvedPort));
+  let child;
+  if (viteBin) {
+    child = (0, import_node_child_process.spawn)(viteBin, viteArgs, { cwd, env, stdio: "inherit" });
+  } else {
+    child = (0, import_node_child_process.spawn)("npx", ["vite", ...viteArgs], { cwd, env, stdio: "inherit" });
+  }
+  const cleanup = () => {
+    if (tempConfigPath && (0, import_node_fs.existsSync)(tempConfigPath)) {
+      try {
+        (0, import_node_fs.unlinkSync)(tempConfigPath);
+      } catch {
+      }
     }
+  };
+  const signals = ["SIGINT", "SIGTERM"];
+  for (const signal of signals) {
+    process.on(signal, () => {
+      cleanup();
+      child.kill(signal);
+    });
   }
+  child.on("error", (err) => {
+    cleanup();
+    if (err.code === "ENOENT") {
+      console.error("[voltx] vite not found. Install it with: npm install -D vite @hono/vite-dev-server");
+    } else {
+      console.error("[voltx] Dev server error:", err.message);
+    }
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    cleanup();
+    process.exit(code ?? 0);
+  });
+}
+function generateViteConfig(entry, port) {
+  return `// Auto-generated by VoltX \u2014 do not commit this file
+import { defineConfig } from "vite";
+import devServer from "@hono/vite-dev-server";
+
+export default defineConfig({
+  server: {
+    port: ${port},
+  },
+  plugins: [
+    devServer({
+      entry: "${entry}",
+      exclude: [
+        /.*\\.tsx?($|\\?)/,
+        /.*\\.(s?css|less)($|\\?)/,
+        /.*\\.(svg|png|jpg|jpeg|gif|webp|ico)($|\\?)/,
+        /^\\/@.+$/,
+        /^\\/favicon\\.svg$/,
+        /^\\/node_modules\\/.*/,
+        /^\\/src\\/.*/,
+      ],
+      injectClientScript: false,
+    }),
+  ],
+});
+`;
+}
+async function startTsxWatch(cwd, port, entry, options) {
+  const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
+  printDevBanner(entry, resolvedPort, false);
+  const env = {
+    ...process.env,
+    NODE_ENV: "development"
+  };
   if (port) {
     env.PORT = String(port);
   }
-  printDevBanner(entry, port);
   const tsxArgs = ["watch"];
-  if (clearScreen) {
+  if (options.clearScreen ?? true) {
     tsxArgs.push("--clear-screen=false");
   }
-  const watchDirs = [
-    "src/routes",
-    "src/agents",
-    "src/tools",
-    "src/jobs",
-    "src/lib",
-    "voltx.config.ts",
-    ...options.watch ?? []
-  ];
   tsxArgs.push("--ignore=node_modules", "--ignore=dist", "--ignore=.turbo");
   tsxArgs.push(entry);
-  const tsxBin = findTsxBin(cwd);
+  const tsxBin = findBin(cwd, "tsx");
   let child;
   if (tsxBin) {
-    child = (0, import_node_child_process.spawn)(tsxBin, tsxArgs, {
-      cwd,
-      env,
-      stdio: "inherit"
-    });
+    child = (0, import_node_child_process.spawn)(tsxBin, tsxArgs, { cwd, env, stdio: "inherit" });
   } else {
-    child = (0, import_node_child_process.spawn)("npx", ["tsx", ...tsxArgs], {
-      cwd,
-      env,
-      stdio: "inherit"
-    });
+    child = (0, import_node_child_process.spawn)("npx", ["tsx", ...tsxArgs], { cwd, env, stdio: "inherit" });
   }
   const signals = ["SIGINT", "SIGTERM"];
   for (const signal of signals) {
@@ -620,7 +1313,6 @@ async function runDev(options = {}) {
   child.on("error", (err) => {
     if (err.code === "ENOENT") {
       console.error("[voltx] tsx not found. Install it with: npm install -D tsx");
-      console.error("[voltx] Or run your app directly: npx tsx watch src/index.ts");
     } else {
       console.error("[voltx] Dev server error:", err.message);
     }
@@ -632,6 +1324,8 @@ async function runDev(options = {}) {
 }
 function findEntryPoint(cwd) {
   const candidates = [
+    "server.ts",
+    "server.js",
     "src/index.ts",
     "src/index.js",
     "src/index.mts",
@@ -647,24 +1341,27 @@ function findEntryPoint(cwd) {
   }
   return null;
 }
-function findTsxBin(cwd) {
-  const localBin = (0, import_node_path.join)(cwd, "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(localBin)) return localBin;
-  const parentBin = (0, import_node_path.join)(cwd, "..", "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(parentBin)) return parentBin;
-  const rootBin = (0, import_node_path.join)(cwd, "..", "..", "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(rootBin)) return rootBin;
+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 printDevBanner(entry, port) {
+function printDevBanner(entry, port, fullStack) {
   console.log("");
   console.log("  \u26A1 VoltX Dev Server");
   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}`);
-  if (port) {
-    console.log(`  Port:    ${port}`);
+  console.log(`  Port:    ${port}`);
+  console.log(`  Mode:    ${fullStack ? "full-stack (Vite + Hono)" : "API-only (tsx watch)"}`);
+  if (fullStack) {
+    console.log(`  HMR:     enabled (frontend + backend)`);
   }
-  console.log(`  Mode:    development (hot reload)`);
   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("");
 }
@@ -673,6 +1370,7 @@ function printDevBanner(entry, port) {
 var import_node_child_process2 = require("child_process");
 var import_node_path2 = require("path");
 var import_node_fs2 = require("fs");
+var import_core2 = require("@voltx/core");
 async function runBuild(options = {}) {
   const cwd = process.cwd();
   const {
@@ -682,7 +1380,7 @@ async function runBuild(options = {}) {
     sourcemap = false
   } = options;
   if (!entry) {
-    console.error("[voltx] Could not find entry point. Expected src/index.ts");
+    console.error("[voltx] Could not find entry point. Expected server.ts or src/index.ts");
     process.exit(1);
   }
   const entryPath = (0, import_node_path2.resolve)(cwd, entry);
@@ -690,59 +1388,87 @@ async function runBuild(options = {}) {
     console.error(`[voltx] Entry file not found: ${entry}`);
     process.exit(1);
   }
+  (0, import_core2.loadEnv)("production", cwd);
+  const hasViteConfig = (0, import_node_fs2.existsSync)((0, import_node_path2.resolve)(cwd, "vite.config.ts"));
+  const hasServerEntry = (0, import_node_fs2.existsSync)((0, import_node_path2.resolve)(cwd, "server.ts"));
+  const isFullStack = hasViteConfig || hasServerEntry;
   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(`  Mode:    ${isFullStack ? "full-stack" : "API-only"}`);
   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_fs2.mkdirSync)((0, import_node_path2.resolve)(cwd, outDir), { recursive: true });
-  console.log("  [1/2] Building server...");
+  if (isFullStack) {
+    await buildFullStack(cwd, entry, outDir, minify, sourcemap);
+  } else {
+    await buildApiOnly(cwd, entry, outDir, minify, sourcemap);
+  }
+  console.log("");
+  console.log("  \u26A1 Build complete!");
+  console.log(`  Run \`voltx start\` to start the production server.`);
+  console.log("");
+}
+async function buildFullStack(cwd, entry, outDir, minify, sourcemap) {
+  const ssrEntry = (0, import_node_fs2.existsSync)((0, import_node_path2.join)(cwd, "src", "entry-server.tsx")) ? "src/entry-server.tsx" : null;
+  const totalSteps = ssrEntry ? 3 : 2;
+  console.log(`  [1/${totalSteps}] Building client...`);
+  const viteBin = findBin2(cwd, "vite");
+  const clientOutDir = (0, import_node_path2.join)(outDir, "client");
+  await runCommand(
+    viteBin ?? "npx",
+    viteBin ? ["build", "--outDir", clientOutDir] : ["vite", "build", "--outDir", clientOutDir],
+    cwd
+  );
+  console.log("  \u2713 Client built");
+  if (ssrEntry) {
+    console.log(`  [2/${totalSteps}] Building SSR bundle...`);
+    const serverOutDir = (0, import_node_path2.join)(outDir, "server");
+    await runCommand(
+      viteBin ?? "npx",
+      viteBin ? ["build", "--ssr", ssrEntry, "--outDir", serverOutDir] : ["vite", "build", "--ssr", ssrEntry, "--outDir", serverOutDir],
+      cwd
+    );
+    console.log("  \u2713 SSR bundle built");
+  }
+  const serverStep = ssrEntry ? 3 : 2;
+  console.log(`  [${serverStep}/${totalSteps}] Building server...`);
+  await buildServer(cwd, entry, outDir, minify, sourcemap, false);
+  console.log("  \u2713 Server built");
+}
+async function buildApiOnly(cwd, entry, outDir, minify, sourcemap) {
+  console.log("  [1/1] Building server...");
+  await buildServer(cwd, entry, outDir, minify, sourcemap);
+  console.log("  \u2713 Server built");
+}
+async function buildServer(cwd, entry, outDir, minify, sourcemap, clean = true) {
+  const tsupBin = findBin2(cwd, "tsup");
   const tsupArgs = [
     entry,
     "--format",
     "esm",
     "--out-dir",
     outDir,
-    "--clean",
     "--target",
-    "node20"
+    "node20",
+    "--no-splitting"
   ];
+  if (clean) tsupArgs.push("--clean");
   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_path2.resolve)(cwd, "src", "frontend");
-  const viteConfig = (0, import_node_path2.resolve)(cwd, "vite.config.ts");
-  const hasFrontend = (0, import_node_fs2.existsSync)(frontendDir) || (0, import_node_fs2.existsSync)(viteConfig);
-  if (hasFrontend) {
-    console.log("  [2/2] Building frontend...");
-    const viteBin = findBin(cwd, "vite");
-    const viteArgs = ["build", "--outDir", (0, import_node_path2.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 findEntryPoint2(cwd) {
   const candidates = [
+    "server.ts",
+    "server.js",
     "src/index.ts",
     "src/index.js",
     "src/index.mts",
@@ -756,7 +1482,7 @@ function findEntryPoint2(cwd) {
   }
   return null;
 }
-function findBin(cwd, name) {
+function findBin2(cwd, name) {
   const paths = [
     (0, import_node_path2.join)(cwd, "node_modules", ".bin", name),
     (0, import_node_path2.join)(cwd, "..", "node_modules", ".bin", name),
@@ -791,6 +1517,7 @@ function runCommand(cmd, args, cwd) {
 var import_node_child_process3 = require("child_process");
 var import_node_path3 = require("path");
 var import_node_fs3 = require("fs");
+var import_core3 = require("@voltx/core");
 async function runStart(options = {}) {
   const cwd = process.cwd();
   const { port, outDir = "dist" } = options;
@@ -811,26 +1538,15 @@ async function runStart(options = {}) {
     console.error(`[voltx] Entry file not found: ${outDir}/${entry}`);
     process.exit(1);
   }
+  (0, import_core3.loadEnv)("production", cwd);
   const env = {
     ...process.env,
     NODE_ENV: "production"
   };
-  const envFile = (0, import_node_path3.resolve)(cwd, ".env");
-  if ((0, import_node_fs3.existsSync)(envFile)) {
-    const envContent = (0, import_node_fs3.readFileSync)(envFile, "utf-8");
-    for (const line of envContent.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const eqIdx = trimmed.indexOf("=");
-      if (eqIdx === -1) continue;
-      const key = trimmed.slice(0, eqIdx).trim();
-      const value = trimmed.slice(eqIdx + 1).trim();
-      env[key] = value;
-    }
-  }
   if (port) {
     env.PORT = String(port);
   }
+  const hasClientBuild = (0, import_node_fs3.existsSync)((0, import_node_path3.resolve)(distDir, "client"));
   console.log("");
   console.log("  \u26A1 VoltX Production Server");
   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");
@@ -838,7 +1554,7 @@ async function runStart(options = {}) {
   if (port) {
     console.log(`  Port:    ${port}`);
   }
-  console.log(`  Mode:    production`);
+  console.log(`  Mode:    ${hasClientBuild ? "full-stack" : "API-only"}`);
   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("");
   const child = (0, import_node_child_process3.spawn)("node", [entryPath], {
@@ -862,13 +1578,13 @@ async function runStart(options = {}) {
 }
 function findDistEntry(distDir) {
   const candidates = [
+    "server.mjs",
+    "server.js",
     "index.mjs",
     "index.js",
     "index.cjs",
     "main.mjs",
-    "main.js",
-    "src/index.mjs",
-    "src/index.js"
+    "main.js"
   ];
   for (const candidate of candidates) {
     if ((0, import_node_fs3.existsSync)((0, import_node_path3.join)(distDir, candidate))) {
@@ -905,13 +1621,13 @@ async function runGenerate(options) {
 }
 function generateRoute(cwd, name, method = "POST") {
   const routePath = name.startsWith("/") ? name.slice(1) : name;
-  const filePath = (0, import_node_path4.join)(cwd, "src", "routes", `${routePath}.ts`);
+  const filePath = (0, import_node_path4.join)(cwd, "api", `${routePath}.ts`);
   if ((0, import_node_fs4.existsSync)(filePath)) {
-    console.error(`[voltx] Route already exists: src/routes/${routePath}.ts`);
+    console.error(`[voltx] Route already exists: api/${routePath}.ts`);
     process.exit(1);
   }
   const upperMethod = method.toUpperCase();
-  const urlPath = "/" + routePath;
+  const urlPath = "/api/" + routePath;
   const content = `// ${upperMethod} ${urlPath}
 import type { Context } from "@voltx/server";
 
@@ -920,13 +1636,13 @@ export async function ${upperMethod}(c: Context) {
 }
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created route: src/routes/${routePath}.ts`);
+  console.log(`  \u2713 Created route: api/${routePath}.ts`);
   console.log(`    ${upperMethod} ${urlPath}`);
 }
 function generateAgent(cwd, name) {
-  const filePath = (0, import_node_path4.join)(cwd, "src", "agents", `${name}.ts`);
+  const filePath = (0, import_node_path4.join)(cwd, "agents", `${name}.ts`);
   if ((0, import_node_fs4.existsSync)(filePath)) {
-    console.error(`[voltx] Agent already exists: src/agents/${name}.ts`);
+    console.error(`[voltx] Agent already exists: agents/${name}.ts`);
     process.exit(1);
   }
   const content = `// Agent: ${name}
@@ -948,12 +1664,12 @@ export const ${toCamelCase(name)} = createAgent({
 });
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created agent: src/agents/${name}.ts`);
+  console.log(`  \u2713 Created agent: agents/${name}.ts`);
 }
 function generateTool(cwd, name) {
-  const filePath = (0, import_node_path4.join)(cwd, "src", "tools", `${name}.ts`);
+  const filePath = (0, import_node_path4.join)(cwd, "tools", `${name}.ts`);
   if ((0, import_node_fs4.existsSync)(filePath)) {
-    console.error(`[voltx] Tool already exists: src/tools/${name}.ts`);
+    console.error(`[voltx] Tool already exists: tools/${name}.ts`);
     process.exit(1);
   }
   const content = `// Tool: ${name}
@@ -975,12 +1691,12 @@ export const ${toCamelCase(name)}Tool = {
 };
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created tool: src/tools/${name}.ts`);
+  console.log(`  \u2713 Created tool: tools/${name}.ts`);
 }
 function generateJob(cwd, name) {
-  const filePath = (0, import_node_path4.join)(cwd, "src", "jobs", `${name}.ts`);
+  const filePath = (0, import_node_path4.join)(cwd, "jobs", `${name}.ts`);
   if ((0, import_node_fs4.existsSync)(filePath)) {
-    console.error(`[voltx] Job already exists: src/jobs/${name}.ts`);
+    console.error(`[voltx] Job already exists: jobs/${name}.ts`);
     process.exit(1);
   }
   const content = `// Job: ${name}
@@ -1005,7 +1721,7 @@ export async function run(ctx: any, data?: Record<string, unknown>) {
 }
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created job: src/jobs/${name}.ts`);
+  console.log(`  \u2713 Created job: jobs/${name}.ts`);
 }
 function writeFileSafe(filePath, content) {
   const dir = (0, import_node_path4.dirname)(filePath);
@@ -1017,7 +1733,7 @@ function toCamelCase(str) {
 }
 
 // src/index.ts
-var CLI_VERSION = "0.3.3";
+var CLI_VERSION = "0.3.5";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CLI_VERSION,