# compare

> Compare two versions of a Starflow project using file paths, git commits, or tags and generate a diff report with templates.

## Synopsis

**starlake compare [options]**

## Description
Compare two versions of a Starflow project to identify configuration differences. You can compare by file path, git commit, or git tag, and render the diff report using a custom template.

## Parameters

Parameter|Cardinality|Description
---|---|---
--path1 `<value>`|*Optional*|old version starlake project path
--path2 `<value>`|*Optional*|new version starlake project path
--gitWorkTree `<value>`|*Optional*|local path to git project (only if path1 or path2 if empty)
--commit1 `<value>`|*Optional*|old project commit id (SHA) - if path1 is empty
--commit2 `<value>`|*Optional*|new project commit id (SHA) - if path2 is empty
--tag1 `<value>`|*Optional*|old project git tag (latest for most recent tag) - if path1 and commit1 are empty
--tag2 `<value>`|*Optional*|new project git tag (latest for most recent tag) - if path2 and commit1 are empty
--template `<value>`|*Optional*|SSP / Mustache Template path
--output `<value>`|*Optional*|Output path
--reportFormat `<value>`|*Optional*|Report format: console, json, html