{"id":29664871,"url":"https://github.com/vercel/v0-sdk","last_synced_at":"2026-03-06T23:03:58.359Z","repository":{"id":305064885,"uuid":"1021079402","full_name":"vercel/v0-sdk","owner":"vercel","description":"SDK for the v0 Platform API","archived":false,"fork":false,"pushed_at":"2026-01-17T02:35:38.000Z","size":1394,"stargazers_count":417,"open_issues_count":26,"forks_count":74,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-17T14:41:01.121Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://v0-sdk.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vercel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-16T21:08:27.000Z","updated_at":"2026-01-16T16:51:49.000Z","dependencies_parsed_at":"2025-07-18T06:33:39.182Z","dependency_job_id":"62477a1f-9940-41f4-bae4-3adf9456186b","html_url":"https://github.com/vercel/v0-sdk","commit_stats":null,"previous_names":["vercel/v0-sdk"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/vercel/v0-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vercel%2Fv0-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vercel%2Fv0-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vercel%2Fv0-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vercel%2Fv0-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vercel","download_url":"https://codeload.github.com/vercel/v0-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vercel%2Fv0-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28618858,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T23:49:58.628Z","status":"ssl_error","status_checked_at":"2026-01-20T23:47:29.996Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-22T13:07:07.371Z","updated_at":"2026-01-21T00:01:18.432Z","avatar_url":"https://github.com/vercel.png","language":"TypeScript","funding_links":[],"categories":["HarmonyOS","TypeScript"],"sub_categories":["Windows Manager"],"readme":"# v0 SDK Monorepo\n\n\u003e **⚠️ Developer Preview**: This SDK is currently in beta and is subject to change. Use in production at your own risk.\n\nA monorepo containing SDKs for interacting with the v0 Platform API to create and manage AI-powered chat conversations, projects, integrations, and more.\n\n## Packages\n\n- [`v0-sdk`](./packages/v0-sdk) - TypeScript SDK for the v0 Platform API\n- [`@v0-sdk/react`](./packages/react) - React components for rendering v0 Platform API content\n- [`@v0-sdk/ai-tools`](./packages/ai-tools) - AI SDK tools for the v0 Platform API\n- [`create-v0-sdk-app`](./packages/create-v0-sdk-app) - Create v0 SDK-powered apps with one command\n\n## Examples\n\n- [`v0-clone`](./examples/v0-clone) ([Demo](https://clone-demo.v0-sdk.dev)) - Full-featured v0 clone with authentication, database, and AI Elements\n- [`simple-v0`](./examples/simple-v0) ([Demo](https://simple-demo.v0-sdk.dev)) - The simplest way to use v0. Just prompt and see your app generated instantly\n- [`classic-v0`](./examples/classic-v0) - Classic v0 interface clone with clean, minimalist design\n- [`v0-sdk-react-example`](./examples/v0-sdk-react-example) - Next.js example demonstrating @v0-sdk/react usage with multiple UI themes\n- [`ai-tools-example`](./examples/ai-tools-example) - Demonstrates @v0-sdk/ai-tools integration with AI SDK for advanced agent patterns\n\n## Quick Start\n\n### Option 1: Create a New App (Recommended)\n\nThe fastest way to get started is with `create-v0-sdk-app`:\n\n```bash\npnpm create v0-sdk-app@latest my-v0-app\n# or\nnpx create-v0-sdk-app@latest my-v0-app\ncd my-v0-app\n```\n\nThis will create a new project with everything set up and ready to go.\n\n### Option 2: Manual Installation\n\n```bash\npnpm add v0-sdk\n# or\nnpm install v0-sdk\n# or\nyarn add v0-sdk\n```\n\n### Usage\n\nGet your API key from [v0.dev/chat/settings/keys](https://v0.dev/chat/settings/keys).\n\nSet `V0_API_KEY` environment variable.\n\n```typescript\nimport { v0 } from 'v0-sdk'\n\n// Create a new chat\nconst chat = await v0.chats.create({\n  message: 'Create a responsive navbar with Tailwind CSS',\n  system: 'You are an expert React developer',\n})\nconsole.log(`Chat created: ${chat.webUrl}`)\n```\n\n## Development\n\nThis monorepo uses [Turborepo](https://turbo.build/) for build orchestration and [pnpm](https://pnpm.io/) for package management.\n\n### Prerequisites\n\n- Node.js 22+\n- pnpm 9+\n\n### Setup\n\n```bash\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm build\n\n# Run tests for all packages\npnpm test\n\n# Type check all packages\npnpm type-check\n\n# Format code\npnpm format\n```\n\n### Working with packages\n\n```bash\n# Run commands in specific package\npnpm --filter v0-sdk build\npnpm --filter v0-sdk test\npnpm --filter v0-sdk generate\n\n# Run commands in all packages\npnpm build\npnpm test\n```\n\n### Adding new packages\n\n1. Create a new directory in `packages/`\n2. Add a `package.json` with the appropriate `@v0-sdk/` scope\n3. Update the root `tsconfig.json` paths if needed\n4. Add any necessary scripts to `turbo.json`\n\n## Scripts\n\n- `pnpm build` - Build all packages\n- `pnpm test` - Run tests for all packages (CI mode)\n- `pnpm test:watch` - Run tests in watch mode\n- `pnpm type-check` - Type check all packages\n- `pnpm lint` - Lint all packages\n- `pnpm format` - Format code across all packages\n- `pnpm sdk:generate` - Generate SDK from OpenAPI spec\n\n### Code Quality\n\nThe project includes automated code quality checks:\n\n- **Pre-commit hooks**: Automatically format code before commits using Husky and lint-staged\n- **CI formatting check**: Ensures all code is properly formatted in pull requests\n\n### Release Management\n\nThis project uses [Changesets](https://github.com/changesets/changesets) for automated version management and publishing. See [CONTRIBUTING.md](./CONTRIBUTING.md#release-process) for detailed release guidelines.\n\n- `pnpm changeset` - Create a new changeset (describes changes for release)\n- Releases are automated via GitHub Actions when changesets are merged to main\n\n### CI/CD\n\nThe project includes GitHub Actions workflows:\n\n- **CI Pipeline** (`ci.yml`): Runs on every push and PR to main\n  - Builds all packages\n  - Runs linting, formatting, and type checking\n  - Runs tests on Node.js 20 and 22\n\n- **Release Pipeline** (`release.yml`): Automated releases\n  - Creates \"Version Packages\" PRs when changesets are added\n  - Publishes packages to npm when version PRs are merged\n\n- **Changeset Verification** (`verify-changesets.yml`):\n  - Ensures package changes include appropriate changesets\n  - Validates changeset format\n\n- **SDK Generation** (`generate-sdk.yml`):\n  - Runs daily to check for OpenAPI spec updates\n  - Can be triggered manually\n  - Creates PRs when the SDK needs updates\n\n## Resources\n\n- [v0 Documentation](https://v0.dev/docs)\n- [API Terms](https://vercel.com/legal/api-terms)\n- [Turborepo Documentation](https://turbo.build/repo/docs)\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvercel%2Fv0-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvercel%2Fv0-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvercel%2Fv0-sdk/lists"}