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

# Projects

> Manage your projects and connect GitHub repositories in Corridor.

A Project in Corridor represents a codebase (typically a repository) that you want to secure. Each repository you add to Corridor becomes a Project that is continuously monitored and guarded.

## Key concepts

* **One repo = one project**: When you import a repository, Corridor indexes its code and sets up security guardrails specific to that project. All findings, pull request reviews, and guardrail configurations are associated with that project
* **Required for scanning**: Corridor only monitors code that has been explicitly added as a project. If a repository isn't added, Corridor will ignore its PRs and won't apply guardrails to it
* **Multiple projects**: You can add multiple repositories as separate projects, each with possibly different guardrail settings tailored to their context

## Project limits

| Tier       | Max Projects |
| ---------- | ------------ |
| Pro        | 5            |
| Team       | 20           |
| Enterprise | Unlimited    |

## Creating a project

### From your IDE

The simplest way to create a project:

1. Open a Git repository in your IDE
2. Ensure you're signed in to Corridor
3. Click **Register Project** in the Corridor panel
4. Select your team

### From the dashboard

Create projects directly in the web dashboard:

1. Go to [app.corridor.dev](https://app.corridor.dev)
2. Click **New Project**
3. Enter a project name
4. Connect a GitHub repository (optional)
5. Select the team

### Initial scan and guardrail generation

Once added, Corridor immediately:

* Scans the codebase to understand the project's technology stack
* Identifies frameworks and languages in use
* Auto-generates security guardrails tailored to that project
* Starts analyzing any new code changes

This process happens fairly quickly and requires no action on your part.

## Connecting GitHub

To enable PR reviews, connect your project to a GitHub repository:

1. Go to **Project Settings → GitHub**
2. Click **Connect GitHub**
3. Authorize Corridor to access your repository
4. Toggle on **Automated PR Reviews**

Once connected, every pull request is automatically reviewed for security vulnerabilities.

## Project settings

Access settings by clicking the gear icon on any project:

### General

* **Name**: Display name for the project
* **Description**: Optional project description
* **Team**: Which team owns this project

### GitHub integration

* **Repository**: Linked GitHub repository
* **PR Reviews**: Enable/disable automated reviews
* **Status Checks**: Require Corridor review before merge

### Guardrails

Configure which guardrails are active for this project. By default, projects inherit their team's guardrail settings, but you can customize per-project. This allows tailoring security to the context of that repo (for example, enabling web-specific guardrails on a web app project, and different ones on an infrastructure-as-code repo).

You can further refine a project's guardrails (including adding custom ones on Team/Enterprise plans) in the Guardrails settings.

## Project activity

### PR Reviews

See all automated reviews for this project:

1. Open your project
2. Click **PR Reviews**
3. View reviews with status and findings count
4. Click any review to see details

### Findings

View security findings discovered in this project:

1. Open your project
2. Click **Findings**
3. Filter by state, severity, or source

### Guardrail Invocations

See real-time security analysis from IDE usage:

1. Open your project
2. Click **Guardrails** or **Activity**
3. View invocations with compliance status

## Project analytics

View metrics for your project:

* **PR review volume**: Reviews over time
* **Findings by severity**: Distribution of issues
* **Guardrail pass/fail rates**: How often guardrails are triggered
* **Remediation progress**: Open vs. closed findings

## Archiving projects

Archive projects you no longer actively maintain:

1. Go to **Project Settings**
2. Click **Archive Project**
3. Confirm the action

Archived projects:

* Don't appear in the main project list
* Stop processing new PR reviews
* Retain all historical data
* Can be restored later

## Deleting projects

<Warning>
  Deleting a project permanently removes all associated data including findings, reviews, and analytics.
</Warning>

1. Go to **Project Settings**
2. Click **Delete Project**
3. Type the project name to confirm
4. Click **Delete**

## Next steps

<CardGroup cols={2}>
  <Card title="Teams" icon="users" href="/dashboard/teams">
    Manage team members and settings
  </Card>

  <Card title="GitHub Integration" icon="github" href="/integrations/github">
    Configure GitHub connection
  </Card>
</CardGroup>