The .git directory structure - Mini Project: Build & Apply

Explore the .git Directory Structure

📖 Scenario: You have just initialized a new Git repository for your project. Now, you want to understand the hidden .git directory that Git created inside your project folder. This directory holds all the important data and configuration for your Git repository.

🎯 Goal: Learn to list and identify key folders and files inside the .git directory to understand how Git stores information about your project.

📋 What You'll Learn

Initialize a new Git repository

List the contents of the .git directory

Identify key files and folders inside .git

Display the contents of the HEAD file

💡 Why This Matters

🌍 Real World

Understanding the <code>.git</code> directory helps you know how Git stores your project history and configuration behind the scenes.

💼 Career

Developers and DevOps engineers often troubleshoot Git issues by inspecting the <code>.git</code> directory and its files.

1

Initialize a Git repository

Run the command git init in your project folder to create a new Git repository with the .git directory.

Git

# Run the command 'git init' in your terminal

Need a hint?

Use the terminal or command prompt in your project folder and type git init.

2

List the contents of the .git directory

Use the command ls -a .git (Linux/macOS) or dir /a .git (Windows) to list all files and folders inside the .git directory.

Git

git init
# List the contents of the .git directory below

Need a hint?

On Windows, use dir /a .git instead of ls -a .git.

3

Identify key files and folders inside .git

Look for the presence of HEAD, config, refs, and objects inside the .git directory by running ls -a .git again and noting these names.

Git

git init
ls -a .git
# Check that .git contains HEAD, config, refs, and objects

Need a hint?

These files and folders are important for Git to track your project history and settings.

4

Display the contents of the HEAD file

Use the command cat .git/HEAD (Linux/macOS) or type .git\HEAD (Windows) to display the current branch reference stored in the HEAD file.

Git

git init
ls -a .git
# Display the contents of the .git/HEAD file below

Need a hint?

The HEAD file usually points to the current branch, like refs/heads/main.