> For the complete documentation index, see [llms.txt](https://manual.bubble.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.bubble.io/innovation-lab/universal-import.md).

# Universal import

Import lets you bring an existing app into Bubble. If you have a project sitting in a code repository, you can import that code rather than rebuilding it from scratch, then work on your app in Bubble's familiar visual editor and continue development with [Bubble AI](/help-guides/ai/bubble-ai-agent.md). Import is designed to work with exports from:

* Lovable
* v0
* Base44
* Replit
* Claude

In practice, Import works with a standard codebase, so it isn't strictly limited to these platforms. As long as you can export your project as a ZIP file (or download it from a repository, as covered below), you can import it into Bubble. The platforms listed here are the ones Bubble has confirmed work well, so if you're exporting from one of them, you can expect a smooth import.

There are two ways to import your app: by uploading your codebase directly in Bubble, or by asking an AI agent to rebuild it through the Bubble MCP. This article covers what you need before importing, how to get your code out of the most common platforms, and how to import it with either method.

<details>

<summary>What is a codebase?</summary>

A codebase is simply all the files that make up an app: the code, the styles, the images, and the configuration that tells everything how to fit together. When people talk about "your code" or "your project files," the codebase is what they mean, the whole collection, bundled up.

</details>

### What you need before importing

To import a project, you need its codebase as a set of files you can upload. A codebase needs to be uploaded as a ZIP file. You can also upload an HTML file.

<details>

<summary>What is a repository (repo)?</summary>

A repository, usually shortened to "repo," is a place where a project's code is stored and its history is tracked. The most common home for a repo is GitHub, a widely used platform for hosting code.

Think of a repo as a shared folder for an app's files, with one useful extra: it remembers every change ever made, so you can look back at earlier versions. When someone says "download my repo," they mean getting a copy of that folder onto your own computer, usually as a ZIP file.

</details>

### Getting your code out of another platform

How you get your code depends on where it currently lives. Below are the steps for the most common sources. In most cases you'll end up with either a ZIP file or a GitHub repository, both of which you can bring into Bubble.

#### From Lovable

Lovable stores your project's code inside its own platform, and gives you two ways to get a copy out.

**Downloading the codebase directly**

{% hint style="info" %}
Downloading your codebase directly from Lovable is available on paid Lovable plans. On a free plan, the GitHub route below is the way to get your code out. For up to date info on terms and documentation, see the link below.

**External page:** [Lovable Documentation](https://docs.lovable.dev/) | [Code mode](https://docs.lovable.dev/features/code-mod)
{% endhint %}

The most direct way, on a paid plan, is to download the codebase from within Lovable:

{% stepper %}
{% step %}

#### Open your project settings

In your Lovable project, go to *Project settings*, then the *Git* section.
{% endstep %}

{% step %}

#### Download the codebase

Use the *Download codebase* option to save your project as a file. You can also open the code editor and click **Download codebase** at the bottom of the file tree.
{% endstep %}
{% endstepper %}

**Downloading through GitHub**

You can export your Lovable project to GitHub, then download it from there.

{% stepper %}
{% step %}

#### Connect Lovable to GitHub

In your Lovable project, click the GitHub option and authorize Lovable to access your GitHub account. You'll grant it permission to create and update repositories.
{% endstep %}

{% step %}

#### Create the repository

Confirm the repository settings, choose whether it should be public or private, and create it. Lovable pushes your entire codebase to the new GitHub repository, which usually takes under a minute.
{% endstep %}

{% step %}

#### Download from GitHub

Once your code is on GitHub, follow the GitHub steps to download it as a ZIP.
{% endstep %}
{% endstepper %}

#### From GitHub

If your code is already in a GitHub repository, downloading a copy takes a few clicks.

{% stepper %}
{% step %}

#### Open the repository

Go to the repository's main page on GitHub.
{% endstep %}

{% step %}

#### Open the Code menu

Click the green **Code** button near the top right of the file list.
{% endstep %}

{% step %}

#### Download the ZIP

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2Fl4ud4WI9lhX8aLZqDUeg%2Fgithub-repo.png?alt=media&amp;token=7084706b-3f95-438c-81fb-330c8909031e" alt=""><figcaption></figcaption></figure>

Select **Download ZIP** from the dropdown. The file saves to your computer's downloads folder, ready to unzip.
{% endstep %}
{% endstepper %}

#### From other platforms

Most other vibe coding platforms follow the same pattern: they either offer a direct download, or they export to GitHub, from which you download a ZIP. Bolt and Base44, for example, both export to GitHub. If your platform isn't listed here, look for a "download," "export," or "connect to GitHub" option in its settings, and check its documentation for the exact steps.

{% hint style="warning" %}
An exported codebase often isn't complete on its own. Some platforms leave out things like API keys, database contents, or connected services (a Supabase database, for example). Keep this in mind, since some of your app's data or connections may need to be set up again after importing.
{% endhint %}

### Importing your app into Bubble

Once you have your codebase as a ZIP file or a repository, there are two ways to bring it into Bubble:

| Method                      | How it works                                                                                                           | Best for                                                          |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Upload in Bubble            | Upload your ZIP file in Bubble, and Bubble converts it into an app. You don't need to leave Bubble or set anything up. | The quickest way to import, without any extra tools               |
| Rebuild with the Bubble MCP | Give your codebase to an AI agent connected to the Bubble MCP, and ask it to rebuild the app in Bubble.                | Working in an AI agent you already use, like Claude Code or Codex |

#### Upload your codebase in Bubble

{% hint style="info" %}
Import is in beta and available to a subset of users for now. If you don't see the options described below, the feature hasn't reached your account yet. It's rolling out to everyone over time.
{% endhint %}

{% stepper %}
{% step %}

#### Click *Import your app*

You'll find the **Import your app** button in these places:

<table><thead><tr><th width="234.40625">Where</th><th>Link</th></tr></thead><tbody><tr><td>The Bubble homepage</td><td><a href="https://bubble.io">bubble.io</a></td></tr><tr><td>The login page</td><td><a href="https://bubble.io/login">bubble.io/login</a></td></tr><tr><td>Your dashboard</td><td><a href="https://bubble.io/home">bubble.io/home</a></td></tr><tr><td>The import page</td><td><a href="https://bubble.io/import">bubble.io/import</a></td></tr></tbody></table>

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FTo0BpPlWniucp4Dc8ck6%2Fupload-app-step-1.png?alt=media&amp;token=8057aaa1-7581-4989-b311-7ed092b61cb0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Provide your codebase

Click to browse, or drag and drop your codebase ZIP or HTML file onto the uploader.

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FHNBV7IKQHdtH1QAhzSOG%2FCleanShot%202026-10-20%20at%2018.34.42.png?alt=media&amp;token=9f9fd7e7-5116-4dba-863e-90d8569084be" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Let Bubble convert it

Bubble analyzes your codebase and then builds your app. On the left, you can see a preview of the app while Bubble works. How long the conversion takes depends on the size and complexity of your project.
{% endstep %}

{% step %}

#### Start editing

After the conversion, you're taken to the Bubble editor, where you can start working on your app by hand or with Bubble AI.
{% endstep %}
{% endstepper %}

#### Rebuild your app with the Bubble MCP

If you already work in an AI agent like Claude, Claude Code, or Codex, you can ask it to rebuild your app in Bubble through the Bubble MCP. The agent reads your codebase and recreates it in your Bubble account, using Bubble's own elements, workflows, and data types.

{% stepper %}
{% step %}

#### Connect the Bubble MCP

Connect your AI agent to Bubble. See [Bubble MCP](/help-guides/ai/bubble-mcp.md) for instructions for each tool.
{% endstep %}

{% step %}

#### Give your codebase to the agent

Upload your codebase ZIP file to the agent. If you use a coding agent like Claude Code or Codex, you can also open the agent in your project's folder instead.
{% endstep %}

{% step %}

#### Ask the agent to rebuild your app

Send this prompt:

```
Rebuild this app in Bubble. Aim to make it as close to a 1:1 recreation as possible.
```

{% endstep %}

{% step %}

#### Review your app in Bubble

When the agent finishes, open the app in the Bubble editor to review what it built. You can adjust anything by hand, with Bubble AI, or with another prompt to your agent.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
When you rebuild your app through the MCP, the AI work counts toward your account with your AI provider, not your Bubble AI usage.
{% endhint %}

### Importing your database

Bubble creates a database based on your app's source code. If you're using a third-party database provider and already have data stored there, you'll need to import that data separately. See the article below.