create-vista-app 0.2.1 → 0.2.3

package/bin/cli.js

@@ -15,25 +15,30 @@ function detectPackageManager() {
   return 'npm';
 }
 
-const pkgManager = detectPackageManager();
-
-if (process.argv.includes('--help') || process.argv.includes('-h')) {
-  console.log(`
-Usage:
-  ${usageCommand}
-
-Example:
-  npx create-vista-app@latest my-vista-app
-`);
-  process.exit(0);
-}
-
-// Simple args: npx create-vista-app@latest <project-name>
-const args = process.argv.slice(2).filter((arg) => !arg.startsWith('-'));
-const projectName = args[0] || 'my-vista-app';
-const useLocal = process.argv.includes('--local');
-const currentDir = process.cwd();
-const projectDir = path.join(currentDir, projectName);
+const pkgManager = detectPackageManager();
+const rawArgs = process.argv.slice(2);
+const useTypedApiStarter = rawArgs.includes('--typed-api') || rawArgs.includes('--typed');
+const skipInstall = rawArgs.includes('--skip-install');
+const skipGit = rawArgs.includes('--no-git');
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`
+Usage:
+  ${usageCommand} [--typed-api] [--skip-install] [--no-git]
+
+Example:
+  npx create-vista-app@latest my-vista-app
+  npx create-vista-app@latest my-vista-app --typed-api
+`);
+  process.exit(0);
+}
+
+// Simple args: npx create-vista-app@latest <project-name>
+const args = rawArgs.filter((arg) => !arg.startsWith('-'));
+const projectName = args[0] || 'my-vista-app';
+const useLocal = rawArgs.includes('--local');
+const currentDir = process.cwd();
+const projectDir = path.join(currentDir, projectName);
 
 console.log(`Creating a new Vista app in ${projectDir}...`);
 
@@ -61,9 +66,15 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
-copyRecursiveSync(templateDir, projectDir);
-
-console.log('Scaffolding complete.');
+copyRecursiveSync(templateDir, projectDir);
+
+if (useTypedApiStarter) {
+  const typedTemplateDir = path.join(__dirname, '../template-typed');
+  copyRecursiveSync(typedTemplateDir, projectDir);
+  console.log('Added typed API starter files.');
+}
+
+console.log('Scaffolding complete.');
 
 // 3. Setup Dependencies (production-ready)
 const packageJson = {
@@ -152,37 +163,45 @@ fs.writeFileSync(path.join(projectDir, '.gitignore'), gitignoreContent);
 console.log('Created .gitignore');
 
 // 5. Initialize Git Repository
-try {
-  execSync('git init', { cwd: projectDir, stdio: 'pipe' });
-  execSync('git add .', { cwd: projectDir, stdio: 'pipe' });
-  execSync('git commit -m "Initial commit from create-vista-app"', {
-    cwd: projectDir,
-    stdio: 'pipe',
-    env: {
-      ...process.env,
-      GIT_AUTHOR_NAME: 'Vista',
-      GIT_AUTHOR_EMAIL: 'vista@example.com',
-      GIT_COMMITTER_NAME: 'Vista',
-      GIT_COMMITTER_EMAIL: 'vista@example.com',
-    },
-  });
-  console.log('Initialized git repository with initial commit');
-} catch (e) {
-  // Git might not be installed, that's okay
-  console.log('Note: Could not initialize git repository. You can do this manually with: git init');
-}
-
-// 6. Install Dependencies
-const installCmd = pkgManager === 'yarn' ? 'yarn' : `${pkgManager} install`;
-console.log(`\nInstalling dependencies with ${pkgManager}... This may take a moment.\n`);
-try {
-  execSync(installCmd, { cwd: projectDir, stdio: 'inherit' });
-  console.log(`\n✓ Dependencies installed successfully!`);
-} catch (e) {
-  console.log(
-    `\nNote: Could not install dependencies automatically. Run "${installCmd}" manually.`
-  );
-}
+if (!skipGit) {
+  try {
+    execSync('git init', { cwd: projectDir, stdio: 'pipe' });
+    execSync('git add .', { cwd: projectDir, stdio: 'pipe' });
+    execSync('git commit -m "Initial commit from create-vista-app"', {
+      cwd: projectDir,
+      stdio: 'pipe',
+      env: {
+        ...process.env,
+        GIT_AUTHOR_NAME: 'Vista',
+        GIT_AUTHOR_EMAIL: 'vista@example.com',
+        GIT_COMMITTER_NAME: 'Vista',
+        GIT_COMMITTER_EMAIL: 'vista@example.com',
+      },
+    });
+    console.log('Initialized git repository with initial commit');
+  } catch (e) {
+    // Git might not be installed, that's okay
+    console.log('Note: Could not initialize git repository. You can do this manually with: git init');
+  }
+} else {
+  console.log('Skipped git initialization (--no-git).');
+}
+
+// 6. Install Dependencies
+const installCmd = pkgManager === 'yarn' ? 'yarn' : `${pkgManager} install`;
+if (!skipInstall) {
+  console.log(`\nInstalling dependencies with ${pkgManager}... This may take a moment.\n`);
+  try {
+    execSync(installCmd, { cwd: projectDir, stdio: 'inherit' });
+    console.log(`\n✓ Dependencies installed successfully!`);
+  } catch (e) {
+    console.log(
+      `\nNote: Could not install dependencies automatically. Run "${installCmd}" manually.`
+    );
+  }
+} else {
+  console.log('\nSkipped dependency installation (--skip-install).');
+}
 
 const runCmd = pkgManager === 'npm' ? 'npm run' : pkgManager;
 const createCmd =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vista-app",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Create Vista applications with one command",
   "bin": {
     "create-vista-app": "./bin/cli.js"
@@ -21,12 +21,13 @@
   ],
   "files": [
     "bin",
-    "template"
+    "template",
+    "template-typed"
   ],
   "dependencies": {
     "fs-extra": "^11.1.1",
-    "prompts": "^2.4.2",
-    "picocolors": "^1.0.0"
+    "picocolors": "^1.0.0",
+    "prompts": "^2.4.2"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",

package/template/README.md

@@ -4,7 +4,7 @@ Built with [Vista.js](https://github.com/vistagen/Vista-Js) — the React framew
 
 ## Getting Started
 
-Run the development server:
+Run the development server:
 
 ```bash
 npm run dev
@@ -12,7 +12,13 @@ npm run dev
 pnpm dev
 ```
 
-Open [http://localhost:3003](http://localhost:3003) in your browser.
+Open [http://localhost:3003](http://localhost:3003) in your browser.
+
+If you want typed API starter files in a fresh app:
+
+```bash
+npx create-vista-app@latest my-vista-app --typed-api
+```
 
 ## Project Structure
 
@@ -39,9 +45,24 @@ vista.config.ts     # Framework configuration
 
 | Command       | Description                       |
 | ------------- | --------------------------------- |
-| `vista dev`   | Start dev server with live-reload |
-| `vista build` | Create production build           |
-| `vista start` | Start production server           |
+| `vista dev`   | Start dev server with live-reload |
+| `vista build` | Create production build           |
+| `vista start` | Start production server           |
+| `vista g api-init` | Generate typed API starter files |
+| `vista g router <name>` | Generate a typed router file |
+| `vista g procedure <name> [get\|post]` | Generate a typed procedure file |
+
+## Typed API Rollback
+
+Typed API is experimental and can be disabled anytime from `vista.config.ts`:
+
+```ts
+experimental: {
+  typedApi: {
+    enabled: false
+  }
+}
+```
 
 ## Learn More
 

package/template-typed/app/api/procedures/hello.ts

@@ -0,0 +1,7 @@
+import type { VStackInstance } from 'vista/stack';
+
+export function helloProcedure(v: VStackInstance<any, any>) {
+    return v.procedure.query(() => ({
+        message: 'Hello from Vista Typed API',
+    }));
+}

package/template-typed/app/api/routers/index.ts

@@ -0,0 +1,8 @@
+import type { VStackInstance } from 'vista/stack';
+import { helloProcedure } from '../procedures/hello';
+
+export function createRootRouter(v: VStackInstance<any, any>) {
+    return v.router({
+        hello: helloProcedure(v),
+    });
+}

package/template-typed/app/api/typed.ts

@@ -0,0 +1,6 @@
+import { vstack } from 'vista/stack';
+import { createRootRouter } from './routers';
+
+const v = vstack.init();
+
+export const router = createRootRouter(v);

package/template-typed/vista.config.ts

@@ -0,0 +1,17 @@
+const config = {
+    images: {
+        domains: ['example.com'],
+    },
+    experimental: {
+        typedApi: {
+            enabled: true,
+            serialization: 'json',
+        },
+    },
+    // Optional: override server port
+    // server: {
+    //     port: 3000
+    // }
+};
+
+export default config;