> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Start using Diversion in your project

> Create a new Diversion repo for a completely new project or an existing one

You're working on a project. How exciting!
What you want is a Diversion repository. Let's get you set up:

<Card title="Are you using Unreal?" icon="lightbulb" iconType="duotone" color="#ca8b04">
  You can do this with [our Unreal Engine plugin](/unreal/unreal-engine-plugin)!
</Card>

<Steps>
  <Step title="Create a new repository">
    In the desktop app, click on the `New repository` button on the top right.

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/new-project-init-repo.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=6b44a042239ac2736652ff432d2480a9" alt="Initialize a new repo" width="1656" height="122" data-path="images/new-project-init-repo.png" />
  </Step>

  <Step title="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 Folder`and call it `CreatingNewRepo`.

    <img src="https://mintcdn.com/diversion-2/Ni8GQ373CobDNQFr/images/new-project-create-new-folder.png?fit=max&auto=format&n=Ni8GQ373CobDNQFr&q=85&s=f3c27d64f8d2d4a7fe677a84b031ed90" alt="Create a folder for the repo" width="870" height="627" data-path="images/new-project-create-new-folder.png" />
  </Step>

  <Step title="Click Create" />

  <Step title="Syncing">
    A new repo is created in the folder you specified! The workspace's **Sync** toggle shows it's syncing - the status text reads something like "Syncing: Scan in progress" 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.

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/new-project-repo-is-still-syncing.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=291f297d21517c45601a3d7196be6f67" alt="Repo is still syncing" width="1700" height="162" data-path="images/new-project-repo-is-still-syncing.png" />
  </Step>

  <Step title="Good to go!">
    Once the sync status shows the workspace is fully synced, you're all set!

    <img src="https://mintcdn.com/diversion-2/kHkON9nxKTMPAEAM/images/new-project-repo-done-syncing.png?fit=max&auto=format&n=kHkON9nxKTMPAEAM&q=85&s=d2de08b557458031ae07cc4ab6593567" alt="Repo is ready" width="1740" height="175" data-path="images/new-project-repo-done-syncing.png" />
  </Step>
</Steps>

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](/basic/dvignore) to exclude them.

## What's next?

* [Manage project access](/basic/manage-project-access) — invite collaborators to your repo