From 765b640971b8d10fec976b363dddf34908a0b4b0 Mon Sep 17 00:00:00 2001
From: Aviv Keller <me@aviv.sh>
Date: Wed, 26 Mar 2025 09:15:25 -0400
Subject: [PATCH] feat(install): add instructions for git packages

---
 ...oading-and-installing-packages-locally.mdx | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/content/packages-and-modules/getting-packages-from-the-registry/downloading-and-installing-packages-locally.mdx b/content/packages-and-modules/getting-packages-from-the-registry/downloading-and-installing-packages-locally.mdx
index f73e2d8258a..d18ee285b59 100644
--- a/content/packages-and-modules/getting-packages-from-the-registry/downloading-and-installing-packages-locally.mdx
+++ b/content/packages-and-modules/getting-packages-from-the-registry/downloading-and-installing-packages-locally.mdx
@@ -41,6 +41,60 @@ npm install @scope/package-name
 npm install @scope/private-package-name
 ```
 
+## Installing a package from Git
+
+You can install a package directly from a Git repository using the following format:
+
+```
+npm install <git-remote-url>
+```
+
+For example, to install a package from a GitHub repository, run:
+
+```
+npm install git+https://github.com/user/repo.git
+```
+
+If you need a specific branch, tag, or commit, you can specify it after the `#` symbol:
+
+```
+npm install git+https://github.com/user/repo.git#branch-name
+npm install git+https://github.com/user/repo.git#tag-name
+npm install git+https://github.com/user/repo.git#commit-hash
+```
+
+## Installing a package from a GitHub shortcut
+
+npm allows shorthand notation for installing from GitHub:
+
+```
+npm install user/repo
+```
+
+To install from a specific branch, tag, or commit:
+
+```
+npm install user/repo#branch-name
+npm install user/repo#tag-name
+npm install user/repo#commit-hash
+```
+
+## Installing a package from a Git subdirectory
+
+Some repositories contain multiple packages in subdirectories. You can install a package from a specific subdirectory using:
+
+```
+npm install git+https://github.com/user/repo.git#commit-hash::path:path/to/subdirectory
+npm install user/repo#commit-hash::path:path/to/subdirectory
+```
+
+For example:
+
+```
+npm install git+https://github.com/user/repo.git#main::path:packages/my-package
+npm install user/repo#main::path:packages/my-package
+```
+
 ## Testing package installation
 
 To confirm that `npm install` worked correctly, in your module directory, check that a `node_modules` directory exists and that it contains a directory for the package(s) you installed: