Import Existing Projects

You can bring existing codebases directly into the Desktop Workspace or Cloud Studio.

Importing into Desktop Workspace

Because BhaiCode Desktop runs natively on your machine, importing an existing repository is instantaneous:

1. Open BhaiCode Desktop.
2. Click Open Folder on the welcome screen (or press Cmd + O / Ctrl + O).
3. Select any local folder containing your project.
4. BhaiCode reads your project tree, .gitignore, package dependencies, and Git history.

**Local Git Integrity**: BhaiCode Desktop respects your local Git branches, remotes, and commit history. It never modifies your `.git` directory without your explicit permission.

Importing into Cloud Studio

To import an existing remote repository into the browser-based Cloud Studio:

1. Connect your GitHub or GitLab account via Connectors.
2. On the Dashboard, click New Project → Import Repository.
3. Select your repository from the list.
4. Choose your working branch (e.g., main).
5. Add any required Environment Variables (API keys, secrets).
6. Click Import & Open Studio.

Cloud Studio clones the repository tree, detects the framework configuration, launches the live preview, and prepares Bhai with full codebase context.