Introduction to "branch"

heloisalouzada

Heloisa Louzada B. Gomes

Posted on September 19, 2024

Introduction to "branch"

Today, we’re going to talk about an essential concept for using Git and GitHub: branches. For this post, we’ll assume you are already familiar with the concepts of remote repository, local repository, stage, and commit; that you have already installed Git on your machine and created an account on GitHub. If you're not familiar with these concepts, check out the introductory post about Git in the following link (https://dev.to/ledscolatina/initial-introduction-to-git-and-github-4apc).

What are Branches?

A branch is essentially an independent environment where your commits are organized. Simplified, you can think of branches as parallel timelines where changes are made without interfering with others. Imagine the "multiverse" concept from Spider-Man: each version of the hero has its own timeline, and their actions do not affect the others, but when merged, they can create conflicts. Similarly, branches are separate environments where you can work without affecting the main code.

How do Branches Work?

When a project is created, it typically starts with a branch called master (or main, in the case of a clone), which is where the main code is maintained. If you want to add new features without compromising the existing functional code, the best practice is to create a new branch. This way, you can make commits and tests without affecting the main branch until everything is ready to be integrated (or even discarded, if necessary).

Creating a Branch

Let's imagine that you are starting a project in your local repository and then plan to push it to a remote repository.

When you start the project with git init, Git automatically creates a main branch for you, called master (or main).

git init
Enter fullscreen mode Exit fullscreen mode

From this point, you can add files and make commits as usual. They will be recorded on the master branch, as if they were steps in a continuous timeline.

Image description

When the project is ready to be pushed to the remote repository on GitHub, we will start the step of linking the local repository to the remote one. To do this, you need to have a GitHub account and use some specific commands:

  • Create a new repository on your GitHub account.

Image description

  • Select the "<> Code" button and copy the URL of your remote repository.

Image description

  • In the git terminal, use the command git remote add origin [remote repository URL] to link your local repository to the remote one.
git remote add origin https://github/user/repository_name.git
Enter fullscreen mode Exit fullscreen mode
  • To push your files to the remote repository, use a variation of the git push command. Since the repository was not cloned and we need to connect it to the remote repository, you need to specify the name of the branch you want to push, as the newly created repository does not yet have any bran ches. The command is: git push origin [branch-name].
git push origin master
Enter fullscreen mode Exit fullscreen mode

Navigating Between Branches

Next, let's start a new branch. This allows you to work on a separate branch where your changes won't affect what has already been done on the main branch.

  • To create a new branch, use the command git branch [branch-name].
git branch new_branch
Enter fullscreen mode Exit fullscreen mode
  • If you want to create and immediately switch to the new branch, use git checkout -b [branch-name].
git checkout -b new_branch
Enter fullscreen mode Exit fullscreen mode

In this way, the files and commits added to this new branch will not be visible on the master branch, and vice versa.

Image description

To switch between branches, simply use the command git checkout [branch-name]. This is useful when you need to quickly switch between different parts of the project.


Finalizing: Merge

Suppose your modifications were successful, and now you want to integrate the new features into the main branch. For this, a powerful concept called merge comes into play. Want to know how it works? Stay tuned for the next post!

Post about merge =D

💖 💪 🙅 🚩
heloisalouzada
Heloisa Louzada B. Gomes

Posted on September 19, 2024

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related