nuxt
diff --git a/‎docs/content/docs/2.collections/3.sources.md‎
Lines changed: 78 additions & 9 deletions b/‎docs/content/docs/2.collections/3.sources.md‎
Lines changed: 78 additions & 9 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 1 deletion b/‎package.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎playground/content.config.ts‎
Lines changed: 1 addition & 1 deletion b/‎playground/content.config.ts‎
Lines changed: 1 addition & 1 deletion
@@ -80,7 +80,7 @@ source: {
 
 ### `repository`
 
-External source representing a remote git repository URL (e.g., <https://github.com/nuxt/content>).
+External source representing a remote git repository URL (e.g., <https://github.com/nuxt/content>), or an object containing Git branch / tag information, or optionally authentication
 
 When defining an external source you must also define the `include` option.
 `include` pattern is essential for the module to know which files to use for the collection.
@@ -101,26 +101,95 @@ export default defineContentConfig({
 })
 ```
 
-### `authToken`
+#### `branch` / `tag`
+This option allows for cloning a Git repository by its tag or branch.
 
-Authentication token for private repositories (e.g., GitHub personal access token).
+**Example:**
+If you want to clone by a tag, make the `repository` attribute an object, with the `url` of your repository, and set the `tag` attribute.
+
+```js
+import { defineCollection, defineContentConfig } from '@nuxt/content'
+
+export default defineContentConfig({
+  collections: {
+    docs: defineCollection({
+      type: 'page',
+      source: {
+        repository: {
+          url: 'https://github.com/nuxt/content',
+          tag: 'v1'
+        },
+        include: 'docs/content/**',
+      },
+    })
+  }
+})
+```
+
+**Example:**
+
+If you want to clone by a remote branch, make the `repository` attribute an object, with the `url` of your repository, and set the `branch` attribute.
+
+```js
+import { defineCollection, defineContentConfig } from '@nuxt/content'
+
+export default defineContentConfig({
+  collections: {
+    docs: defineCollection({
+      type: 'page',
+      source: {
+        repository: {
+          url: 'https://github.com/nuxt/content',
+          branch: 'dev'
+        },
+        include: 'docs/content/**',
+      },
+    })
+  }
+})
+```
+
+#### `auth`
+
+This option allows for basic and token-based authentication for Git repositories.
 
 ::warning{icon="i-lucide-shield-alert"}
 Never commit authentication tokens or credentials directly in your code. Use environment variables or other secure methods to provide these values at runtime.
 ::
 
-### `authBasic`
+**Example:**
 
-Basic authentication for private repositories (e.g., Bitbucket username and password).
+If you want to use basic authentication (e.g. for BitBucket repositories), you can use:
 
 ```ts
 defineCollection({
   type: 'page',
   source: {
-    repository: 'https://bitbucket.org/username/repo',
-    authBasic: {
-      username: 'username',
-      password: 'password',
+    repository: {
+      url: 'https://bitbucket.org/username/repo',
+      auth: {
+        username: 'username',
+        password: 'password',
+      },
+    },
+  },
+})
+```
+
+**Example:**
+
+If you need to use authentication tokens (e.g. for Github, Gitlab, some Forgejo providers), you can do the following:
+
+```ts
+defineCollection({
+  type: 'page',
+  source: {
+    repository: {
+      url: 'https://github.com/username/repo',
+      auth: {
+        username: 'username',
+        token: 'password',
+      },
     },
   },
 })
 
@@ -73,6 +73,7 @@
     "destr": "^2.0.5",
     "git-url-parse": "^16.1.0",
     "hookable": "^5.5.3",
+    "isomorphic-git": "^1.33.1",
     "jiti": "^2.6.1",
     "json-schema-to-typescript": "^15.0.4",
     "knitwork": "^1.3.0",
@@ -86,7 +87,6 @@
     "micromatch": "^4.0.8",
     "minimark": "^0.2.0",
     "minimatch": "^10.1.1",
-    "modern-tar": "^0.7.2",
     "nuxt-component-meta": "0.15.0",
     "nypm": "^0.6.2",
     "ohash": "^2.0.11",
 
@@ -90,7 +90,7 @@ const collections = {
   nuxt: defineCollection({
     type: 'page',
     source: {
-      repository: 'https://github.com/nuxt/nuxt',
+      repository: 'https://github.com/nuxt/nuxt/tree/main',
       include: 'docs/**',
       prefix: '/nuxt',
       exclude: [