Migrate an existing repo
Turn a repository you already own into a full Spaceboy project.
From your code to a Spaceboy repo
Every Spaceboy project starts from a working repo with standards built in — testing, data, GraphQL, CI/CD, and code conventions that agents work well in. Migration brings code you already have up to that same bar: an agent studies your repository, rebuilds it on the matching Spaceboy starter, carries your code and history forward, and hands you a migration report and a pull request to review. When you accept, you have a normal Spaceboy project — indistinguishable from one that started on a template.
Migration is available on every plan, including Free. You grant read-only access to the source repository; Spaceboy never writes to it. The agent work itself is metered like any other agent run, and you see a credit estimate before the migration starts.
How a migration runs
- Connect read-only access — choose Migrate an existing repo when creating a project and connect the Spaceboy Import GitHub App. It only ever reads your code.
- Pick the repository — search your repos, optionally choose a branch, and start the migration.
- The agent analyzes and assigns a platform — web, iOS, Android, or Shopify — and provisions the matching Spaceboy base template.
- The agent migrates your code onto the template, adopting Spaceboy's testing, data, GraphQL, CI/CD, and code standards while preserving your app's behavior.
- You review — a migration report and full diff show exactly what changed. Accept to finish, request changes with feedback, or reject to discard everything.
Progress streams live on the migration page, and you're notified when the migration is ready for review.
What you end up with
An accepted migration is a standard Spaceboy project on Spaceboy infrastructure: a managed repository, agent sessions with live preview, environments, and — where the platform supports it — deploys, provisioned databases, and authentication. Your source repository is left untouched; the migrated repo is a fresh Spaceboy-managed copy.
- Web apps get the full experience: preview, deploys, environments, custom domains.
- iOS and Android projects get agent sessions, builds, and store distribution via the matching integrations.
- Shopify themes preview live against your connected store; publishing ships through Shopify.