@vertz/create-vertz-app 0.2.35 → 0.2.37

package/bin/create-vertz-app.ts

@@ -13,10 +13,11 @@ program
   .description('Scaffold a new Vertz project')
   .version(pkg.version)
   .argument('[name]', 'Project name')
-  .action(async (name: string | undefined) => {
+  .option('--template <type>', 'Template to use (hello-world, todo-app)', 'todo-app')
+  .action(async (name: string | undefined, opts: { template?: string }) => {
     const { resolveOptions, scaffold } = await import('../dist/index.js');
     try {
-      const resolved = await resolveOptions({ projectName: name });
+      const resolved = await resolveOptions({ projectName: name, template: opts.template });
 
       console.log(`Creating Vertz app: ${resolved.projectName} (v${pkg.version})`);
 

package/dist/prompts.d.ts

@@ -5,6 +5,12 @@ import type { CliOptions, ScaffoldOptions } from './types.js';
 export declare class ProjectNameRequiredError extends Error {
     constructor();
 }
+/**
+ * Error thrown when an invalid template type is provided
+ */
+export declare class InvalidTemplateError extends Error {
+    constructor(template: string);
+}
 /**
  * Prompts the user for project name
  */

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAY5D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAY9F"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAC;AAK5E;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,QAAQ,EAAE,MAAM;CAM7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAY5D;AAaD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAc9F"}

package/dist/prompts.js

@@ -1,4 +1,6 @@
 import { createInterface } from 'node:readline';
+const VALID_TEMPLATES = ['hello-world', 'todo-app'];
+const DEFAULT_TEMPLATE = 'todo-app';
 /**
  * Error thrown in CI mode when project name is required but not provided
  */
@@ -8,6 +10,15 @@ export class ProjectNameRequiredError extends Error {
         this.name = 'ProjectNameRequiredError';
     }
 }
+/**
+ * Error thrown when an invalid template type is provided
+ */
+export class InvalidTemplateError extends Error {
+    constructor(template) {
+        super(`Invalid template "${template}". Available templates: ${VALID_TEMPLATES.join(', ')}`);
+        this.name = 'InvalidTemplateError';
+    }
+}
 /**
  * Prompts the user for project name
  */
@@ -23,6 +34,17 @@ export async function promptForProjectName() {
         });
     });
 }
+/**
+ * Validates and returns a template type
+ */
+function resolveTemplate(template) {
+    if (!template)
+        return DEFAULT_TEMPLATE;
+    if (VALID_TEMPLATES.includes(template)) {
+        return template;
+    }
+    throw new InvalidTemplateError(template);
+}
 /**
  * Resolves CLI options into complete scaffold options
  * Handles both interactive and CI modes
@@ -36,5 +58,6 @@ export async function resolveOptions(cliOptions) {
         }
         projectName = await promptForProjectName();
     }
-    return { projectName };
+    const template = resolveTemplate(cliOptions.template);
+    return { projectName, template };
 }

package/dist/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,WAAW,EAAE,MAAM;CAIhC;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEzF"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,WAAW,EAAE,MAAM;CAIhC;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBzF"}

package/dist/scaffold.js

@@ -1,6 +1,6 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
-import { apiDevelopmentRuleTemplate, appComponentTemplate, bunfigTemplate, bunPluginShimTemplate, claudeMdTemplate, clientTemplate, dbTemplate, entryClientTemplate, envExampleTemplate, envModuleTemplate, envTemplate, faviconTemplate, gitignoreTemplate, homePageTemplate, packageJsonTemplate, schemaTemplate, serverTemplate, tasksEntityTemplate, themeTemplate, tsconfigTemplate, uiDevelopmentRuleTemplate, vertzConfigTemplate, } from './templates/index.js';
+import { apiDevelopmentRuleTemplate, appComponentTemplate, bunfigTemplate, bunPluginShimTemplate, claudeMdTemplate, clientTemplate, dbTemplate, entryClientTemplate, envExampleTemplate, envModuleTemplate, envTemplate, faviconTemplate, gitignoreTemplate, helloWorldAppTemplate, helloWorldClaudeMdTemplate, helloWorldHomePageTemplate, helloWorldPackageJsonTemplate, helloWorldVertzConfigTemplate, homePageTemplate, packageJsonTemplate, schemaTemplate, serverTemplate, tasksEntityTemplate, themeTemplate, tsconfigTemplate, uiDevelopmentRuleTemplate, vertzConfigTemplate, } from './templates/index.js';
 /**
  * Error thrown when the project directory already exists
  */
@@ -16,7 +16,7 @@ export class DirectoryExistsError extends Error {
  * @param options - Scaffold options
  */
 export async function scaffold(parentDir, options) {
-    const { projectName } = options;
+    const { projectName, template } = options;
     const projectDir = path.join(parentDir, projectName);
     // Check if directory already exists
     try {
@@ -29,7 +29,52 @@ export async function scaffold(parentDir, options) {
         }
         // Directory doesn't exist, which is what we want
     }
-    // Create project directory and subdirectories
+    if (template === 'hello-world') {
+        await scaffoldHelloWorld(projectDir, projectName);
+    }
+    else {
+        await scaffoldTodoApp(projectDir, projectName);
+    }
+}
+/**
+ * Scaffolds the hello-world template — UI-only with a reactive counter
+ */
+async function scaffoldHelloWorld(projectDir, projectName) {
+    const srcDir = path.join(projectDir, 'src');
+    const pagesDir = path.join(srcDir, 'pages');
+    const stylesDir = path.join(srcDir, 'styles');
+    const claudeRulesDir = path.join(projectDir, '.claude', 'rules');
+    const publicDir = path.join(projectDir, 'public');
+    await Promise.all([
+        fs.mkdir(pagesDir, { recursive: true }),
+        fs.mkdir(stylesDir, { recursive: true }),
+        fs.mkdir(claudeRulesDir, { recursive: true }),
+        fs.mkdir(publicDir, { recursive: true }),
+    ]);
+    await Promise.all([
+        // Config files
+        writeFile(projectDir, 'package.json', helloWorldPackageJsonTemplate(projectName)),
+        writeFile(projectDir, 'tsconfig.json', tsconfigTemplate()),
+        writeFile(projectDir, 'vertz.config.ts', helloWorldVertzConfigTemplate()),
+        writeFile(projectDir, '.gitignore', gitignoreTemplate()),
+        writeFile(projectDir, 'bunfig.toml', bunfigTemplate()),
+        writeFile(projectDir, 'bun-plugin-shim.ts', bunPluginShimTemplate()),
+        // UI source files
+        writeFile(srcDir, 'app.tsx', helloWorldAppTemplate()),
+        writeFile(srcDir, 'entry-client.ts', entryClientTemplate()),
+        writeFile(pagesDir, 'home.tsx', helloWorldHomePageTemplate()),
+        writeFile(stylesDir, 'theme.ts', themeTemplate()),
+        // Static assets
+        writeFile(publicDir, 'favicon.svg', faviconTemplate()),
+        // LLM rules
+        writeFile(projectDir, 'CLAUDE.md', helloWorldClaudeMdTemplate(projectName)),
+        writeFile(claudeRulesDir, 'ui-development.md', uiDevelopmentRuleTemplate()),
+    ]);
+}
+/**
+ * Scaffolds the todo-app template — full-stack with DB, API, entities, and UI
+ */
+async function scaffoldTodoApp(projectDir, projectName) {
     const srcDir = path.join(projectDir, 'src');
     const apiDir = path.join(srcDir, 'api');
     const entitiesDir = path.join(apiDir, 'entities');
@@ -44,7 +89,6 @@ export async function scaffold(parentDir, options) {
         fs.mkdir(claudeRulesDir, { recursive: true }),
         fs.mkdir(publicDir, { recursive: true }),
     ]);
-    // Write all files in parallel
     await Promise.all([
         // Config files
         writeFile(projectDir, 'package.json', packageJsonTemplate(projectName)),

package/dist/templates/index.d.ts

@@ -88,4 +88,25 @@ export declare function themeTemplate(): string;
  * Demonstrates theme components (Button, Input) and DialogStack confirmation.
  */
 export declare function homePageTemplate(): string;
+/**
+ * CLAUDE.md for hello-world template — UI-only project description
+ */
+export declare function helloWorldClaudeMdTemplate(projectName: string): string;
+/**
+ * Package.json for hello-world — no API deps, no #generated imports, no codegen
+ */
+export declare function helloWorldPackageJsonTemplate(projectName: string): string;
+/**
+ * vertz.config.ts for hello-world — minimal, no server entry
+ */
+export declare function helloWorldVertzConfigTemplate(): string;
+/**
+ * src/app.tsx for hello-world — simple App with ThemeProvider
+ */
+export declare function helloWorldAppTemplate(): string;
+/**
+ * src/pages/home.tsx for hello-world — reactive counter demonstrating
+ * the Vertz compiler's signal transformation (let → signal)
+ */
+export declare function helloWorldHomePageTemplate(): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6B5D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAyJnD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAoRlD;AAID;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6B/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAoBzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAc9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6B1C;AAID;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAoBvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAavC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAWnC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAe5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAgD7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CActC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmLzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6B5D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAyJnD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAoRlD;AAID;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6B/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAoBzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAc9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6B1C;AAID;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAoBvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAavC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAWnC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAe5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAgD7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CActC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmLzC;AAID;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA8BtE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAuBzE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAItD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAgC9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CA4BnD"}

package/dist/templates/index.js

@@ -997,3 +997,141 @@ export function HomePage() {
 }
 `;
 }
+// ── Hello World template functions ────────────────────────
+/**
+ * CLAUDE.md for hello-world template — UI-only project description
+ */
+export function helloWorldClaudeMdTemplate(projectName) {
+    return `# ${projectName}
+
+A UI-only TypeScript application built with [Vertz](https://vertz.dev).
+
+## Stack
+
+- Runtime: Bun
+- Framework: Vertz (UI)
+- Language: TypeScript (strict mode)
+- Docs: https://docs.vertz.dev
+
+## Development
+
+\`\`\`bash
+bun install          # Install dependencies
+bun run dev          # Start dev server with HMR
+bun run build        # Production build
+\`\`\`
+
+## Adding a Backend
+
+To add API and database support, see https://docs.vertz.dev/guides/server/overview
+
+## Conventions
+
+- See \`.claude/rules/\` for UI development conventions
+- Refer to https://docs.vertz.dev for full framework documentation
+- The Vertz compiler handles all reactivity — never use \`.value\`, \`signal()\`, or \`computed()\` manually
+`;
+}
+/**
+ * Package.json for hello-world — no API deps, no #generated imports, no codegen
+ */
+export function helloWorldPackageJsonTemplate(projectName) {
+    const pkg = {
+        name: projectName,
+        version: '0.1.0',
+        type: 'module',
+        license: 'MIT',
+        scripts: {
+            dev: 'vertz dev',
+            build: 'vertz build',
+        },
+        dependencies: {
+            vertz: '^0.2.0',
+            '@vertz/theme-shadcn': '^0.2.0',
+        },
+        devDependencies: {
+            '@vertz/cli': '^0.2.0',
+            '@vertz/ui-compiler': '^0.2.0',
+            'bun-types': '^1.0.0',
+            typescript: '^5.8.0',
+        },
+    };
+    return JSON.stringify(pkg, null, 2);
+}
+/**
+ * vertz.config.ts for hello-world — minimal, no server entry
+ */
+export function helloWorldVertzConfigTemplate() {
+    return `/** @type {import('@vertz/compiler').VertzConfig} */
+export default {};
+`;
+}
+/**
+ * src/app.tsx for hello-world — simple App with ThemeProvider
+ */
+export function helloWorldAppTemplate() {
+    return `import { css, getInjectedCSS, globalCss, ThemeProvider } from 'vertz/ui';
+import { HomePage } from './pages/home';
+import { appTheme, themeGlobals } from './styles/theme';
+
+const appGlobals = globalCss({
+  a: {
+    textDecoration: 'none',
+    color: 'inherit',
+  },
+});
+
+const styles = css({
+  shell: ['min-h:screen', 'bg:background', 'text:foreground'],
+});
+
+export { getInjectedCSS };
+export const theme = appTheme;
+export const globalStyles = [themeGlobals.css, appGlobals.css];
+
+export function App() {
+  return (
+    <div data-testid="app-root">
+      <ThemeProvider theme="light">
+        <div className={styles.shell}>
+          <HomePage />
+        </div>
+      </ThemeProvider>
+    </div>
+  );
+}
+`;
+}
+/**
+ * src/pages/home.tsx for hello-world — reactive counter demonstrating
+ * the Vertz compiler's signal transformation (let → signal)
+ */
+export function helloWorldHomePageTemplate() {
+    return `import { css } from 'vertz/ui';
+import { Button } from '@vertz/ui/components';
+
+const styles = css({
+  container: ['flex', 'flex-col', 'items:center', 'justify:center', 'min-h:screen', 'gap:6'],
+  title: ['font:4xl', 'font:bold', 'text:foreground'],
+  subtitle: ['text:muted-foreground', 'text:lg'],
+  count: ['font:6xl', 'font:bold', 'text:primary'],
+  actions: ['flex', 'gap:3'],
+});
+
+export function HomePage() {
+  let count = 0;
+
+  return (
+    <div className={styles.container} data-testid="home-page">
+      <h1 className={styles.title}>Hello, Vertz!</h1>
+      <p className={styles.subtitle}>A reactive counter powered by the Vertz compiler</p>
+      <p className={styles.count}>{count}</p>
+      <div className={styles.actions}>
+        <Button intent="ghost" onClick={() => { count = 0; }}>Reset</Button>
+        <Button onClick={() => { count++; }}>Count is {count}</Button>
+      </div>
+    </div>
+  );
+}
+`;
+}

package/dist/types.d.ts

@@ -1,9 +1,15 @@
+/**
+ * Available scaffold template types
+ */
+export type TemplateType = 'hello-world' | 'todo-app';
 /**
  * Options for the scaffold function
  */
 export interface ScaffoldOptions {
     /** Name of the project to create */
     projectName: string;
+    /** Template to scaffold (default: 'todo-app') */
+    template: TemplateType;
 }
 /**
  * CLI options parsed from command line flags
@@ -11,5 +17,7 @@ export interface ScaffoldOptions {
 export interface CliOptions {
     /** Project name (positional argument or --name) */
     projectName?: string;
+    /** Template type */
+    template?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,UAAU,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/create-vertz-app",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "description": "Create a new Vertz application",
   "license": "MIT",
   "repository": {