Creating a Git Repository

This chapter details how to create a Git repository, including creating a new one from scratch and cloning an existing one.

Ways to Create a Repository

Git repositories can be created in the following ways:

1. Initialize a new repository - git init
2. Clone an existing repository - git clone
3. Create from an existing project
4. Create using a template

Method 1: Initialize a New Repository

Basic Initialization

# Create project directory
mkdir my-new-project
cd my-new-project

# Initialize Git repository
git init

# Check result
ls -la

Output:

Initialized empty Git repository in /path/to/my-new-project/.git/

This creates a .git directory containing all necessary files for the Git repository.

Initialize with Specific Branch Name

# Initialize with a specified default branch name
git init --initial-branch=main
# Or shorthand
git init -b main

# Check current branch
git branch

Create a Bare Repository

A Bare Repository has no working directory and is usually used as a remote repository:

# Create bare repository
git init --bare my-bare-repo.git

# Check bare repository structure
ls my-bare-repo.git/

Bare repositories directly contain Git data without working directory files.

Basic Setup After Initialization

# Configure user info (if not set globally)
git config user.name "Your Name"
git config user.email "your.email@example.com"

# Create initial file
echo "# My New Project" > README.md
echo "This is a new Git project." >> README.md

# Create .gitignore file
cat > .gitignore << EOF
# Temporary files
*.tmp
*.log

# Editor files
.vscode/
.idea/

# System files
.DS_Store
Thumbs.db
EOF

# Add and commit initial files
git add README.md .gitignore
git commit -m "Initial commit: Add README and .gitignore"

Method 2: Clone Existing Repository

Basic Clone Operations

# Clone remote repository
git clone https://github.com/username/repository.git

# Clone to specific directory
git clone https://github.com/username/repository.git my-local-name

# Clone specific branch
git clone -b develop https://github.com/username/repository.git

Cloning with Different Protocols

HTTPS Clone

# Use HTTPS (Recommended for public repos)
git clone https://github.com/username/repository.git

SSH Clone

# Use SSH (Recommended for private repos, requires SSH key setup)
git clone git@github.com:username/repository.git

Local Clone

# Clone local repository
git clone /path/to/local/repository.git

# Clone local repository (relative path)
git clone ../other-project/.git my-project

Shallow Clone

For large repositories, you can use shallow clone to fetch only recent history:

# Clone only the last 1 commit
git clone --depth 1 https://github.com/username/repository.git

# Clone only the last 10 commits
git clone --depth 10 https://github.com/username/repository.git

# Fetch full history later
git fetch --unshallow

Partial Clone

Git 2.19+ supports partial clones to download only needed objects:

# Don't download blob objects (file contents)
git clone --filter=blob:none https://github.com/username/repository.git

# Don't download files larger than 1MB
git clone --filter=blob:limit=1m https://github.com/username/repository.git

Method 3: Create from Existing Project

Scenario: Existing Project Folder

# Enter existing project directory
cd existing-project

# Initialize Git repository
git init

# Add all files
git add .

# Create initial commit
git commit -m "Initial commit: Import existing project"

# Connect to remote repository (Optional)
git remote add origin https://github.com/username/existing-project.git
git push -u origin main

Handling Large Existing Projects

# Check project size
du -sh .

# Create appropriate .gitignore
echo "node_modules/" >> .gitignore
echo "*.log" >> .gitignore
echo "dist/" >> .gitignore

# Add files in batches
git add .gitignore
git commit -m "Add .gitignore"

git add src/
git commit -m "Add source code"