create-v0-sdk-app 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -1,18 +1,18 @@
 # create-v0-sdk-app
 
-Create v0 SDK-powered apps with one command.
+Create [v0 SDK](https://v0-sdk.dev)-powered apps with one command.
 
 ## Usage
 
 ```bash
-npx create-v0-sdk-app my-app
+pnpm create v0-sdk-app my-app
 ```
 
 Or with other package managers:
 
 ```bash
-# With pnpm
-pnpm create v0-sdk-app my-app
+# With npm
+npx create-v0-sdk-app my-app
 
 # With yarn
 yarn create v0-sdk-app my-app
@@ -24,44 +24,44 @@ 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-npm` - Use npm as the package manager
-- `--use-pnpm` - Use pnpm as the package manager
 - `--use-yarn` - Use Yarn as the package manager
 - `--use-bun` - Use Bun as the package manager
 - `--skip-install` - Skip installing dependencies
 
 ## Available Examples
 
-### ai-tools-example
+### v0-clone (Recommended)
 
-Node.js example using `@v0-sdk/ai-tools` with AI SDK. Perfect for building AI-powered command-line tools and scripts.
+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.
 
 ```bash
-npx create-v0-sdk-app my-ai-app --example ai-tools-example
+pnpm create v0-sdk-app my-app --example v0-clone
 ```
 
 ### classic-v0
 
-Full-featured Next.js app similar to v0.dev with project management, chat interface, and code generation capabilities.
+Full-featured Next.js app similar to the original v0.dev with project management, chat interface, and code generation capabilities.
 
 ```bash
-npx create-v0-sdk-app my-classic-app --example classic-v0
+pnpm create v0-sdk-app my-classic-app --example classic-v0
 ```
 
-### v0-clone
+### v0-sdk-react-example
 
-Next.js app that replicates the v0.dev interface with modern React components and AI chat functionality.
+Next.js example using `@v0-sdk/react` components with different UI themes (minimal, elegant, neobrutalism, terminal).
 
 ```bash
-npx create-v0-sdk-app my-clone-app --example v0-clone
+pnpm create v0-sdk-app my-react-app --example v0-sdk-react-example
 ```
 
-### v0-sdk-react-example
+### ai-tools-example
 
-Next.js example using `@v0-sdk/react` components with different UI themes (minimal, elegant, neobrutalism, terminal).
+Node.js example using `@v0-sdk/ai-tools` with AI SDK. Perfect for building AI-powered command-line tools and scripts.
 
 ```bash
-npx create-v0-sdk-app my-react-app --example v0-sdk-react-example
+pnpm create v0-sdk-app my-ai-app --example ai-tools-example
 ```
 
 ## Interactive Mode
@@ -69,12 +69,12 @@ npx create-v0-sdk-app my-react-app --example v0-sdk-react-example
 If you don't specify an example, the CLI will prompt you to choose one:
 
 ```bash
-npx create-v0-sdk-app my-app
+pnpm create v0-sdk-app my-app
 # ? Which example would you like to use? (Use arrow keys)
-# ❯ ai-tools-example - Node.js example using @v0-sdk/ai-tools with AI SDK
-#   classic-v0 - Full-featured Next.js app similar to v0.dev
-#   v0-clone - Next.js app that replicates the v0.dev interface
+# ❯ 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
 ```
 
 ## What's Included
@@ -104,4 +104,4 @@ pnpm dev --help
 
 ## License
 
-MIT
+Apache 2.0

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;AAK/D,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,YAAY,GACZ,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,CAwHhB"}
+{"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,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"}

package/dist/create-app.js

@@ -8,6 +8,7 @@ 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)) {
@@ -15,26 +16,28 @@ async function createApp({ appPath, packageManager, example, skipInstall, }) {
     }
     console.log(`Creating a new v0 SDK app in ${(0, picocolors_1.green)(appPath)}.`);
     console.log();
-    // Find the examples directory relative to this package
-    const packageRoot = (0, node_path_1.resolve)(__dirname, '..');
-    const monorepoRoot = (0, node_path_1.resolve)(packageRoot, '../..');
-    const examplesDir = (0, node_path_1.join)(monorepoRoot, 'examples');
-    const examplePath = (0, node_path_1.join)(examplesDir, example);
-    if (!(0, node_fs_1.existsSync)(examplePath)) {
-        console.error(`Example ${(0, picocolors_1.red)(example)} does not exist.`);
+    // 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.`);
+    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',
+            });
+        }
+    }
+    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.`);
         process.exit(1);
     }
-    // Copy the example to the target directory
-    await (0, copy_1.copy)(['**'], appPath, {
-        cwd: examplePath,
-        rename: (name) => {
-            // Rename gitignore template to .gitignore
-            if (name === 'gitignore') {
-                return '.gitignore';
-            }
-            return name;
-        },
-    });
     // 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)) {
@@ -55,9 +58,8 @@ async function createApp({ appPath, packageManager, example, skipInstall, }) {
                         deps[name] = packageVersions[name];
                     }
                     else {
-                        // Fallback to monorepo version
-                        const rootPackageJson = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(monorepoRoot, 'package.json'), 'utf8'));
-                        deps[name] = `^${rootPackageJson.version}`;
+                        // Fallback to latest version
+                        deps[name] = 'latest';
                     }
                 }
             }

package/dist/helpers/download.d.ts

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,94 @@
+"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/index.js

@@ -29,21 +29,21 @@ const onPromptState = (state) => {
 };
 const examples = [
     {
-        name: 'ai-tools-example',
-        description: 'Node.js example using @v0-sdk/ai-tools with AI SDK + AI Gateway',
+        name: 'v0-clone',
+        description: 'Next.js app that replicates the v0.dev interface (Recommended)',
     },
     {
         name: 'classic-v0',
         description: 'Full-featured Next.js app similar to the original v0.dev released in 2023',
     },
-    {
-        name: 'v0-clone',
-        description: 'Next.js app that replicates the v0.dev interface',
-    },
     {
         name: 'v0-sdk-react-example',
         description: 'Next.js example using @v0-sdk/react components',
     },
+    {
+        name: 'ai-tools-example',
+        description: 'Node.js example using @v0-sdk/ai-tools with AI SDK + AI Gateway',
+    },
 ];
 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.')
@@ -55,8 +55,8 @@ const program = new commander_1.Command(package_json_1.default.name)
   An example to bootstrap the app with. Available examples:
   ${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.')
-    .option('--use-pnpm', 'Explicitly tell the CLI to bootstrap the application using pnpm.')
     .option('--use-yarn', 'Explicitly tell the CLI to bootstrap the application using Yarn.')
     .option('--use-bun', 'Explicitly tell the CLI to bootstrap the application using Bun.')
     .option('--skip-install', 'Explicitly tell the CLI to skip installing packages.')
@@ -68,10 +68,10 @@ const program = new commander_1.Command(package_json_1.default.name)
     .allowUnknownOption()
     .parse(process.argv);
 const opts = program.opts();
-const packageManager = !!opts.useNpm
-    ? 'npm'
-    : !!opts.usePnpm
-        ? 'pnpm'
+const packageManager = !!opts.usePnpm
+    ? 'pnpm'
+    : !!opts.useNpm
+        ? 'npm'
         : !!opts.useYarn
             ? 'yarn'
             : !!opts.useBun

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-v0-sdk-app",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "keywords": [
     "v0",
     "v0-sdk",
@@ -15,25 +15,21 @@
     "directory": "packages/create-v0-sdk-app"
   },
   "author": "Vercel Team <support@vercel.com>",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "bin": {
     "create-v0-sdk-app": "./dist/index.js"
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsc",
-    "type-check": "tsc --noEmit"
-  },
   "dependencies": {
     "commander": "^12.1.0",
     "prompts": "^2.4.2",
     "picocolors": "^1.0.0",
     "cross-spawn": "^7.0.3",
     "fast-glob": "^3.3.1",
-    "validate-npm-package-name": "^5.0.1"
+    "validate-npm-package-name": "^5.0.1",
+    "tar": "^7.4.3"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.0",
@@ -46,5 +42,12 @@
   "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'"
   }
-}
+}