File: web-preview.md | Updated: 11/15/2025
Slash Forward
Docs Cookbook Providers Playground AI ElementsAI ElementsLeft sparkleRight sparkle AI GatewayGateway
Search...⌘KFeedback GitHub Vercel LogoSign in with Vercel
Vibe coding
A composable component for previewing the result of a generated UI, with support for live examples and code display.
The WebPreview component provides a flexible way to showcase the result of a generated UI component, along with its source code. It is designed for documentation and demo purposes, allowing users to interact with live examples and view the underlying implementation.
Preview
Code
Console
AI Elements
shadcn CLI
Manual
npx ai-elements@latest add web-preview
Build a simple v0 clone using the v0 Platform API .
Install the v0-sdk package:
npm
pnpm
yarn
bun
npm i v0-sdk
Add the following component to your frontend:
app/page.tsx
'use client';
import {
WebPreview,
WebPreviewBody,
WebPreviewNavigation,
WebPreviewUrl,
} from '@/components/ai-elements/web-preview';
import { useState } from 'react';
import {
Input,
PromptInputTextarea,
PromptInputSubmit,
} from '@/components/ai-elements/prompt-input';
import { Loader } from '../ai-elements/loader';
const WebPreviewDemo = () => {
const [previewUrl, setPreviewUrl] = useState('');
const [prompt, setPrompt] = useState('');
const [isGenerating, setIsGenerating] = useState(false);
const handleSubmit = async (e: React.FormEvent) => {
e.preventDefault();
if (!prompt.trim()) return;
setPrompt('');
setIsGenerating(true);
try {
const response = await fetch('/api/v0', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ prompt }),
});
const data = await response.json();
setPreviewUrl(data.demo || '/');
console.log('Generation finished:', data);
} catch (error) {
console.error('Generation failed:', error);
} finally {
setIsGenerating(false);
}
};
return (
<div className="max-w-4xl mx-auto p-6 relative size-full rounded-lg border h-[600px]">
<div className="flex flex-col h-full">
<div className="flex-1 mb-4">
{isGenerating ? (
<div className="flex flex-col items-center justify-center h-full">
<Loader />
<p className="mt-4 text-muted-foreground">
Generating app, this may take a few seconds...
</p>
</div>
) : previewUrl ? (
<WebPreview defaultUrl={previewUrl}>
<WebPreviewNavigation>
<WebPreviewUrl />
</WebPreviewNavigation>
<WebPreviewBody src={previewUrl} />
</WebPreview>
) : (
<div className="flex items-center justify-center h-full text-muted-foreground">
Your generated app will appear here
</div>
)}
</div>
<Input
onSubmit={handleSubmit}
className="w-full max-w-2xl mx-auto relative"
>
<PromptInputTextarea
value={prompt}
placeholder="Describe the app you want to build..."
onChange={(e) => setPrompt(e.currentTarget.value)}
className="pr-12 min-h-[60px]"
/>
<PromptInputSubmit
status={isGenerating ? 'streaming' : 'ready'}
disabled={!prompt.trim()}
className="absolute bottom-1 right-1"
/>
</Input>
</div>
</div>
);
};
export default WebPreviewDemo;
Add the following route to your backend:
app/api/v0/route.ts
import { v0 } from 'v0-sdk';
export async function POST(req: Request) {
const { prompt }: { prompt: string } = await req.json();
const result = await v0.chats.create({
system: 'You are an expert coder',
message: prompt,
modelConfiguration: {
modelId: 'v0-1.5-sm',
imageGenerations: false,
thinking: false,
},
});
return Response.json({
demo: result.demo,
webUrl: result.webUrl,
});
}
<WebPreview />Prop
Type
defaultUrl?string
onUrlChange?(url: string) => void
...props?React.HTMLAttributes<HTMLDivElement>
<WebPreviewNavigation />Prop
Type
...props?React.HTMLAttributes<HTMLDivElement>
<WebPreviewNavigationButton />Prop
Type
tooltip?string
...props?React.ComponentProps<typeof Button>
<WebPreviewUrl />Prop
Type
...props?React.ComponentProps<typeof Input>
<WebPreviewBody />Prop
Type
loading?React.ReactNode
...props?React.IframeHTMLAttributes<HTMLIFrameElement>
<WebPreviewConsole />Prop
Type
logs?Array<{ level: "log" | "warn" | "error"; message: string; timestamp: Date }>
...props?React.HTMLAttributes<HTMLDivElement>
Artifact
A container component for displaying generated content like code, documents, or other outputs with built-in actions.
Open In Chat
A dropdown menu for opening queries in various AI chat platforms including ChatGPT, Claude, T3, Scira, and v0.
On this page
Installation
Usage with AI SDK
Features
Props
<WebPreview />
<WebPreviewNavigation />
<WebPreviewNavigationButton />
<WebPreviewUrl />
<WebPreviewBody />
<WebPreviewConsole />
GitHubEdit this page on GitHub Scroll to topCopy pageOpen in chat