create-v0-sdk-app 0.2.1 → 3.0.0-canary.4360778

package/README.md

@@ -1,6 +1,6 @@
 # create-v0-sdk-app
 
-Create [v0 SDK](https://v0-sdk.dev)-powered apps with one command.
+Create [v0 Platform API v2](https://v0.app/docs/api/v2) SDK apps with one command.
 
 ## Usage
 
@@ -24,7 +24,7 @@ bun create v0-sdk-app my-app
 ## Options
 
 - `--example <example-name>` - Specify which example to use
-- `--use-pnpm` - Use pnpm as the package manager (recommended)
+- `--use-pnpm` - Use pnpm as the package manager
 - `--use-npm` - Use npm as the package manager
 - `--use-yarn` - Use Yarn as the package manager
 - `--use-bun` - Use Bun as the package manager
@@ -32,49 +32,31 @@ bun create v0-sdk-app my-app
 
 ## Available Examples
 
-### v0-clone (Recommended)
+### simple-v0 (Recommended)
 
-Next.js app that replicates the v0.dev interface with modern React components and AI chat functionality. This is the recommended starting point for most projects.
+Next.js app that uses the v2 SDK to generate, preview, manage, and deploy v0 chats.
 
 ```bash
-pnpm create v0-sdk-app my-app --example v0-clone
+pnpm create v0-sdk-app my-app --example simple-v0
 ```
 
-### classic-v0
+### basic
 
-Full-featured Next.js app similar to the original v0.dev with project management, chat interface, and code generation capabilities.
+Minimal TypeScript scripts for creating v2 chats with synchronous and streaming SDK calls.
 
 ```bash
-pnpm create v0-sdk-app my-classic-app --example classic-v0
-```
-
-### v0-sdk-react-example
-
-Next.js example using `@v0-sdk/react` components with different UI themes (minimal, elegant, neobrutalism, terminal).
-
-```bash
-pnpm create v0-sdk-app my-react-app --example v0-sdk-react-example
-```
-
-### ai-tools-example
-
-Node.js example using `@v0-sdk/ai-tools` with AI SDK. Perfect for building AI-powered command-line tools and scripts.
-
-```bash
-pnpm create v0-sdk-app my-ai-app --example ai-tools-example
+pnpm create v0-sdk-app my-basic-app --example basic
 ```
 
 ## Interactive Mode
 
-If you don't specify an example, the CLI will prompt you to choose one:
+If you do not specify an example, the CLI prompts you to choose one:
 
 ```bash
 pnpm create v0-sdk-app my-app
-# ? Which example would you like to use? (Use arrow keys)
-# ❯ v0-clone - Next.js app that replicates the v0.dev interface (Recommended)
-#   classic-v0 - Full-featured Next.js app similar to the original v0.dev
-#   v0-sdk-react-example - Next.js example using @v0-sdk/react components
-#   ai-tools-example - Node.js example using @v0-sdk/ai-tools with AI SDK
+# ? Which example would you like to use?
+# > simple-v0 - Next.js app for generating, previewing, managing, and deploying v0 chats (Recommended)
+#   basic - Minimal TypeScript scripts for sync and streaming v2 chat creation
 ```
 
 ## What's Included
@@ -82,24 +64,20 @@ pnpm create v0-sdk-app my-app
 Each example comes pre-configured with:
 
 - TypeScript support
-- Modern tooling and build setup
+- v0 SDK v2 usage
 - Example code and documentation
-- Proper dependency management
-- Development and production scripts
+- A v0 SDK agent skill at `.agents/skills/v0/SKILL.md`
+- Published package dependencies for use outside this monorepo
 
 ## Development
 
 To work on this package:
 
 ```bash
-# Install dependencies
-pnpm install
-
-# Build the package
-pnpm build
-
-# Test locally
-pnpm dev --help
+bun install
+bun --filter create-v0-sdk-app build
+bun --filter create-v0-sdk-app typecheck
+bun --filter create-v0-sdk-app dev --help
 ```
 
 ## License

package/dist/create-app.d.ts

@@ -1,5 +1,5 @@
-import type { PackageManager } from './helpers/get-pkg-manager';
-export type ExampleType = 'ai-tools-example' | 'classic-v0' | 'simple-v0' | 'v0-clone' | 'v0-sdk-react-example';
+import type { PackageManager } from './helpers/get-pkg-manager.js';
+export type ExampleType = 'basic' | 'simple-v0';
 export declare function createApp({ appPath, packageManager, example, skipInstall, }: {
     appPath: string;
     packageManager: PackageManager;

package/dist/create-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAM/D,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,sBAAsB,CAAA;AAE1B,wBAAsB,SAAS,CAAC,EAC9B,OAAO,EACP,cAAc,EACd,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2HhB"}
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAMlE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAA;AAwC/C,wBAAsB,SAAS,CAAC,EAC9B,OAAO,EACP,cAAc,EACd,OAAO,EACP,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGhB"}

package/dist/create-app.js

@@ -1,47 +1,59 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createApp = createApp;
-const node_path_1 = require("node:path");
-const node_fs_1 = require("node:fs");
-const picocolors_1 = require("picocolors");
-const copy_1 = require("./helpers/copy");
-const install_1 = require("./helpers/install");
-const is_folder_empty_1 = require("./helpers/is-folder-empty");
-const is_online_1 = require("./helpers/is-online");
-const download_1 = require("./helpers/download");
-async function createApp({ appPath, packageManager, example, skipInstall, }) {
-    const appName = (0, node_path_1.basename)(appPath);
-    if ((0, node_fs_1.existsSync)(appPath) && !(0, is_folder_empty_1.isFolderEmpty)(appPath, appName)) {
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
+import degit from 'degit';
+import picocolors from 'picocolors';
+import { install } from './helpers/install.js';
+import { isFolderEmpty } from './helpers/is-folder-empty.js';
+const { cyan, green, red } = picocolors;
+const packageVersions = {
+    v0: 'canary',
+    '@v0-sdk/ai-tools': 'canary',
+};
+const scriptDescriptions = {
+    dev: 'Starts the development server.',
+    sync: 'Runs the synchronous chat creation example.',
+    stream: 'Runs the streaming chat creation example.',
+    build: 'Builds the app for production.',
+    start: 'Runs the built app in production mode.',
+};
+const scriptDisplayOrder = ['dev', 'sync', 'stream', 'build', 'start'];
+const basicScripts = {
+    sync: 'tsx chats/sync.ts',
+    stream: 'tsx chats/stream.ts',
+};
+const basicDevDependencies = {
+    '@types/bun': 'latest',
+    '@types/node': '^22.0.0',
+    tsx: '^4.19.2',
+    typescript: '^6.0.3',
+};
+const lockfiles = ['bun.lock', 'bun.lockb', 'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock'];
+export async function createApp({ appPath, packageManager, example, skipInstall, }) {
+    const appName = basename(appPath);
+    if (existsSync(appPath) && !isFolderEmpty(appPath, appName)) {
         process.exit(1);
     }
-    console.log(`Creating a new v0 SDK app in ${(0, picocolors_1.green)(appPath)}.`);
+    console.log(`Creating a new v0 SDK app in ${green(appPath)}.`);
     console.log();
-    // Download example from GitHub repository
-    const repoUrl = 'https://github.com/vercel/v0-sdk';
-    const examplePath = `examples/${example}`;
-    console.log(`Downloading files from ${(0, picocolors_1.cyan)(repoUrl)}. This might take a moment.`);
+    const template = `vercel/v0-sdk/examples/${example}#v2`;
+    console.log(`Downloading template ${cyan(template)}. This might take a moment.`);
     console.log();
     try {
-        await (0, download_1.downloadAndExtractExample)(repoUrl, examplePath, appPath);
-        // Rename gitignore file if it exists
-        const gitignorePath = (0, node_path_1.join)(appPath, 'gitignore');
-        const dotGitignorePath = (0, node_path_1.join)(appPath, '.gitignore');
-        if ((0, node_fs_1.existsSync)(gitignorePath)) {
-            await (0, copy_1.copy)(['gitignore'], appPath, {
-                cwd: appPath,
-                rename: () => '.gitignore',
-            });
-        }
+        await degit(template, { cache: false, force: true }).clone(appPath);
     }
     catch (error) {
-        console.error(`Failed to download example ${(0, picocolors_1.red)(example)}:`, error);
-        console.error(`Example ${(0, picocolors_1.red)(example)} does not exist or could not be downloaded.`);
+        console.error(`Failed to download example ${red(example)}:`, error);
+        console.error(`Example ${red(example)} does not exist or could not be downloaded.`);
         process.exit(1);
     }
+    installAgentSkill(appPath);
     // Update package.json to use published packages instead of workspace references
-    const packageJsonPath = (0, node_path_1.join)(appPath, 'package.json');
-    if ((0, node_fs_1.existsSync)(packageJsonPath)) {
-        const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf8'));
+    const packageJsonPath = join(appPath, 'package.json');
+    let packageScripts;
+    if (existsSync(packageJsonPath)) {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        updateTemplatePackage(packageJson, example);
         // Replace workspace dependencies with actual versions
         const replaceWorkspaceDeps = (deps) => {
             if (!deps)
@@ -49,11 +61,6 @@ async function createApp({ appPath, packageManager, example, skipInstall, }) {
             for (const [name, version] of Object.entries(deps)) {
                 if (version === 'workspace:*') {
                     // Map workspace packages to their published versions
-                    const packageVersions = {
-                        'v0-sdk': '^0.11.0',
-                        '@v0-sdk/react': '^0.3.0',
-                        '@v0-sdk/ai-tools': '^0.1.0',
-                    };
                     if (packageVersions[name]) {
                         deps[name] = packageVersions[name];
                     }
@@ -68,36 +75,68 @@ async function createApp({ appPath, packageManager, example, skipInstall, }) {
         replaceWorkspaceDeps(packageJson.devDependencies);
         // Update the package name to match the app name
         packageJson.name = appName;
-        (0, node_fs_1.writeFileSync)(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+        packageScripts = packageJson.scripts;
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+        removeLockfiles(appPath);
     }
     process.chdir(appPath);
     if (!skipInstall) {
         console.log('Installing packages. This might take a couple of minutes.');
         console.log();
-        const isOnline = await (0, is_online_1.getOnline)();
-        await (0, install_1.install)(packageManager, isOnline);
+        await install(packageManager);
         console.log();
     }
-    console.log(`${(0, picocolors_1.green)('Success!')} Created ${appName} at ${appPath}`);
-    console.log('Inside that directory, you can run several commands:');
-    console.log();
-    console.log((0, picocolors_1.cyan)(`  ${packageManager} ${packageManager === 'npm' ? 'run ' : ''}dev`));
-    console.log('    Starts the development server.');
-    console.log();
-    console.log((0, picocolors_1.cyan)(`  ${packageManager} ${packageManager === 'npm' ? 'run ' : ''}build`));
-    console.log('    Builds the app for production.');
-    console.log();
-    if (example !== 'ai-tools-example') {
-        console.log((0, picocolors_1.cyan)(`  ${packageManager} ${packageManager === 'npm' ? 'run ' : ''}start`));
-        console.log('    Runs the built app in production mode.');
+    console.log(`${green('Success!')} Created ${appName} at ${appPath}`);
+    const availableScripts = scriptDisplayOrder.filter((script) => packageScripts?.[script]);
+    if (availableScripts.length > 0) {
+        console.log('Inside that directory, you can run several commands:');
         console.log();
+        for (const script of availableScripts) {
+            console.log(cyan(`  ${getRunCommand(packageManager, script)}`));
+            console.log(`    ${scriptDescriptions[script]}`);
+            console.log();
+        }
     }
     console.log('We suggest that you begin by typing:');
     console.log();
-    console.log((0, picocolors_1.cyan)('  cd'), appName);
+    console.log(cyan('  cd'), appName);
     if (skipInstall) {
-        console.log((0, picocolors_1.cyan)(`  ${packageManager} install`));
+        console.log(cyan(`  ${packageManager} install`));
+    }
+    const firstScript = availableScripts[0];
+    if (firstScript) {
+        console.log(cyan(`  ${getRunCommand(packageManager, firstScript)}`));
     }
-    console.log((0, picocolors_1.cyan)(`  ${packageManager} ${packageManager === 'npm' ? 'run ' : ''}dev`));
     console.log();
 }
+function getRunCommand(packageManager, script) {
+    return `${packageManager} ${packageManager === 'npm' ? 'run ' : ''}${script}`;
+}
+function updateTemplatePackage(packageJson, example) {
+    if (example !== 'basic')
+        return;
+    packageJson.scripts = {
+        ...basicScripts,
+        ...packageJson.scripts,
+    };
+    packageJson.devDependencies = {
+        ...packageJson.devDependencies,
+        ...basicDevDependencies,
+    };
+    delete packageJson.module;
+    delete packageJson.peerDependencies;
+}
+function installAgentSkill(appPath) {
+    const source = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates', 'v0', 'SKILL.md');
+    const destination = join(appPath, '.agents', 'skills', 'v0', 'SKILL.md');
+    mkdirSync(dirname(destination), { recursive: true });
+    copyFileSync(source, destination);
+}
+function removeLockfiles(appPath) {
+    for (const lockfile of lockfiles) {
+        const lockfilePath = join(appPath, lockfile);
+        if (existsSync(lockfilePath)) {
+            unlinkSync(lockfilePath);
+        }
+    }
+}

package/dist/helpers/get-pkg-manager.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPkgManager = getPkgManager;
-const node_child_process_1 = require("node:child_process");
-function getPkgManager() {
+import { execSync } from 'node:child_process';
+export function getPkgManager() {
     const userAgent = process.env.npm_config_user_agent;
     if (userAgent) {
         if (userAgent.startsWith('yarn')) {
@@ -16,17 +13,17 @@ function getPkgManager() {
         }
     }
     try {
-        (0, node_child_process_1.execSync)('pnpm --version', { stdio: 'ignore' });
+        execSync('pnpm --version', { stdio: 'ignore' });
         return 'pnpm';
     }
     catch {
         try {
-            (0, node_child_process_1.execSync)('yarn --version', { stdio: 'ignore' });
+            execSync('yarn --version', { stdio: 'ignore' });
             return 'yarn';
         }
         catch {
             try {
-                (0, node_child_process_1.execSync)('bun --version', { stdio: 'ignore' });
+                execSync('bun --version', { stdio: 'ignore' });
                 return 'bun';
             }
             catch {

package/dist/helpers/install.d.ts

@@ -1,4 +1,4 @@
-import type { PackageManager } from './get-pkg-manager';
+import type { PackageManager } from './get-pkg-manager.js';
 /**
  * Spawn a package manager installation based on user preference.
  *
@@ -6,7 +6,5 @@ import type { PackageManager } from './get-pkg-manager';
  */
 export declare function install(
 /** Indicate which package manager to use. */
-packageManager: PackageManager, 
-/** Indicate whether there is an active Internet connection.*/
-isOnline: boolean): Promise<void>;
+packageManager: PackageManager): Promise<void>;
 //# sourceMappingURL=install.d.ts.map

package/dist/helpers/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/helpers/install.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;;;GAIG;AACH,wBAAsB,OAAO;AAC3B,6CAA6C;AAC7C,cAAc,EAAE,cAAc;AAC9B,8DAA8D;AAC9D,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/helpers/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,wBAAsB,OAAO;AAC3B,6CAA6C;AAC7C,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/helpers/install.js

@@ -1,26 +1,13 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.install = install;
-const picocolors_1 = require("picocolors");
-const cross_spawn_1 = __importDefault(require("cross-spawn"));
+import spawn from 'cross-spawn';
 /**
  * Spawn a package manager installation based on user preference.
  *
  * @returns A Promise that resolves once the installation is finished.
  */
-async function install(
+export async function install(
 /** Indicate which package manager to use. */
-packageManager, 
-/** Indicate whether there is an active Internet connection.*/
-isOnline) {
+packageManager) {
     const args = ['install'];
-    if (!isOnline) {
-        console.log((0, picocolors_1.yellow)('You appear to be offline.\nFalling back to the local cache.'));
-        args.push('--offline');
-    }
     /**
      * Return a Promise that resolves once the installation is finished.
      */
@@ -28,7 +15,7 @@ isOnline) {
         /**
          * Spawn the installation process.
          */
-        const child = (0, cross_spawn_1.default)(packageManager, args, {
+        const child = spawn(packageManager, args, {
             stdio: 'inherit',
             env: {
                 ...process.env,

package/dist/helpers/is-folder-empty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-folder-empty.d.ts","sourceRoot":"","sources":["../../src/helpers/is-folder-empty.ts"],"names":[],"mappings":"AAoBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyCjE"}
+{"version":3,"file":"is-folder-empty.d.ts","sourceRoot":"","sources":["../../src/helpers/is-folder-empty.ts"],"names":[],"mappings":"AAuBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAgCjE"}

package/dist/helpers/is-folder-empty.js

@@ -1,15 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFolderEmpty = isFolderEmpty;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const picocolors_1 = require("picocolors");
+import { readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import picocolors from 'picocolors';
+const { red } = picocolors;
 const VALID_FILES = [
     '.DS_Store',
     '.git',
     '.gitattributes',
     '.gitignore',
     '.gitlab-ci.yml',
+    '.idea',
     '.hg',
     '.hgcheck',
     '.hgignore',
@@ -19,23 +18,21 @@ const VALID_FILES = [
     'mkdocs.yml',
     'Thumbs.db',
 ];
-function isFolderEmpty(root, name) {
+export function isFolderEmpty(root, name) {
     const validFiles = VALID_FILES;
     let conflicts = [];
     try {
-        conflicts = (0, node_fs_1.readdirSync)(root).filter((file) => !validFiles.includes(file) &&
-            // Support IntelliJ IDEA-based editors
-            !file.startsWith('.idea'));
+        conflicts = readdirSync(root).filter((file) => !validFiles.includes(file));
     }
     catch {
         return true;
     }
     if (conflicts.length > 0) {
-        console.log(`The directory ${(0, picocolors_1.red)(name)} contains files that could conflict:`);
+        console.log(`The directory ${red(name)} contains files that could conflict:`);
         console.log();
         for (const file of conflicts) {
             try {
-                const stats = (0, node_fs_1.readdirSync)((0, node_path_1.resolve)(root, file));
+                const stats = readdirSync(resolve(root, file));
                 if (stats.length > 0) {
                     console.log(`  ${file}/`);
                 }

package/dist/helpers/validate-pkg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-pkg.d.ts","sourceRoot":"","sources":["../../src/helpers/validate-pkg.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAaA"}
+{"version":3,"file":"validate-pkg.d.ts","sourceRoot":"","sources":["../../src/helpers/validate-pkg.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAUA"}

package/dist/helpers/validate-pkg.js

@@ -1,20 +1,11 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateNpmName = validateNpmName;
-const validate_npm_package_name_1 = __importDefault(require("validate-npm-package-name"));
-function validateNpmName(name) {
-    const nameValidation = (0, validate_npm_package_name_1.default)(name);
+import validateNpmPackageName from 'validate-npm-package-name';
+export function validateNpmName(name) {
+    const nameValidation = validateNpmPackageName(name);
     if (nameValidation.validForNewPackages) {
         return { valid: true, problems: [] };
     }
     return {
         valid: false,
-        problems: [
-            ...(nameValidation.errors || []),
-            ...(nameValidation.warnings || []),
-        ],
+        problems: [...(nameValidation.errors || []), ...(nameValidation.warnings || [])],
     };
 }

package/dist/index.js

@@ -1,19 +1,15 @@
 #!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const picocolors_1 = require("picocolors");
-const prompts_1 = __importDefault(require("prompts"));
-const create_app_1 = require("./create-app");
-const get_pkg_manager_1 = require("./helpers/get-pkg-manager");
-const is_folder_empty_1 = require("./helpers/is-folder-empty");
-const validate_pkg_1 = require("./helpers/validate-pkg");
-const package_json_1 = __importDefault(require("../package.json"));
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, resolve } from 'node:path';
+import picocolors from 'picocolors';
+import prompts from 'prompts';
+import { createApp } from './create-app.js';
+import { getPkgManager } from './helpers/get-pkg-manager.js';
+import { isFolderEmpty } from './helpers/is-folder-empty.js';
+import { validateNpmName } from './helpers/validate-pkg.js';
+const { bold, cyan, green, red } = picocolors;
+const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 let projectPath = '';
 const handleSigTerm = () => process.exit(0);
 process.on('SIGINT', handleSigTerm);
@@ -28,36 +24,24 @@ const onPromptState = (state) => {
     }
 };
 const examples = [
-    {
-        name: 'v0-clone',
-        description: 'Next.js app that replicates the v0.dev interface (Recommended)',
-    },
     {
         name: 'simple-v0',
-        description: 'The simplest way to use v0 - just prompt and see your app',
-    },
-    {
-        name: 'classic-v0',
-        description: 'Full-featured Next.js app similar to the original v0.dev released in 2023',
-    },
-    {
-        name: 'v0-sdk-react-example',
-        description: 'Next.js example using @v0-sdk/react components',
+        description: 'Next.js app for generating, previewing, managing, and deploying v0 chats (Recommended)',
     },
     {
-        name: 'ai-tools-example',
-        description: 'Node.js example using @v0-sdk/ai-tools with AI SDK + AI Gateway',
+        name: 'basic',
+        description: 'Minimal TypeScript scripts for sync and streaming v2 chat creation',
     },
 ];
-const program = new commander_1.Command(package_json_1.default.name)
-    .version(package_json_1.default.version, '-v, --version', 'Output the current version of create-v0-sdk-app.')
+const program = new Command(packageJson.name)
+    .version(packageJson.version, '-v, --version', 'Output the current version of create-v0-sdk-app.')
     .argument('[directory]')
     .usage('[directory] [options]')
     .helpOption('-h, --help', 'Display this help message.')
     .option('-e, --example <example-name>', `
   
   An example to bootstrap the app with. Available examples:
-  ${examples.map((ex) => `  • ${ex.name}: ${ex.description}`).join('\n  ')}
+  ${examples.map((ex) => `  - ${ex.name}: ${ex.description}`).join('\n  ')}
 `)
     .option('--use-pnpm', 'Explicitly tell the CLI to bootstrap the application using pnpm (recommended).')
     .option('--use-npm', 'Explicitly tell the CLI to bootstrap the application using npm.')
@@ -72,28 +56,28 @@ const program = new commander_1.Command(package_json_1.default.name)
     .allowUnknownOption()
     .parse(process.argv);
 const opts = program.opts();
-const packageManager = !!opts.usePnpm
+const packageManager = opts.usePnpm
     ? 'pnpm'
-    : !!opts.useNpm
+    : opts.useNpm
         ? 'npm'
-        : !!opts.useYarn
+        : opts.useYarn
             ? 'yarn'
-            : !!opts.useBun
+            : opts.useBun
                 ? 'bun'
-                : (0, get_pkg_manager_1.getPkgManager)();
+                : getPkgManager();
 async function run() {
     if (typeof projectPath === 'string') {
         projectPath = projectPath.trim();
     }
     if (!projectPath) {
-        const res = await (0, prompts_1.default)({
+        const res = await prompts({
             onState: onPromptState,
             type: 'text',
             name: 'path',
             message: 'What is your project named?',
             initial: 'my-v0-app',
             validate: (name) => {
-                const validation = (0, validate_pkg_1.validateNpmName)((0, node_path_1.basename)((0, node_path_1.resolve)(name)));
+                const validation = validateNpmName(basename(resolve(name)));
                 if (validation.valid) {
                     return true;
                 }
@@ -106,26 +90,26 @@ async function run() {
     }
     if (!projectPath) {
         console.log('\nPlease specify the project directory:\n' +
-            `  ${(0, picocolors_1.cyan)(program.name())} ${(0, picocolors_1.green)('<project-directory>')}\n` +
+            `  ${cyan(program.name())} ${green('<project-directory>')}\n` +
             'For example:\n' +
-            `  ${(0, picocolors_1.cyan)(program.name())} ${(0, picocolors_1.green)('my-v0-app')}\n\n` +
-            `Run ${(0, picocolors_1.cyan)(`${program.name()} --help`)} to see all options.`);
+            `  ${cyan(program.name())} ${green('my-v0-app')}\n\n` +
+            `Run ${cyan(`${program.name()} --help`)} to see all options.`);
         process.exit(1);
     }
-    const appPath = (0, node_path_1.resolve)(projectPath);
-    const appName = (0, node_path_1.basename)(appPath);
-    const validation = (0, validate_pkg_1.validateNpmName)(appName);
+    const appPath = resolve(projectPath);
+    const appName = basename(appPath);
+    const validation = validateNpmName(appName);
     if (!validation.valid) {
-        console.error(`Could not create a project called ${(0, picocolors_1.red)(`"${appName}"`)} because of npm naming restrictions:`);
-        validation.problems.forEach((p) => console.error(`    ${(0, picocolors_1.red)((0, picocolors_1.bold)('*'))} ${p}`));
+        console.error(`Could not create a project called ${red(`"${appName}"`)} because of npm naming restrictions:`);
+        validation.problems.forEach((p) => console.error(`    ${red(bold('*'))} ${p}`));
         process.exit(1);
     }
-    if ((0, node_fs_1.existsSync)(appPath) && !(0, is_folder_empty_1.isFolderEmpty)(appPath, appName)) {
+    if (existsSync(appPath) && !isFolderEmpty(appPath, appName)) {
         process.exit(1);
     }
     let example = opts.example;
     if (!example) {
-        const res = await (0, prompts_1.default)({
+        const res = await prompts({
             onState: onPromptState,
             type: 'select',
             name: 'example',
@@ -141,11 +125,11 @@ async function run() {
     }
     if (!example || !examples.some((ex) => ex.name === example)) {
         console.error(`Invalid example "${example}". Available examples are:\n` +
-            examples.map((ex) => `  • ${ex.name}`).join('\n'));
+            examples.map((ex) => `  - ${ex.name}`).join('\n'));
         process.exit(1);
     }
     try {
-        await (0, create_app_1.createApp)({
+        await createApp({
             appPath,
             packageManager,
             example,
@@ -158,16 +142,16 @@ async function run() {
             typeof reason === 'object' &&
             'command' in reason &&
             typeof reason.command === 'string') {
-            console.error(`  ${(0, picocolors_1.cyan)(reason.command)} has failed.`);
+            console.error(`  ${cyan(reason.command)} has failed.`);
         }
         else {
-            console.error((0, picocolors_1.red)('Unexpected error. Please report it as a bug:'), reason);
+            console.error(red('Unexpected error. Please report it as a bug:'), reason);
         }
         process.exit(1);
     }
 }
 run().catch((reason) => {
     console.error('Aborting installation.');
-    console.error((0, picocolors_1.red)('Unexpected error. Please report it as a bug:'), reason);
+    console.error(red('Unexpected error. Please report it as a bug:'), reason);
     process.exit(1);
 });

package/package.json

@@ -1,35 +1,44 @@
 {
   "name": "create-v0-sdk-app",
-  "version": "0.2.1",
+  "version": "3.0.0-canary.4360778",
+  "description": "Create v0 Platform API v2 SDK apps with one command",
   "keywords": [
-    "v0",
-    "v0-sdk",
     "ai",
+    "next.js",
     "react",
-    "next.js"
+    "v0",
+    "v0-sdk"
   ],
-  "description": "Create v0 SDK-powered apps with one command",
+  "license": "Apache-2.0",
+  "author": "Vercel Team <support@vercel.com>",
   "repository": {
     "type": "git",
     "url": "https://github.com/vercel/v0-sdk.git",
     "directory": "packages/create-v0-sdk-app"
   },
-  "author": "Vercel Team <support@vercel.com>",
-  "license": "Apache-2.0",
   "bin": {
     "create-v0-sdk-app": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "templates"
   ],
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "bun run clean && tsc",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'No linting configured for create-v0-sdk-app package'",
+    "prepublishOnly": "bun run build"
+  },
   "dependencies": {
-    "commander": "^12.1.0",
-    "prompts": "^2.4.2",
+    "commander": "^14.0.3",
+    "cross-spawn": "^7.0.6",
+    "degit": "^3.6.1",
     "picocolors": "^1.0.0",
-    "cross-spawn": "^7.0.3",
-    "fast-glob": "^3.3.1",
-    "validate-npm-package-name": "^5.0.1",
-    "tar": "^7.4.3"
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^5.0.1"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.0",
@@ -37,17 +46,10 @@
     "@types/prompts": "^2.4.2",
     "@types/validate-npm-package-name": "^4.0.2",
     "tsx": "^4.19.2",
-    "typescript": "^5.7.3"
+    "typescript": "^6.0.3"
   },
   "engines": {
     "node": ">=22",
     "pnpm": ">=9"
-  },
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsc",
-    "clean": "rm -rf dist *.tsbuildinfo",
-    "type-check": "tsc --noEmit",
-    "lint": "echo 'No linting configured for create-v0-sdk-app package'"
   }
-}
+}

package/templates/v0/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: v0
+description: Build and modify applications that use the v0 TypeScript SDK and Platform API v2.
+---
+
+# v0 TypeScript SDK
+
+Use this guidance when building or modifying applications that use the v0 TypeScript SDK.
+
+## Setup
+
+- Install the SDK from the `v0` package.
+- Import the default client with `import { v0 } from 'v0'` for simple server-side usage.
+- Use `createV0Client` when the application needs custom authentication, a custom base URL, or custom fetch options.
+- Read `V0_API_KEY` on the server. Never expose it to client components or browser code.
+- The v2 API is organized around chats, messages, files, previews, and deployments.
+
+## Create a chat
+
+Use `v0.chats.create({ message })` when the caller can wait for completion. Non-streaming SDK methods return a result containing `data` or `error`:
+
+```ts
+const response = await v0.chats.create({ message })
+if (response.error) throw new Error(response.error.message)
+
+const chat = response.data.chat
+```
+
+Store `chat.id` so later requests can continue the same workspace. Chat metadata can be used for application grouping, customer IDs, or internal routing.
+
+Use `v0.chats.createStream({ message })` for interactive interfaces that show progress.
+
+## Send follow-up messages
+
+- Use `v0.messages.send({ chatId, message })` to continue an existing chat synchronously.
+- Use `v0.messages.sendStream({ chatId, message })` to stream progress for an existing chat.
+- Treat messages as the conversation history and agent trace. Render message `parts` when the UI needs to show thinking, file edits, tool calls, and final text.
+
+## Streaming
+
+The SDK stream result can be returned directly from a server with `result.toResponse()`, or consumed with `for await (const update of result.stream)`.
+
+On the client, use `readV0Stream(response)` when consuming the v0 wire format directly. Prefer streaming for chat-style interfaces so the UI can update while v0 thinks, edits files, and reports usage.
+
+## Show previews
+
+Use `v0.chats.getPreview({ chatId })` after a chat exists. As with other non-streaming methods, check `response.error` and read the preview from `response.data`.
+
+The preview data may be `null` while the VM is starting. Poll until it is available. Preview access uses a short-lived token. If embedding the preview in an iframe, proxy requests through a server route and forward the token as `x-v0-preview-token`. Never send `V0_API_KEY` to the preview URL or browser.
+
+## Documentation
+
+Use the [v0 Platform API v2 documentation](https://v0.app/docs/api/v2) for endpoint details.

package/dist/helpers/copy.d.ts

@@ -1,8 +0,0 @@
-interface CopyOption {
-    cwd?: string;
-    rename?: (basename: string) => string;
-    parents?: boolean;
-}
-export declare const copy: (src: string | string[], dest: string, { cwd, rename, parents }?: CopyOption) => Promise<void[]>;
-export {};
-//# sourceMappingURL=copy.d.ts.map

package/dist/helpers/copy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/helpers/copy.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAID,eAAO,MAAM,IAAI,QACV,MAAM,GAAG,MAAM,EAAE,QAChB,MAAM,6BACgC,UAAU,oBAiCvD,CAAA"}

package/dist/helpers/copy.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.copy = void 0;
-const node_path_1 = require("node:path");
-const promises_1 = require("node:fs/promises");
-const fast_glob_1 = require("fast-glob");
-const identity = (x) => x;
-const copy = async (src, dest, { cwd, rename = identity, parents = true } = {}) => {
-    const source = typeof src === 'string' ? [src] : src;
-    if (source.length === 0 || !dest) {
-        throw new TypeError('`src` and `dest` are required');
-    }
-    const sourceFiles = await (0, fast_glob_1.async)(source, {
-        cwd,
-        dot: true,
-        absolute: false,
-        stats: false,
-    });
-    const destRelativeToCwd = cwd ? (0, node_path_1.resolve)(cwd, dest) : dest;
-    return Promise.all(sourceFiles.map(async (p) => {
-        const dirName = (0, node_path_1.dirname)(p);
-        const baseName = rename((0, node_path_1.basename)(p));
-        const from = cwd ? (0, node_path_1.resolve)(cwd, p) : p;
-        const to = parents
-            ? (0, node_path_1.join)(destRelativeToCwd, dirName, baseName)
-            : (0, node_path_1.join)(destRelativeToCwd, baseName);
-        // Ensure the destination directory exists
-        await (0, promises_1.mkdir)((0, node_path_1.dirname)(to), { recursive: true });
-        return (0, promises_1.copyFile)(from, to);
-    }));
-};
-exports.copy = copy;

package/dist/helpers/download.d.ts

@@ -1,12 +0,0 @@
-export type RepoInfo = {
-    username: string;
-    name: string;
-    branch: string;
-    filePath: string;
-};
-export declare function isUrlOk(url: string): Promise<boolean>;
-export declare function getRepoInfo(url: URL, examplePath?: string): Promise<RepoInfo | undefined>;
-export declare function hasRepo({ username, name, branch, filePath, }: RepoInfo): Promise<boolean>;
-export declare function downloadAndExtractRepo(root: string, { username, name, branch, filePath }: RepoInfo): Promise<void>;
-export declare function downloadAndExtractExample(repoUrl: string, examplePath: string, appPath: string): Promise<void>;
-//# sourceMappingURL=download.d.ts.map

package/dist/helpers/download.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/helpers/download.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,EACR,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAoC/B;AAED,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAK7B;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,GAC7C,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/helpers/download.js

@@ -1,94 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isUrlOk = isUrlOk;
-exports.getRepoInfo = getRepoInfo;
-exports.hasRepo = hasRepo;
-exports.downloadAndExtractRepo = downloadAndExtractRepo;
-exports.downloadAndExtractExample = downloadAndExtractExample;
-const node_stream_1 = require("node:stream");
-const promises_1 = require("node:stream/promises");
-const node_fs_1 = require("node:fs");
-const tar_1 = require("tar");
-async function isUrlOk(url) {
-    try {
-        const res = await fetch(url, { method: 'HEAD' });
-        return res.status === 200;
-    }
-    catch {
-        return false;
-    }
-}
-async function getRepoInfo(url, examplePath) {
-    const [, username, name, t, _branch, ...file] = url.pathname.split('/');
-    const filePath = examplePath ? examplePath.replace(/^\//, '') : file.join('/');
-    if (
-    // Support repos whose entire purpose is to be a Next.js example, e.g.
-    // https://github.com/:username/:my-cool-nextjs-example-repo-name.
-    t === undefined ||
-        // Support GitHub URL that ends with a trailing slash, e.g.
-        // https://github.com/:username/:my-cool-nextjs-example-repo-name/
-        // In this case "t" will be an empty string while the next part "_branch" will be undefined
-        (t === '' && _branch === undefined)) {
-        try {
-            const infoResponse = await fetch(`https://api.github.com/repos/${username}/${name}`);
-            if (infoResponse.status !== 200) {
-                return;
-            }
-            const info = await infoResponse.json();
-            return { username, name, branch: info['default_branch'], filePath };
-        }
-        catch {
-            return;
-        }
-    }
-    // Support GitHub URL that ends with a trailing slash, e.g.
-    // https://github.com/:username/:my-cool-nextjs-example-repo-name/tree/my-cool-branch/
-    // In this case "t" will be "tree" and "_branch" will be the branch name
-    if (t === 'tree' && _branch) {
-        return { username, name, branch: _branch, filePath };
-    }
-    return { username, name, branch: 'main', filePath };
-}
-function hasRepo({ username, name, branch, filePath, }) {
-    const contentsUrl = `https://api.github.com/repos/${username}/${name}/contents`;
-    const packagePath = `${filePath ? `/${filePath}` : ''}/package.json`;
-    return isUrlOk(`${contentsUrl}${packagePath}?ref=${branch}`);
-}
-async function downloadAndExtractRepo(root, { username, name, branch, filePath }) {
-    const tempFile = `https://codeload.github.com/${username}/${name}/tar.gz/${branch}`;
-    // Ensure the target directory exists
-    (0, node_fs_1.mkdirSync)(root, { recursive: true });
-    const response = await fetch(tempFile);
-    if (!response.body) {
-        throw new Error('Failed to fetch repository');
-    }
-    return (0, promises_1.pipeline)(node_stream_1.Readable.fromWeb(response.body), (0, tar_1.x)({
-        cwd: root,
-        strip: filePath ? filePath.split('/').length + 1 : 1,
-        filter: (path) => {
-            const chunks = path.split('/');
-            if (filePath) {
-                const filePathChunks = filePath.split('/');
-                if (chunks.length <= filePathChunks.length ||
-                    filePathChunks.some((chunk, i) => chunks[i + 1] !== chunk)) {
-                    return false;
-                }
-            }
-            const [, ...fileChunks] = chunks;
-            const target = fileChunks.join('/');
-            return !target.startsWith('.git');
-        },
-    }));
-}
-async function downloadAndExtractExample(repoUrl, examplePath, appPath) {
-    const url = new URL(repoUrl);
-    const repoInfo = await getRepoInfo(url, examplePath);
-    if (!repoInfo) {
-        throw new Error(`Could not get repository info for ${repoUrl}`);
-    }
-    const hasExample = await hasRepo(repoInfo);
-    if (!hasExample) {
-        throw new Error(`Example "${examplePath}" not found in repository`);
-    }
-    await downloadAndExtractRepo(appPath, repoInfo);
-}

package/dist/helpers/is-online.d.ts

@@ -1,2 +0,0 @@
-export declare function getOnline(): Promise<boolean>;
-//# sourceMappingURL=is-online.d.ts.map

package/dist/helpers/is-online.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"is-online.d.ts","sourceRoot":"","sources":["../../src/helpers/is-online.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAS5C"}

package/dist/helpers/is-online.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOnline = getOnline;
-const node_child_process_1 = require("node:child_process");
-function getOnline() {
-    return new Promise((resolve) => {
-        try {
-            (0, node_child_process_1.execSync)('ping -c 1 8.8.8.8', { stdio: 'ignore' });
-            resolve(true);
-        }
-        catch {
-            resolve(false);
-        }
-    });
-}