Import an Existing GitHub Project

You don't have to start from a blank prompt to use CodeSky. Bring an existing repository in and the AI picks up where you left off — reading your code, then editing it the same way it edits code it generated itself. This is the fastest way to add CodeSky to a project you already have.

Two ways to bring code in

• Public repo URL. Paste a GitHub URL in the Import dialog; CodeSky clones the default branch.
• Zip upload. Drag a zip of your project. Ideal for private code you don't want to authorize over OAuth, or for a repo that isn't on GitHub at all.

What happens on import

1. The import is queued as a background job — you watch progress in the chat.
2. CodeSky detects the framework (Vite, Next.js, Angular, Expo, …) and the backend stack from your files.
3. Files are placed under GeneratedApps/{userId}/{projectGuid}.
4. npm install runs so the project is ready to preview and prompt against.

Preparing a repo for a clean import

• Make sure the project runs from the repo root with a standard package.json.
• Keep secrets out of the committed code — use .env.example; you'll add real values after import.
• Remove huge build artifacts and node_modules from the zip; they're reinstalled anyway.
• A conventional layout (frontend/backend/database or a single app) imports most reliably.

Working with an imported project

• Open the Preview to confirm it runs, then treat it like any CodeSky project.
• Add features or fix bugs by prompt — "add a dark-mode toggle", "there's a null check missing in orders.controller.js".
• In the desktop editor, use @-mentions to point the AI at a specific file when the codebase is large.

Round-tripping to GitHub

• Connect the project back to GitHub from the Source Control panel.
• Once linked, successful generations can push automatically, so your repo stays the source of truth while CodeSky does the editing.

FAQ