🤔 Why v0 Output Alone Isn't Production-Ready

If you've used v0.dev to spin up a landing page, you've probably hit the same wall on the next step. The component looks clean inside v0, but the moment you drop it into your Next.js project the design tokens drift, dark mode breaks, metadata is empty, and Lighthouse scores land in the 60s. This isn't a v0 limitation — it's that v0's output is "design-mock React," not "a part of your project."

Pushing it to production-ready requires touching six additional areas during integration. Restructuring routes and components for the App Router, aligning with your design system (typically shadcn/ui), filling SEO via the Next.js metadata API, optimizing images, fonts, and bundle size, and wiring analytics plus A/B testing. This guide walks through those six steps as concrete code patterns.

📋 The 6-Step Workflow at a Glance

About 90 minutes total brings a single page to production standard. v0 gets you the output in 1 hour; this 90 minutes makes it ready for real traffic.

🛠 Step 1 — v0 Export and Dependency Analysis

Top-right of v0 → Code → Download gives you a zip. After unzipping you'll see app/page.tsx, components/, and package.json. The first thing to inspect is dependencies in package.json. v0 auto-includes shadcn-compatible packages like lucide-react, class-variance-authority, and tailwind-merge — check if your project already has them. Version mismatches cause conflicts.

# Compare v0 export deps with your project
diff <(jq -r '.dependencies | keys[]' v0-export/package.json | sort) \
     <(jq -r '.dependencies | keys[]' package.json | sort)

Pull only the truly new packages and install them with a single pnpm add. After this step, v0 code compiles inside your project without import errors.

📦 Step 2 — App Router Routes and Component Split

v0 puts Hero, Features, Testimonial, FAQ, and Footer all in one app/page.tsx. For production App Router, split it. Recommended structure:

app/
├── (marketing)/
│   ├── page.tsx              # Route group, separate marketing layout
│   └── layout.tsx
├── layout.tsx
components/
└── landing/
    ├── hero.tsx
    ├── features.tsx
    ├── testimonial.tsx
    ├── faq.tsx
    └── footer.tsx

The (marketing) route group exists so your marketing pages (landing, pricing, about) and app pages (app/dashboard, etc.) carry different layouts. Marketing layout always has header/footer; app layout has sidebar. Splitting v0's monolith component into meaningful pieces under components/landing/ also makes Hero patterns reusable across /pricing, /about, and so on.

🎨 Step 3 — shadcn/ui Alignment and Design Tokens

This is where things break the most. v0 outputs with its own palette (e.g., bg-zinc-900), but your project likely uses shadcn/ui tokens (bg-background, text-foreground, border-border). Leave v0's classes untouched and dark mode toggle won't change anything.

The fix is a bulk substitution from v0 absolute colors to shadcn tokens.

// Mapping examples
// bg-white         → bg-background
// bg-zinc-900      → bg-foreground
// text-black       → text-foreground
// text-zinc-500    → text-muted-foreground
// border-zinc-200  → border-border

Complex mappings sometimes get applied automatically when you pull components via the shadcn-ui CLI add command, but for v0 output direct mapping is faster. Verify CSS variables (--background, --foreground) are defined in globals.css, then test that the dark mode toggle properly inverts colors. Alignment done.

🔍 Step 4 — Metadata API · JSON-LD · OG Image

v0 output ships with empty metadata. Use the Next.js 16 App Router Metadata API to fill SEO basics.

// app/(marketing)/page.tsx
import type { Metadata } from "next";

export const metadata: Metadata = {
  title: "Notely — AI notes that turn meetings into action items",
  description: "Record meetings, get a 30-second summary with action items and follow-up questions. Notely is the AI assistant built for note work.",
  openGraph: {
    title: "Notely — AI notes that auto-organize",
    description: "30-second meeting summaries from voice recording",
    images: ["/og-image.png"],
    type: "website",
  },
  twitter: { card: "summary_large_image" },
  alternates: { canonical: "https://example.com/" },
};

Place a 1200×630 PNG at public/og-image.png, or generate dynamically with app/opengraph-image.tsx using Next.js's ImageResponse. Dynamic generation lets each page produce its own OG image. Add JSON-LD to improve odds of rich snippets in search results.

<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
    __html: JSON.stringify({
      "@context": "https://schema.org",
      "@type": "SoftwareApplication",
      name: "Notely",
      applicationCategory: "ProductivityApplication",
      operatingSystem: "Web",
      offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
    }),
  }}
/>

⚡ Step 5 — Image · Font · Bundle Optimization

LCP (Largest Contentful Paint) and CLS (Cumulative Layout Shift) directly affect Vercel Analytics scores and search ranking. Three fixes typically move you from the 60s into the 90s.

First, swap raw <img> tags for next/image's Image component. Add priority to the Hero image — LCP improves immediately.

Second, self-host fonts via next/font/google. v0 often suggests Inter via external fetch — leaving it that way causes CLS.

// app/layout.tsx
import { Inter } from "next/font/google";

const inter = Inter({ subsets: ["latin"], display: "swap" });

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en" className={inter.className}>
      <body>{children}</body>
    </html>
  );
}

Third, audit bundle size with @next/bundle-analyzer. Drop unused libraries v0 pulled in, and dynamic-import heavy ones like framer-motion.

📊 Step 6 — Analytics and A/B Testing

The final step is operations. Traffic without measurement leaves you guessing the next hypothesis. The best ROI combo is Vercel Analytics + GrowthBook.

// app/layout.tsx
import { Analytics } from "@vercel/analytics/next";
import { SpeedInsights } from "@vercel/speed-insights/next";

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Analytics />
        <SpeedInsights />
      </body>
    </html>
  );
}

@vercel/analytics collects page views and events; @vercel/speed-insights automatically gathers Core Web Vitals. For A/B testing, add the GrowthBook or Statsig SDK and serve 2-3 Hero headline variants randomly — compare click-through rates. For the first 1,000 visitors, just watch page views. Statistical significance starts to mean something past that line.

✅ Integration Completion Checklist

• [ ] pnpm build finishes with zero errors
• [ ] All colors invert properly when dark mode toggles
• [ ] Hero image loads instantly with priority
• [ ] Fonts self-hosted via next/font, CLS under 0.1
• [ ] Metadata, OG image, and JSON-LD all applied
• [ ] Vercel Analytics and Speed Insights collecting data
• [ ] No layout breaks at mobile viewport 375px
• [ ] Lighthouse score in the 90s

Seven or more checked = production-ready. Eight checked = Web Vitals likely sending positive search-ranking signals.

🧩 Four Common Snags and Their Diagnosis

Snag 1 — Some text invisible in dark mode (white text on white). Absolute color classes like text-white left over from v0 output. Replace all absolute colors with shadcn tokens (text-foreground, text-muted-foreground).

Snag 2 — Hero image loads late, LCP over 4 seconds. Raw <img> tag still in place. Switch to next/image's Image component and add priority. If the image is from an external URL, register the domain in next.config.js's images.remotePatterns.

Snag 3 — pnpm build throws "Module not found." v0 imported a library you don't have. Re-run the Step 1 dependency analysis and install missing packages with pnpm add.

Snag 4 — Metadata API doesn't work. v0 output dropped into a Pages Router project. Confirm app/ directory structure first. Either migrate to App Router or use next/head for Pages Router metadata.

⚖️ v0 vs Claude Design vs From-Scratch — When to Pick What

From a developer perspective, "v0 output → Next.js integration" is the most efficient flow — that's the core conclusion of this article.

💡 Three Operational Tips

Tip 1 — Finish one section at a time before exporting. Don't ask v0 to generate the whole page at once. Build Hero → preview → Features → preview, exporting only when each section feels right. Integration friction drops dramatically.

Tip 2 — Bulk-replace Tailwind tokens with a script. v0 output color classes follow a consistent pattern, easy to handle with sed or VS Code regex search. Build the mapping sheet once and the next v0 integration takes 5 minutes.

Tip 3 — Measure Lighthouse scores after production deployment. Local scores differ from Vercel production scores. Always test on the Vercel preview URL after integration completes. If you're under 90, return to Step 5 optimization.

🪜 Where to Go From Here

v0 is a tool for pulling design mocks fast; the real value is in the integration workflow that brings those mocks into your production project. Once you've internalized these six steps, every future landing page, pricing page, and about page becomes a 90-minute job to production standard.

If you're building AI-powered features into your Next.js app, my Lakera Guard integration article covers the safety layer that should sit in front of your AI Route Handlers — same 30-line philosophy, applied to AI security.

Originally published on vibe-start.com. I'm building VibeStart — a 30-minute path for non-developers to start AI-assisted coding. Launching on Product Hunt May 26, 2026.