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

# Create a Project

> Walk through the Create Project wizard to name a project, link a repository, and set up workflows.

The **Create project** wizard opens as a slide-over panel on the right side of the screen, with a step progress bar across the top. Depending on your organization's setup and where you launched it from, some steps are skipped automatically — the sections below note when that happens.

<Steps>
  <Step title="How do you want to start?">
    Choose between two cards: **Connect a repository** or **Start without a repository**. Connecting a repository lets Chainloop prefill the project details and run managed workflows against it; starting without one creates a bare project that you can instrument with the [Chainloop CLI](/get-started/first-attestation) and link to a repository later.

    <Frame>
      <img src="https://mintcdn.com/chainloop/CoxE9lbpXk5SmleD/get-started/projects/img/wizard-setup-type.png?fit=max&auto=format&n=CoxE9lbpXk5SmleD&q=85&s=3b2dd2cb0d3e77db97c3e60dfb088af1" alt="Create Project wizard setup type step with Connect a repository and Start without a repository cards" width="635" height="397" data-path="get-started/projects/img/wizard-setup-type.png" />
    </Frame>

    <Note>
      This step, and the following **Connect a repository** step, only appear when a source-control integration is connected. If none is connected yet, the wizard opens directly on the **Details** step.
    </Note>
  </Step>

  <Step title="Pick a repository">
    Search for a repository using the search box, or scroll the list pulled **live** from your connected source-control provider. Each row shows the provider icon, the repository name and description, and a "Linked to `<project>`" badge if it's already linked to another project.

    <Frame>
      <img src="https://mintcdn.com/chainloop/CoxE9lbpXk5SmleD/get-started/projects/img/wizard-pick-repository.png?fit=max&auto=format&n=CoxE9lbpXk5SmleD&q=85&s=a9c1cced08e68ed3fd03689abe9dfaab" alt="Create Project wizard repository picker step with search box and repository list" width="745" height="392" data-path="get-started/projects/img/wizard-pick-repository.png" />
    </Frame>

    Click **Load more** to page through additional repositories, or **Connect new repository** to add another provider connection. If the repository you're looking for isn't listed, use **Manage access** to grant Chainloop access to it — see [Connect GitHub & GitLab](/get-started/projects/connect-repository).
  </Step>

  <Step title="Name your project">
    Enter a project **Name** (required). If you picked a repository in the previous step, the name is prefilled from the repository name — you can still edit it. An optional **Description** field accepts markdown.

    <Frame>
      <img src="https://mintcdn.com/chainloop/CoxE9lbpXk5SmleD/get-started/projects/img/wizard-details.png?fit=max&auto=format&n=CoxE9lbpXk5SmleD&q=85&s=915cb6bb329c00d2c641727c6999bd78" alt="Create Project wizard details step with Name and Description fields" width="743" height="350" data-path="get-started/projects/img/wizard-details.png" />
    </Frame>
  </Step>

  <Step title="Associate a product">
    Optionally attach the project to an existing [product](/concepts/products), create a new product for it, or click **Skip this step** to leave it unattached.

    <Frame>
      <img src="https://mintcdn.com/chainloop/CoxE9lbpXk5SmleD/get-started/projects/img/wizard-associate-product.png?fit=max&auto=format&n=CoxE9lbpXk5SmleD&q=85&s=749e1917a4380754fadad14e89e23e86" alt="Create Project wizard associate product step" width="742" height="434" data-path="get-started/projects/img/wizard-associate-product.png" />
    </Frame>

    <Note>
      This step is skipped automatically when you launch the wizard from within a product.
    </Note>
  </Step>

  <Step title="Set up workflows">
    Choose, for each workflow template, whether it runs in **Managed**, **Manual**, or **Off** mode.

    <Frame>
      <img src="https://mintcdn.com/chainloop/CoxE9lbpXk5SmleD/get-started/projects/img/wizard-configure-workflows.png?fit=max&auto=format&n=CoxE9lbpXk5SmleD&q=85&s=7739f8899089bc3dfe7fd57d7a4d97ba" alt="Create Project wizard set up workflows step with per-template mode selectors" width="738" height="535" data-path="get-started/projects/img/wizard-configure-workflows.png" />
    </Frame>

    See [Built-in & managed workflows](/get-started/projects/managed-workflows) for what each mode does and which templates are available.
  </Step>
</Steps>

## Finish

Click **Create** to provision the project — and the new product, if you created one — link the repository, and create the workflows you selected. A success toast confirms once everything is set up.