Projects

Projects in v0 provide a way to organize your work by grouping multiple chats into a single, cohesive unit. This allows you to apply custom instructions and settings across all chats within the project, streamlining your workflow.

Creating a project

To create a new project, follow these steps:

1. From the v0 sidebar, click on the project menu option.
2. Select "New Project" and provide a name for your project.

You can now start new chats directly within this project.

Adding an existing chat to a project

If you have an existing chat that you'd like to add to a project, you can do so using the breadcrumbs at the top of the chat window.

1. Open the chat you want to add to a project.
2. Click on the breadcrumb navigation at the top of the page.
3. Select the project you want to move the chat to.

Project settings

Each project has its own set of settings that allow you to customize its behavior and provide context for the AI. To access these settings, navigate to your project page and click on the settings icon. This is the central place to manage project-specific configurations that apply to all chats within it.

Overview

The overview tab provides a high-level summary of your project. Here, you can see the project's name, its connection status with your Vercel account, and whether it's linked to a GitHub repository. This is the main dashboard for your project's state, allowing you to quickly connect or disconnect services.

Integrations

Connect your project to various third-party services to give your AI assistant access to external data and functionality. Available integrations include databases like Upstash for Redis and Neon for Serverless Postgres, backend services like Supabase, and AI model providers. This allows the AI to interact with these services directly, for example, to query a database or use a specific AI model for a task.

Environment variables

Securely store sensitive information like API keys, tokens, and other credentials. These variables are encrypted and made available to the AI within the project's scope, so you don't have to expose them directly in your prompts. You can manage your variables from this tab, adding or removing them as needed.

Knowledge

The Knowledge section allows you to provide durable, project-level context to the AI. This is a powerful feature for tailoring the AI's responses to your specific needs.

• Project Instructions: Use the text area to write detailed instructions, guidelines, or personas for the AI to follow across all chats in the project. For example, you could specify "This project uses Next.js with the App Router and Tailwind CSS."

• Sources: You can upload files (like source code, design documents, or API specifications) that the AI can reference when generating responses. This ensures the AI's output is tailored to your project's specific codebase and requirements.

Project Errors

• Syntax Errors: Appear when there's invalid JavaScript/TypeScript syntax. Example: Missing closing brackets, semicolons, or quotes. The UI also has a fix with v0 button where it displays the preview.
• Import Errors: Occur when imports are incorrect or missing. Example: Error: Cannot find module '@/components/ui/button'. Solution: Ensure the path is correct and the component exists.
• Runtime Errors: Happen during code execution. Often appear in the browser console or terminal. Example: TypeError: Cannot read property 'x' of undefined.

Community

If you've built something you're proud of, you can opt-in to publish your project to the v0 Community. Once submitted and approved, it will be showcased in the gallery for other users to see and learn from. This is a great way to share your creations and get feedback from the community.