Import from Git

Importing an existing repo from Git can get you quickly up and running with Diversion. You can also enable bi-directional sync between your Git repo and Diversion, so that changes made in either place are reflected in the other. This is a great way to take Diversion for a test drive with no commitment.

Web UI
CLI

To import a repo using the Web UI, follow these steps:

Enable Diversion Sync

Go to the Diversion Sync GitHub App page and follow the instructions to install it.

Click the 'Import Git Repository' button

Go to your Dashboard and import.

You'll be prompted to choose your import options

Choose whether you want to import your entire repo and keep all of its history, or just the latest commit from a specific branch.If you choose to Import all branches with history, you’ll have the option to Enable continuous bi-directional sync.

Note

If you need bi-directional sync, please contact us at support@diversion.dev.

Enter the url for the repo you want to import

Click the 'Import' button

Wait for the import to complete

This happens in the background, and depending on the size of your Git repo can take a few minutes. You will receive an email when the import is complete.

To import a repo using the CLI, follow these steps:

Enable Diversion Sync

Go to the Diversion Sync GitHub App page and follow the instructions to install it.

Open a CLI terminal

Open your terminal of choice.

Using the Diversion Interactive Shell

If you want an interactive shell with nicer UI, open your terminal of choice and run the dv command. It works the same as your regular terminal, and you can use any of the dv commands (commit, init, etc…) directly without prefacing them with dv.

Import

Run the following command:

  dv import [git_url]

This will start importing your repo into Diversion with the default name - the same as the repo’s name in Git.There are several optional arguments for the import command. You can always run dv help import to see them in the terminal.

[repo-name]

Passing a repo name to the import command will save the repo to Diversion with that name, instead of the repo’s name in Git.

  dv import [git_url] [repo-name]

--with-sync

Enables bi-directional sync between your new Diverson repo and your Git repo. This means that any change you make to one repo will be reflected in the other.This is useful for testing Diversion or for keeping any Git-based pipelines you have in place.

  dv import [git_url] --with-sync

Note

If you need bi-directional sync, please contact us at support@diversion.dev.

--git-branch

By default, Diversion will import the latest commit from the default branch of your Git repo. If you want to import the latest commit from a different branch, you can use the --git-branch flag.

  dv import [git_url] --git-branch [branch-name]

--with-history

By default, Diversion will only import the latest commit from the default branch of your Git repo. If you want to import the entire repo with all of its history, you can use the --with-history flag.

  dv import [git_url] --with-history

Wait for the import to complete

This happens in the background, and depending on the size of your Git repo can take a few minutes. You will receive an email when the import is complete.

Get Started

Collaborate

Work with Unreal Engine

Work with Unity

Integrations

Reference

CLI Reference

Note

Using the Diversion Interactive Shell

Note