Create a New Local Git Repository (Initialize Repository)

Git Repositories

A Git repository (or repo for short) serves as the central nervous system of your project—it contains all of your project files plus the complete revision history of every change ever made. Think of it as a sophisticated time machine for your code. You'll take an ordinary folder of files (such as a website's root folder) and tell Git to transform it into a repository. This creates a hidden .git subfolder that contains all the Git metadata responsible for tracking changes, managing branches, and maintaining your project's entire evolutionary history.

On Unix-based operating systems such as macOS and Linux, files and folders that start with a period (.) are automatically hidden from normal view. This means you won't see the .git folder in the macOS Finder or most file managers unless you explicitly show hidden files—but rest assured, it's working behind the scenes. This design choice keeps your project directory clean while Git operates invisibly in the background. The good news is you'll rarely, if ever, need to directly access the .git folder, as Git's command-line tools and GUI interfaces handle all the heavy lifting.

TIP: On macOS you can toggle the visibility of hidden files by pressing Cmd+Shift+Period(.)—a handy shortcut for those moments when you need to peek under the hood.

Initialize a Git Repo

Now that you understand what a Git repository is, let's walk through the process of creating one. Visual Studio Code makes this remarkably straightforward with its integrated Git support, which has only improved since Microsoft's continued investment in developer tooling.

1. Open a project folder in Visual Studio Code.

   You can do this by going to File > Open (Mac) or File > Open Folder (Windows), navigate to the folder containing your project files, select it, and hit Open (Mac) or Select Folder (Windows). Alternatively, you can drag and drop the folder directly onto the VS Code icon or use the command line with code . if you have the VS Code command-line tools installed.

2. Open the Source Control panel on the left sidebar of the VS Code interface.

3. In the Source Control panel , click the Initialize Repository button.

   VS Code will immediately create the .git folder and set up the initial repository structure. You'll notice the Source Control panel transforms to show your project files as "untracked changes"—these are files that Git now sees but hasn't been told to monitor yet. This is the first step in bringing your project under version control, setting the stage for tracking changes, collaborating with team members, and maintaining a professional development workflow.