CodeBlanks Logo Icon CodeBlanks
Login Register

submodule add

Learn to add a submodule with git submodule add.

git submodule add

Use git submodule add to add a repository as a submodule to an existing project. Specify the nested repository URL first, followed by the target directory inside the parent repository. Git downloads the repository and creates the required submodule configuration.

git submodule add https://github.com/example/shared-ui.git libraries/shared-ui

The URL identifies the source repository, while the final argument specifies its location inside the project.

Choosing the submodule location

You can add a submodule using its default directory name or place it under a path of your choice. For example, you may want to group shared utilities under vendor/tools. Git creates the directory and places the nested repository there.

git submodule add https://github.com/example/dev-tools.git vendor/tools

Information about the added submodule is stored in the parent repository's .gitmodules file.

Practice Add a submodule to the project

Add the repository https://github.com/example/date-utils.git as a submodule in the parent project at vendor/date-utils.

Starter code

terminal
# Alt modülü belirtilen konuma ekle

Expected output

Cloning into 'vendor/date-utils'...
Submodule added.

Questions and answers

Review the lesson questions together with their answers. To test yourself, solve the lesson interactively.

1 When adding a submodule, which information do you specify after the repository URL?

  • The commit message
  • The target directory path Correct answer
  • The author name
  • The remote branch description

Explanation: After the URL, you specify the submodule's directory path inside the parent repository.

2 Add a submodule to a specific directory

Question 
git submodule add https://github.com/example/ui-kit.git ____
Answer 
git submodule add https://github.com/example/ui-kit.git packages/ui-kit

Explanation: The packages/ui-kit path after the URL specifies the submodule's location.

3 Submodule addition components

Term Meaning
git submodule add Command for adding a submodule
Depo URL'si Identifies the source repository
Hedef yol Defines the submodule location
.gitmodules Stores submodule configuration

All lessons in Advanced

1 Interactive rebase

  1. rebase -i
  2. pick reword squash
  3. edit drop
  4. Summary - Interactive rebase

2 Bisect

  1. git bisect
  2. good and bad
  3. Automatic bisect
  4. Summary - Bisect

3 Blame

  1. git blame
  2. Line history
  3. blame -L
  4. Summary - Blame

4 Submodule

  1. What is a submodule?
  2. submodule add
  3. submodule update
  4. Summary - Submodule

5 Worktree

  1. git worktree
  2. worktree add
  3. worktree list
  4. Summary - Worktree

6 Hooks

  1. What is a hook?
  2. pre-commit
  3. commit-msg
  4. Summary - Hooks

7 Advanced log

  1. --graph
  2. --format
  3. --since --until
  4. Summary - Advanced log

8 Archive

  1. git archive
  2. zip and tar
  3. Specific branch
  4. Summary - Archive

9 Advanced stash

  1. stash -u
  2. stash branch
  3. stash show -p
  4. Summary - Advanced stash

10 Advanced cherry-pick

  1. cherry-pick -n
  2. cherry-pick range
  3. cherry-pick strategy
  4. Summary - Advanced cherry-pick

11 Actions workflow

  1. matrix
  2. cache
  3. secrets
  4. Summary - Actions workflow

12 GitHub Pages

  1. What is Pages?
  2. Branch publish
  3. Custom domain
  4. Summary - GitHub Pages

13 Branch protection

  1. Protected branch
  2. Required review
  3. Status check
  4. Summary - Branch protection

14 Advanced final

  1. Rebase
  2. Bisect
  3. Submodule
  4. Hook