Skip to main content

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.

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

1

Start the import

From the Superblocks home screen, click Import in the prompt bar, or click the Import an app link below it.
2

Select Replit as your source

When prompted to choose a platform, select Replit.
3

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.Superblocks migration flow on the Export step: copy export prompt, use Replit chat to build ReplitExport.zip, then downloadDownload the zip once Replit finishes building it.
4

Upload the zip

Drop the downloaded zip file into the Superblocks upload area and click Import.Migration Upload step: drag-and-drop zone for .zip, .tgz, or .gz archives with Import app button
5

Clark migrates the app

Clark inspects your project structure, identifies frameworks, data sources, and pages, then rewrites the code to run on Superblocks:
ReplitSuperblocks
Database clients (pg, knex, Prisma)Integrations connected to your databases
Hardcoded API keys and secretsCredentials managed by the platform
Custom auth (Passport, JWT)Platform-managed authentication and RBAC
Express routes, Deno functionsBackend APIs
Frontend pages and componentsReact 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.

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 and then reconnect them from within the imported app.