---
title: "Import from GitHub"
description: "Connect your GitHub account, import existing repositories, and let Evonx map your codebase before making changes."
url: https://evonx.ai/docs/build/import-from-github
locale: en
updated: 2026-09-04
---

# Import from GitHub

Connect your GitHub account, import existing repositories, and let Evonx map your codebase before making changes.

Evonx doesn't only build new software — it evolves software you already have.
Connect GitHub, import a repository into a business, and ask for changes the same
way you would on a greenfield project. Before touching anything, Evonx maps the
codebase so its changes fit how your project actually works.

## Connect and import

1. In your business, choose to import from GitHub and authorize the Evonx GitHub
   connection. You can connect more than one GitHub account and set one as primary.

2. Pick the repositories to import — one or several at once. Each becomes a
   project inside your business.

3. Let the codebase scan run. Evonx maps modules, services, and APIs into a system
   graph you can explore — and the AI uses the same map to plan changes safely.

> **Note**
> Importing doesn't move your repository — GitHub stays the source of truth. Evonx
> syncs from it and ships changes back as pull requests on GitHub, so your existing
> review flow keeps working.

## What works on imported projects

Everything in the core loop:

- **Ask for changes** in plain language; bigger work runs as
  [Evolution Threads](/docs/evolve/evolution-threads) with plans you approve.
- **Run previews** from the [Preview Hub](/docs/preview-and-debug/preview-hub) —
  including [Analyse & Fix](/docs/preview-and-debug/analyse-and-fix) when boots
  fail.
- **Review everything as pull requests** — see
  [Publishing changes](/docs/evolve/publishing-changes).
- **Check project health** with AI reports and recommendations — see
  [Health checks & recommendations](/docs/launch/health-checks).

## Good first requests for an imported project

Start small to calibrate: a copy change, a new field on an existing form, a bug you
know well. You'll see how the AI navigates your conventions before you hand it
bigger work — the same advice as
[Effective prompting on Evonx](/docs/evolve/effective-prompting).

## Related

- [GitHub integration](/docs/integrations/github) — accounts, sync, and the
  publish path in detail.
- [Modernize an existing codebase](/docs/use-cases/modernize-existing-code) — this
  path end to end, as a worked use case.