Skip to main content
Import any app into Superblocks by uploading a zip of your project. This works for apps built with any tool — Bolt, Cursor, Windsurf, or your own codebase.

​
Before you begin

Make sure you have:
  • A project zip ready to upload
  • 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

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

Prepare your zip

Zip your project’s root folder. Before zipping, remove the following to keep the file size small:
  • node_modules/
  • .git/
  • Build output directories (dist/, build/, .next/, etc.)
3

Upload the zip

On the Superblocks import screen, select the Other option when prompted for a source.Superblocks migration Export step for a generic or custom source: package the project before continuingDrop your zip file into the upload area and click Import.Migration Upload step: drag-and-drop zone for .zip, .tgz, or .gz archives with Import app button
4

Clark migrates the app

Clark inspects your project structure, identifies frameworks, data sources, and pages, then rewrites the code to run on Superblocks: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 your source code and replaces external dependencies with Superblocks platform features. Frameworks Clark works well with include React, Next.js, Vue, and plain HTML/JS. Backend logic written as Express or Deno routes is rewritten as Superblocks Backend APIs.

​
Troubleshooting

The zip is too large — Remove node_modules/, .git/, and any build output before zipping. These directories are not needed for the import. Clark can’t identify the framework — Make sure your project has a package.json at the root and that framework dependencies (e.g. react, next, vue) are listed. Add a brief README describing the project structure if the layout is non-standard. Some components look different after migration — Clark preserves styles where possible, but some UI libraries may not have a direct equivalent 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 and then reconnect them from within the imported app.