> ## 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.

# Replit import

> Migrate a Replit app into Superblocks with Clark

Import a Replit 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 Replit 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 Replit

<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 Replit as your source">
    When prompted to choose a platform, select **Replit**.
  </Step>

  <Step title="Export your project from Replit">
    Superblocks provides a ready-made export prompt. Copy it and paste it into the Replit AI chat. Replit will package your project into a downloadable zip file.

    <img src="https://mintcdn.com/superblocks/U5RkhXSSu8k-JEr-/images/import-apps/replit-export.png?fit=max&auto=format&n=U5RkhXSSu8k-JEr-&q=85&s=ed54ee7834eb388646e823b8b87f11a5" alt="Superblocks migration flow on the Export step: copy export prompt, use Replit chat to build ReplitExport.zip, then download" style={{ width: "100%", maxWidth: "720px" }} width="2004" height="1056" data-path="images/import-apps/replit-export.png" />

    Download the zip once Replit finishes building it.
  </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, identifies frameworks, data sources, and pages, then rewrites the code to run on Superblocks:

    | Replit                                  | Superblocks                                                                |
    | --------------------------------------- | -------------------------------------------------------------------------- |
    | Database clients (`pg`, `knex`, Prisma) | [Integrations](/integrations/overview) connected to your databases         |
    | Hardcoded API keys and secrets          | Credentials managed by the platform                                        |
    | Custom auth (Passport, JWT)             | Platform-managed [authentication and RBAC](/admin/org-administration/rbac) |
    | Express routes, Deno functions          | [Backend APIs](/building-with-clark/backend-apis)                          |
    | Frontend 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 Replit source code and replaces external dependencies with Superblocks platform features. Most frontend components, layouts, and styles migrate as-is. Backend routes and server-side logic are rewritten as Superblocks Backend APIs, and database clients are replaced with your connected integrations.

## 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. Re-run the export prompt in Replit if needed.

**Some components look different after migration** — Clark preserves styles where possible, but some Replit-specific packages may not have a direct equivalent. You can edit any component directly in Superblocks 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.