Kenhuang Academy
  • English

      • 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"