# Projects

### What is a Project?

Warp organizes migrations into ***Projects***. In Warp, a Project is an object for managing a *migration engagement* — that is, an event where you will be migrating repositories to GitHub. Projects allow you to view and manage a set of migrations as a distinct operation with its own team, timeline, and budget.

Projects are one of Warp’s ways to make migrations more manageable:

* If you have a small collection of repositories to migrate, you might choose to perform their migrations in a single engagement and use a single project.&#x20;
* If you are performing migrations for multiple clients, you might choose to use one project for each client.
* If you’re working with an organization with a large number of repositories to migrate — numbering in the thousands, tens of thousands, or even more — you’ll probably want to divide that task into multiple projects carried out over a period of time.

### The *Projects* Page

When you sign into Warp, you are taken to the *Projects* page, which contains the following:

* **Projects:** The list of active migration engagements, a.k.a. Projects.
* **Pending Installations:** If you have any projects that have not yet been fully set up and configured, they will appear in this list.
* ***Create a New Project*****&#x20;button:** Starts the process of creating a new project.

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FjVeGai9jazSmSbzPulPR%2Fimage.png?alt=media&#x26;token=4d0ba644-a33b-415c-a267-13d8ab342e20" alt=""><figcaption></figcaption></figure>

### The *Projects* List

For every active Project, the list contains an item that looks like this:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FCrBdI9Hp8zRg9L6ovJtn%2Fimage.png?alt=media&#x26;token=272836ab-86d9-4718-a92b-d8d89f08a08a" alt=""><figcaption></figcaption></figure>

Each item has the following elements:

* The Project’s name.
* These buttons:
  * <img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FUSeye6qR79Aw9ibWGhIA%2Fimage.png?alt=media&#x26;token=1b0058e3-3168-4095-b87e-c620f358ceb2" alt="" data-size="line"> : **Settings.** View and manage the Project’s settings.
  * <img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FcrbIE7dkqq7iIYFA5mj3%2Fimage.png?alt=media&#x26;token=db57c89a-bf92-488c-841e-7757dcb64ae9" alt="" data-size="line"> : ***Migration HQ.*** View *Migration HQ*, the GitHub repository where you manage the migration process.
  * <img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FGSZRbFnUFAuX47mUEw2s%2Fimage.png?alt=media&#x26;token=1f166a21-6252-46a7-ad41-0617b045210b" alt="" data-size="line"> : **Dashboard.** See a high-level overview of the Project.

### The *Pending Installations* List

For every Project that has been created but not yet set up and configured, the list that contains an item that looks like this:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2Fenkeo90h66F9lfkmh3Px%2Fimage.png?alt=media&#x26;token=4922069e-4b6f-4e56-b4db-783113fc1275" alt=""><figcaption></figcaption></figure>

Each item has the following elements:

* The Project’s name.
* The **Start Installation** button, which starts the process of setting up and configuring the Project for use.
