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

# Projects

> How Warp organizes migration engagements

### 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.
* 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 button:** Starts the process of creating a new project.

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(37).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=8b4822e704403116f674bc7d20ed8b18" alt="" width="3816" height="1902" data-path="content/media/images/image (37).png" />
</Frame>

### The *Projects* List

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

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(29)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=636a3b9d958260d448c740df1348042d" alt="" width="3282" height="185" data-path="content/media/images/image (29) (1).png" />
</Frame>

Each item has the following elements:

* The Project’s name.
* These buttons:
  * <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(31)%20(1).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=11bd34049b8913976d3c05bca0568e41" alt="" data-size="line" width="129" height="93" data-path="content/media/images/image (31) (1).png" /> : **Settings.** View and manage the Project’s settings.
  * <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(34).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=9bf24f7490957ed07553a8a12a7595ec" alt="" data-size="line" width="129" height="93" data-path="content/media/images/image (34).png" /> : **Migration HQ.** View *Migration HQ*, the GitHub repository where you manage the migration process.
  * <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(35).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=5af6581eff74a1d497af5404c0ef25ca" alt="" data-size="line" width="129" height="93" data-path="content/media/images/image (35).png" /> : **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:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(38).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=aee3d01afa01c3cb6e27c3d293c3b3d9" alt="" width="3273" height="196" data-path="content/media/images/image (38).png" />
</Frame>

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.
