Version Control

Use the built-in support for Git to manage your code.

circle-exclamation

Set up your identities

Git uses name and email address identify the author of each commit. Before making a commit, you'll need to set up your identity.

To proceed, go Settings > Version Control > Identity.

Set up your credentials

If you are cloning a private repository or pushing changes to a remote, you'll need to set up credentials. To start, enter your credentials at Settings > Version Control > Authentication.

Password-based Authentication

The easiest way to authenticate in Git is to use password-based authentication. To start, obtain a personal access token from your Git hosting provider. To learn more:

Creating a personal access token on GitHub
Creating a personal access tokeno on GitLab

Key-based Authentication

SSH keys can also be used to authenicate in Git. To start, generate a SSH key pair and configure them in your Git hosting provider. To learn more:

Connecting to GitHub with SSH keys
Connecting to GitLab with SSH keys

Setting up multiple credentials

Code App supports multiple credentials. You can configure a unique credential for each hosting provider by specifying their hostnames during the setup process.

Hostname-based credentials

Cloning a repository

To clone a repository, tap the source control icon in the sidebar and enter its url in the clone repository section. Assign it as the workspace folder by tapping the open folder button.

circle-info

Workspace folder is the folder the editor currently loaded. To work with a git repository, it must be located at the root of the workspace folder. You can load a folder by holding a folder cell in explorer or by using the code command in the terminal.

Cloning a repository

Community Templates

A list of community-maintained projects for Code App can be found and cloned under the community templates section.

Committing files

Newly added / modified files must be added to the staging area before you can make a commit. To do this, press the plus icon next to the file name.

Adding a file to staging area

You can now enter a commit message in the textfield and press the commit button to commit. You can also use the command+enter shortcut.

Pushing to remote

You can push your changes to your hosting provider like GitHub.

Pushing changes to remote

Branches and tags

To checkout a branch or a tag, tap the branch icon located in the bottom left corner and select one.

Checkout to a branch

Pull and Fetch

You can also pull or fetch changes from remote. Pull immediately applies the upstream changes to your files. It does so by fast-forwarding the upstream commits if possible or attempting to merge otherwise. On the other hand, fetch does not write changes to your files.

Pull from a remote

To learn more about git pull and fetch:

Last updated