Important: A “project” is different than a “product”, as well as a “project version” is different than a “product version”.Project versions represent the version of the component while product versions represent the version of the product.
Products and project versions can evolve independently.

You can change the project version by clicking on the version name and selecting the desired version from the dropdown menu.

- Gray: No requirement evaluations are available for the current project version.
- Green: Requirements are evaluated and passing.
- Red: Requirements are evaluated but not passing.
- Yellow: Requirements are evaluated but not all policies are passing.
- Blue: Requirements are not passing, but a team member has created an exception.
Frameworks can be associated to a project at any time by attaching them to one of its products.
How to create a new Project
There are several ways of creating new Projects:- Automatically when you perform an attestation
- Through the UI in advance
- Web UI
- CLI
To create a project, Go ot the projects list and click, Create Project.

- Name: Unique name of the project in the organization. It normally matches a specific software product.
- Description: A description of what the project is about.
Project Versions
Important: A “project” is different than a “product”, as well as a “project version” is different than a “product version”.Project versions represent the version of the component while product versions represent the version of the product.
Products and project versions can evolve independently.
Attest to a specific version
During the attestation process, alongside providing theproject
you can also provide a version
.
For example, the following line will initialize an attestation associated with the project myproject
and version v0.0.1
Command output
Command output
Promote a pre-release version
Note how the version in the previous output isv0.0.1 (prerelease)
. Think of prerelease as a work-in-progress version, not yet finished until an explicit release
event is performed.
To release an existing pre-release version, you can do it either
- Performing another attestation but this time provide the
--release
flag. - From the Web UI
- CLI
- Web UI
Command output
Command output
Automatically load the version
An alternative to provide the--version
flag in each attestation is to use a .chainloop.yml
file in your repo.
.chainloop.yml
file automatically if it exists.