AI Editor
My Project
0 nodes

Manual Project Import

Upload your Next.js project to start editing (runs on port 3002)

Manual Project Import

Upload a ZIP file (max 10MB) or select a project folder. For larger projects, use folder selection (recommended).

Best for all project sizes. Automatically excludes node_modules, .git, and build artifacts.

For smaller projects only. Files over 10MB must use folder selection.

Import Process:

• All existing files in .preview-site/ will be deleted

• Any running processes using .preview-site or port 3002 will be killed

• Project files will be copied to .preview-site/

• Dependencies will be installed automatically

• The project will always run on port 3002

• Automatically excludes: node_modules, hidden folders (.*), build output

How It Works

1. Clean Slate

All existing files in .preview-site/ are deleted. Any processes using those files or port 3002 are automatically killed.

2. Upload Your Project

Choose either a ZIP file or select your project folder. node_modules will be automatically skipped.

3. Auto-Install Dependencies

We detect your package manager (npm/yarn/pnpm) and automatically install all dependencies.

4. Start Preview on Port 3002

Your project starts automatically on port 3002. The preview canvas connects and you can start editing!

Features

Upload Methods

  • • ZIP file upload
  • • Direct folder selection
  • • Auto-skip node_modules

Smart Detection

  • • Auto-detects npm/yarn/pnpm
  • • Finds correct dev script
  • • Detects Next.js, React, Vite

Robust Cleanup

  • • Kills blocking processes
  • • Retry logic for locked files
  • • Complete directory cleanup

Port Management

  • • Always uses port 3002
  • • Kills conflicting processes
  • • Auto-restart on errors

💡 Tips

  • Remove node_modules before uploading to save time and bandwidth
  • Include package-lock.json to ensure consistent dependency versions
  • Test locally first - make sure your project runs with npm run dev
  • Check logs at preview-3002.log if something goes wrong