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

# Projects

> Manage and configure projects in G360.

Projects are the primary organizational unit in G360.

## Overview

Use projects to organize repositories, integrations, metrics, and reporting for your engineering teams.

## Key Capabilities

* Create and manage projects
* Connect integrations
* View engineering insights
* Configure project settings

## What is Projects?

The Projects section is the central hub of the Engineering Metrics Dashboard. It allows administrators to create, configure, and manage projects that track engineering activity across connected tools and platforms.

Each project acts as a container that links your data sources, such as GitHub repositories, CI/CD pipelines, or issue trackers, and collects metrics from them on a scheduled basis.

## Navigating to the Projects Page

To access the Projects section:

1. Log in to the Engineering Metrics Dashboard.
2. In the left-hand navigation sidebar, click **Projects** at the top of the menu.
3. The Projects list page will load, displaying all existing projects.

## The Projects List Page

The Projects list page gives you a bird's-eye view of all projects set up in your workspace. Each row in the list represents one project.

### Understanding the Projects Table

| Column           | Field              | Description                                               | Example             |
| ---------------- | ------------------ | --------------------------------------------------------- | ------------------- |
| Project Identity | Name & Icon        | The name given to the project during setup                | GithubTesting       |
| Type             | Project Type Badge | The category of metrics being tracked                     | Engineering Metrics |
| Sync Details     | Status & Frequency | Shows current sync status and how often data is collected | Not Started · Daily |
| Last Run         | Timestamp          | The date and time the last data sync was run              | — (not yet run)     |
| Configure        | Action Button      | Opens the configuration settings for that project         | Click to Edit       |

## Sync Status Indicators

The coloured badge in the Sync Details column tells you the current state of a project's data collection.

### Not Started

Data collection has not been initiated yet for this project.

> Note: A project showing **Not Started** will not collect any data until it is fully configured and a sync is triggered.

## Page Controls

* Use the **Search** bar at the top of the list to find a project by name.
* Use the **Refresh** button (circular arrow icon) next to the search bar to reload the latest project data.
* Use the **All Projects** dropdown (top right) to filter or change how many projects are displayed per page.

## Creating a New Project

Projects are the foundation of everything in the dashboard. You need to create a project before you can connect data sources or view any metrics.

> Note: Before creating a project, it is recommended (but not required) to set up your tool integrations first via the **Integrations** section in the left sidebar. You can also add data sources during the project creation flow.

### Step 1 — Open the Create Project Dialog

Click the **+ Add Project** button in the top-right corner of the Projects page.

A dialog box titled **Create New Project** will appear.

### Step 2 — Enter Project Details

**Project Name (Required)**

Enter a clear, descriptive name for your project. This name will appear across dashboards and reports.

Example:

`Team Portal – Core Engineering`

**Description (Optional)**

Add a short description of what this project is tracking.

Maximum length: 200 characters.

### Step 3 — Select a Project Type

Choose the type of metrics this project will track.

| Project Type                | What It Tracks                                              | When to Use It                                    |
| --------------------------- | ----------------------------------------------------------- | ------------------------------------------------- |
| Engineering Metrics Project | Repositories, CI/CD pipelines, and developer workflow tools | For tracking code, deployments, and pull requests |
| LLM Metrics Project         | LLM usage and model performance via a provider connection   | For teams using AI and LLM tools                  |
| AI Coding Metrics Project   | AI coding tool usage via a provider connection              | For tracking tools such as GitHub Copilot         |

> Note: Select **Engineering Metrics Project** if you are tracking pull requests, code reviews, or CI/CD pipelines. This is the most commonly used project type.

### Step 4 — Add a Data Source

After clicking **Create & Setup**, you will be taken to the data source configuration step.

Here you connect the tool or platform from which data will be collected, such as a GitHub repository or Azure DevOps project.

You can either:

* Connect a new integration directly from this step if one has not been set up yet.
* Select an existing integration that was previously configured under the Integrations section.

### Step 5 — Configure Sync Behaviour

The final step lets you control how and when data is collected.

* **Data Collection Frequency**: Choose how often the project syncs, for example Daily.
* **Historical Data Range**: Select how many months of past data should be collected on the first sync.

Once you have configured sync behaviour, click **Done** (or the equivalent confirmation button) to complete project setup.

> Note: After setup, the project will appear in the Projects list with a **Not Started** status until the first sync runs.