Skip to main content
You’re working on a project. How exciting! What you want is a Diversion repository. Let’s get you set up:

Are you using Unreal?

You can do this with our Unreal Engine plugin!
1

Create a new repository

In the desktop app, click on the New repository button on the top right.Initialize a new repo
2

Choose a folder for the repo

You can create a new folder or use an existing one. If you have a game-engine project, you probably want to choose its root folder. For this example I’ll create a new folder, but the other steps work the same either way. I’ll select Create New Folderand call it CreatingNewRepo.Create a folder for the repo
3

Click Create

4

Syncing

A new repo is created in the folder you specified! The workspace’s Sync toggle shows it’s syncing, and its status reads Syncing… while it uploads the folder’s content to our cloud. In this example it’s an empty folder so it should only take a moment. If you create a new repo for an existing project, it might take a bit longer.Repo is still syncing
5

Good to go!

Once the upload finishes, the workspace row’s status changes to Synced. Open the repo and the workspace header names the commit your machine actually has — Synced to dv.commit.<id>, with cloud workspace dv.commit.<id> on the line beneath it — so you can see what arrived rather than only that it finished. It stays on screen until the state changes. See dv status for the same two facts on the command line.Workspace header reading Synced to dv.commit.12345, cloud workspace dv.commit.12345, branch has no newer commits
And that’s it! You have a new repository. Anything you do in the directory will be tracked by Diversion. If there are files you don’t want tracked (e.g. build artifacts, temporary files), you can use a .dvignore file to exclude them.

​
What’s next?