> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v0 import

> Migrate a v0 app into Superblocks with Clark

Import a v0 app into Superblocks and turn your prototype into a production-ready application connected to your enterprise data, with platform-managed authentication and RBAC.

## Before you begin

Make sure you have:

* A v0 project you want to migrate
* Access to the Superblocks workspace where the app will live
* The integrations (databases, APIs) you plan to connect already configured in Superblocks

## How to import from v0

<Steps>
  <Step title="Start the import">
    From the Superblocks home screen, click **Import** in the prompt bar, or click the **Import an app** link below it.
  </Step>

  <Step title="Select v0 as your source">
    When prompted to choose a platform, select **v0**.
  </Step>

  <Step title="Export your project from v0">
    You have two options:

    * Open your project in v0 and click the **download icon** to save it as a zip, or
    * Push the project to source control from v0, then download the repo as a zip from source control.

    <img src="https://mintcdn.com/superblocks/U5RkhXSSu8k-JEr-/images/import-apps/v0-export.png?fit=max&auto=format&n=U5RkhXSSu8k-JEr-&q=85&s=5c25e4c85f4367d34697c2633509f87d" alt="Superblocks migration Export step for v0: export and package instructions" style={{ width: "100%", maxWidth: "720px" }} width="1998" height="1054" data-path="images/import-apps/v0-export.png" />
  </Step>

  <Step title="Upload the zip">
    Drop the downloaded zip file into the Superblocks upload area and click **Import**.

    <img src="https://mintcdn.com/superblocks/U5RkhXSSu8k-JEr-/images/import-apps/upload-project.png?fit=max&auto=format&n=U5RkhXSSu8k-JEr-&q=85&s=4a69e8878e34f02320c597e930dbd593" alt="Migration Upload step: drag-and-drop zone for .zip, .tgz, or .gz archives with Import app button" style={{ width: "100%", maxWidth: "720px" }} width="1996" height="1052" data-path="images/import-apps/upload-project.png" />
  </Step>

  <Step title="Clark migrates the app">
    Clark inspects your project structure and imports what it can, including:

    * **Code** — your app's source files and logic
    * **Design and styles** — layouts, Tailwind classes, and component styles
    * **Backend functionality** — any server-side logic Clark detects

    Clark then rewrites the code to run on Superblocks:

    | v0                                     | Superblocks                                                                |
    | -------------------------------------- | -------------------------------------------------------------------------- |
    | Hardcoded API calls and fetch requests | [Integrations](/integrations/overview) connected to your data sources      |
    | Hardcoded API keys and secrets         | Credentials managed by the platform                                        |
    | Custom auth                            | Platform-managed [authentication and RBAC](/admin/org-administration/rbac) |
    | React pages and components             | React pages hosted on the platform, preserving your design and styles      |

    You'll be prompted to connect your integrations — pick the databases, APIs, and services the app should use in your environment.
  </Step>
</Steps>

## What gets migrated

Clark analyzes the v0 source code and replaces external dependencies with Superblocks platform features. v0 projects are React-based with Tailwind and shadcn/ui components, which migrate well — layouts, styles, and component structure are preserved as closely as possible.

## Troubleshooting

**The zip won't upload** — Make sure the zip contains your project's root folder and excludes `node_modules`, `.git`, and build output directories.

**Some components look different after migration** — Clark preserves styles where possible, but some shadcn/ui or Radix primitives may render slightly differently in Superblocks. You can edit any component directly after the import completes.

**Integrations aren't connecting** — Verify that the integration is configured in your Superblocks workspace before importing. You can add integrations from the [Integrations page](/integrations/overview) and then reconnect them from within the imported app.
