Skip to main content
Version: v2.10.0

Git Operations

Yeedu provides built-in Git capabilities that allow users to perform common Git operations directly from the workspace UI. These operations help manage branches, track file changes, synchronize with remote repositories, and push updates without leaving the platform.

Git operations are available for Git folders inside Workspace → Files.

Opening Git Operations​

To access Git operations:

  1. Navigate to Workspace → Files
  2. Locate the Git folder
  3. Click the Action Menu (⋮)
  4. Select Git

This opens the Git Operations popup, where all repository-related actions can be performed.

git-folder-workspace-view.png

Branch Management

List Branches​

Yeedu allows users to view all branches available in the repository.

The branch dropdown displays the list of branches present in the Git repository.

Users can select any branch from the dropdown to view its contents.

list_branches.png

Switch Branch​

Users can switch between branches using the branch selector.

Steps​

  1. Click the branch dropdown
  2. Select the desired branch
  3. The repository switches to the selected branch

list_branches.png

note

Branch switching is not allowed when there are uncommitted changes.

To switch branches, users must either:

  • Commit and push the changes, or
  • Discard the changes

Create Branch​

Users can create a new branch from the current branch.

Steps​

  1. Click the + Branch button
  2. Enter the new branch name
  3. Click Create

The new branch will be created using the current branch as the base branch.

Upon creation, the system automatically switches to the newly created branch.

create-branch-popup.png

Local Clone HEAD Commit​

Next to the Create Branch option, the UI displays the Local Clone HEAD Commit.

This represents the current commit hash of the repository that is checked out in the workspace.

This helps users quickly identify the exact version of the repository currently in use.

local_commit.png

Repository Synchronization

Refresh​

The Refresh button reloads the repository status and updates:

  • Branch information
  • File change status
  • Repository differences

This helps ensure the UI reflects the latest repository state.

refresh.png

Pull Changes​

If the local repository is behind the remote repository, the UI will show the number of commits behind.

Users can click Pull to fetch the latest changes from the remote repository.

pull.png

Steps​

  1. Click the Pull button
  2. The latest commits are fetched from the remote repository
  3. The local repository is updated

Merge Conflicts​

If merge conflicts occur during the pull process:

  1. Users must manually resolve the conflicts
  2. After resolving conflicts, click Mark as Resolved

This completes the merge process.

File Changes and Diff Viewer

The Git interface displays file changes detected in the repository.

The left panel shows all changed files.

The right panel displays the file diff view, similar to the output of the git diff command.

Users can select any file from the left panel to view the detailed differences.

single_discard.png

Git tracks the following file change types:

CodeMeaning
AAdded file
MModified file
DDeleted file
RRenamed file
!Merge conflict

Discarding Changes

If users do not want to keep certain changes, they can discard them.

Discard Options​

Users can discard:

  • Individual files
  • Selected files
  • All changed files

Methods​

Individual File

Individual files can be discarded directly using the Discard button available beside the file name.

single_discard.png

Selected Files

  1. Select the required files from the file list
  2. Open the Actions Menu
  3. Click Discard Selected Files

All Files

  1. Open the Actions Menu
  2. Click Discard All Changes

discard_actions.png

Discarding changes restores the files to the last committed state.

Commit and Push Changes

Yeedu allows committing and pushing changes directly from the Git interface.

Users can choose to commit:

  • Selected files, or
  • All changed files

Steps​

  1. Select files to commit
  2. Enter a Commit Message (required)
  3. Enter a Description (optional)
  4. Click Commit & Push

The changes are committed locally and pushed to the remote repository.

git-commit-push.png

Summary

Git operations in Yeedu provide a seamless interface for managing repositories directly from the workspace environment.

Key capabilities include:

  • Listing and switching branches
  • Creating new branches
  • Viewing file differences
  • Discarding unwanted changes
  • Pulling updates from remote repositories
  • Committing and pushing changes
  • Viewing repository status

These features allow users to perform essential Git workflows without leaving the Yeedu workspace.

note

Git operations are currently supported for GitHub repositories. Additional Git providers may be supported in future releases.