# Import from GitHub



Import existing GitHub projects directly into Ideavo. The agent detects your stack, configures your environment, and gets you building in minutes — without touching a config file.

## Before You Import [#before-you-import]

A few things worth knowing before you start:

* **Public and private repositories** are both supported
* **Organization repositories** are available if you've granted Ideavo access to that org during GitHub authorization
* **Branch selection** — you choose which branch to import. Ideavo tracks that branch going forward; pushing and pulling targets it by default
* **Import stays linked** — importing doesn't create a detached copy. Your project remains connected to the GitHub repository, and you can push and pull changes as you would with any linked project

### How to Import [#how-to-import]

<Steps>
  <Step>
    Click the **+** button in the prompt box on the home page and choose **Import**.

    <DocImage src="features/import/import-menu" alt="The plus menu in the new project composer open, with Import highlighted below Attachments" width="1120" height="756" />
  </Step>

  <Step>
    Connect your GitHub account if you haven't already. You'll be prompted to authorize Ideavo and grant repository access.
  </Step>

  <Step>
    Select the repository and branch you want to import.

    <DocImage src="features/import/repository-select" alt="The Import from GitHub dialog with the private boardly repository and main branch selected" width="1216" height="512" />
  </Step>
</Steps>

## What Ideavo Sets Up [#what-ideavo-sets-up]

Once the import completes, the agent takes over and prepares your project automatically:

* **Stack detection** — Ideavo analyzes your repository and identifies the framework, language, and tooling in use
* **Workflow configuration** — your [Workflow](/docs/features/workflow) is pre-configured based on the detected stack, including install, build, and run commands
* **Ready to build** — once setup is complete, you can start prompting the agent or editing code directly in the IDE

<Callout type="info">
  If the auto-detected Workflow doesn't match your setup exactly, you can edit
  it at any time from the Workflow panel without affecting your code.
</Callout>

### FAQ [#faq]

<Accordions>
  <Accordion title="Does import copy the repo or stay linked to GitHub?">
    Import keeps your project linked to the original GitHub repository. It's not
    a detached copy — you can continue pushing and pulling changes through the
    GitHub integration as normal.
  </Accordion>

  <Accordion title="Can I import a private repository?">
    Yes. Private repositories are fully supported. Make sure Ideavo has been
    granted access to private repos during the GitHub authorization step.
  </Accordion>

  <Accordion title="Can I import from a GitHub organization?">
    Yes, as long as you've authorized Ideavo to access that organization during
    the GitHub OAuth flow. If you don't see your org's repositories in the list,
    re-authorize and grant access to the relevant organization.
  </Accordion>

  <Accordion title="What if my stack isn't detected correctly?">
    You can manually edit the Workflow configuration after import. Adjust the
    install, build, and run commands to match your actual setup — changes take
    effect immediately.
  </Accordion>

  <Accordion title="Can I import the same repository more than once?">
    Yes. Each import creates a separate Ideavo project, so you can have multiple
    projects pointing to the same repository — useful for working on different
    branches in isolation.
  </Accordion>

  <Accordion title="What happens to my other branches after import?">
    Only the branch you selected during import is tracked by default. You can
    switch to other branches at any time using the GitHub component or directly
    from the IDE.
  </Accordion>
</Accordions>
