> For the complete documentation index, see [llms.txt](https://doc.sysdevmobile.com/kalipso/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.sysdevmobile.com/kalipso/6.0/documentation/git/repository.md).

# Repository

The Repository window provides a comprehensive view of your Git repository, including the local path, remote connections, branches, and commit history.

## Create Repository

To create a new Git repository for your project, click **Create Repository** in the Git ribbon. The New Repository window appears:

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FEjxjLPuBgwS74pzeSvjh%2Fimage.png?alt=media&amp;token=f80342d9-6fc3-451c-966a-1add1ca35f2c" alt="New Repository window"><figcaption><p>New Repository window</p></figcaption></figure>

* **Location** - The local folder path where the repository will be created. This is typically your project folder.
* **Backup Project to online Remote** - Enable this option to connect your repository to a remote server (such as GitHub).
* **Remote** - The URL of the remote repository (e.g., `https://github.com/username/repository.git`).

Click **Create** to initialize the repository. If you enabled the remote option, you will be prompted for credentials.

### Credentials

When connecting to a remote repository, you need to provide authentication:

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FZUrCpVw6eEtrFtzm967j%2Fimage.png?alt=media&amp;token=ab4083a2-1faa-4147-81ba-5ef7a8b8c78d" alt="Credentials window"><figcaption><p>Git Credentials</p></figcaption></figure>

* **Username** - Your username for the Git hosting service
* **Password** - Your personal access token
* **Save Credentials** - Check this option to save your credentials for future operations

{% hint style="info" %}
For GitHub, require two-factor authentication, use a [Personal Access Token (classic)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic) instead of your password.
{% endhint %}

## View Repository

To view details of an existing repository, click **Repository** in the Git ribbon:

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FAwpnJSxsGcYIx7ywKK1K%2Fimage.png?alt=media&amp;token=d9049220-441d-47e8-9cf8-4acfa9306011" alt="Repository window"><figcaption><p>Repository information window</p></figcaption></figure>

The Repository window displays:

### Path

The local file system path where your repository is stored.

### Remotes

Lists all configured remote repositories. Each remote shows:

* **Name** - The remote identifier (typically "origin" for the main remote)
* **URL** - The full URL of the remote repository

### Branches

Displays all branches in your repository, organized into:

* **Local branches** (left panel) - Branches that exist on your local machine (e.g., `master (refs/heads/master)`)
* **Remote branches** (right panel) - Branches that exist on the remote server (e.g., `origin/master (refs/remotes/origin/master)`)

### Commits

Shows the commit history for the current branch. Each commit displays:

* **Commit hash** - The unique identifier for the commit
* **Message** - The commit message describing the changes
* **Details** - Additional information about what was changed (e.g., Forms added, files modified)

Click **Close** to exit the Repository window