# Git Lite

Git Lite simplifies version control for dbt™ projects. It provides a purpose-built Git workflow that keeps you in sync with your main branch, perfect for users new to Git or those who prefer a streamlined interface.

{% hint style="info" %}
You can choose between Git Lite and Git Advanced in your [IDE preferences](https://docs.paradime.io/app-help/documentation/code-ide/user-interface/ide-preferences#git-workflow-preferences)
{% endhint %}

***

## Branch Management

### Create or switch Branches <a href="#create-or-switch-branches" id="create-or-switch-branches"></a>

Create a new branch to start working on features or fixes without affecting the main branch.

**Step-by-Step Instructions:**

1. **Click the Git icon** in the left panel of the Code IDE
2. **Select "Create Branch"** from the menu
3. **Enter your branch name** (use descriptive names like "feature-user-dashboard")
4. **Click "Create Branch"** to create and switch to your new branch

{% @arcade/embed flowId="ZL4fNCjbrPyTR6LMT17R" url="<https://app.arcade.software/share/ZL4fNCjbrPyTR6LMT17R>" %}

{% hint style="info" %}
Paradime will always create a new branch from your remote main/master branch. If switching to an existing branch Paradime will automatically switch branch using your remote selected branch.
{% endhint %}

### Switching Branches

Move between different branches to work on various features or review changes.

**Step-by-Step Instructions:**

1. **Click the Git Lite icon** (🪄) in the left panel of the Code IDE
2. **Click the branch dropdown** to see available branches
3. **Use the search bar** to find your branch if you have many
4. **Select the branch name** to switch to it

{% @arcade/embed flowId="yw5rlZw2s7makCwUWdCr" url="<https://app.arcade.software/share/yw5rlZw2s7makCwUWdCr>" %}

{% hint style="info" %}
Branch list updates automatically every 30 minutes. Click the refresh button to update manually.
{% endhint %}

***

### Working with Changes

### Keeping Branches Updated

Git Lite automatically checks if your branch is behind your remote branch and/or your main/master branch. This check happens:

* After each commit you make
* When you click the refresh button manually
* When you switch between branches

**Step-by-Step Instructions:**

1. **Click the Git icon** in the left panel of the Code IDE
2. Click the **refresh** icon in the status section

{% @arcade/embed flowId="tkKbvWfgRk6cO3Adbxgd" url="<https://app.arcade.software/share/tkKbvWfgRk6cO3Adbxgd>" %}

### Committing Changes

When you have file changes you want to commit, follow these instructions.

**Step-by-Step Instructions:**

1. **Click the Git icon** in the left panel of the Code IDE
2. **Review your changed files** shown in the panel
3. **Enter a clear commit message** describing what you changed
4. **Click "Commit and Push"** to save and upload your changes

{% hint style="info" %}
You can also discard all changes by clicking on the **`Discard Changes`** button.
{% endhint %}

{% @arcade/embed flowId="AZDaPJ6I1gZv3Pn3xG4F" url="<https://app.arcade.software/share/AZDaPJ6I1gZv3Pn3xG4F>" %}

{% hint style="info" %}

#### How it works

**Git Lite automatically:**

* Commits your changes with the provided message
* Pushes changes to your remote branch
* Pulls and merges remote changes if your branch is behind
* Keeps you in sync without manual intervention
  {% endhint %}

### Open Pull Request <a href="#open-pull-request" id="open-pull-request"></a>

Create a pull request to propose merging your changes into the main branch.

**Step-by-Step Instructions:**

1. **Click the Git icon** in the left panel of the Code IDE
2. **Ensure all changes are committed** by clicking "Commit and Push" first
3. **Click "Open Pull Request"** (only enabled when branch is clean)
4. **Complete the pull request** in your Git provider interface

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2Frm3UbwrBbqOz9lqudflA%2Fimage.png?alt=media&#x26;token=8acba7c8-8f98-491f-9590-469c27b80ad9" alt="" width="237"><figcaption></figcaption></figure>

### Reverting Commits

Undo your last commit if you need to fix something or made an error.

**Step-by-Step Instructions:**

1. **Click the Git icon** in the left panel of the Code IDE
2. **Click "Revert Commit"** in the top right corner of the Git Lite panel
3. **Review the commit details** shown in the dialog
4. **Click "Continue"** to revert the last commit

You will see in the dialog the commit details include the commit message, click on `continue` to complete the operation.

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FuFrq7FRPsWOlq4iRSfpu%2Fimage.png?alt=media&#x26;token=a2e3c714-9553-418c-b9ec-98c961c8fa3d" alt="" width="235"><figcaption></figcaption></figure>

### Merge Conflicts <a href="#merge-conflicts" id="merge-conflicts"></a>

When merge conflicts occur, Git Lite provides tools to help you resolve them easily.

{% hint style="info" %}
For detailed instructions on resolving merge conflicts, see our [merge conflict](https://docs.paradime.io/app-help/concepts/working-with-git/merge-conflicts) documentation.
{% endhint %}