From b71c6f1bf345ebb2482186483cc9baf8a1259f6c Mon Sep 17 00:00:00 2001
From: Horu <73709188+HigherOrderLogic@users.noreply.github.com>
Date: Thu, 13 Feb 2025 01:21:44 +0700
Subject: [PATCH] docs: add tips on how to override layers aliases (#30970)

---
 docs/1.getting-started/9.layers.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/1.getting-started/9.layers.md b/docs/1.getting-started/9.layers.md
index 6365b16ad5..7dbb227bf0 100644
--- a/docs/1.getting-started/9.layers.md
+++ b/docs/1.getting-started/9.layers.md
@@ -53,6 +53,26 @@ export default defineNuxtConfig({
 })
 ```
 
+::tip
+You can override a layer's alias by specifying it in the options next to the layer source.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  extends: [
+    [
+      'github:my-themes/awesome',
+      { 
+        meta: {
+          name: 'my-awesome-theme',
+        },
+      },
+    ],
+  ]
+})
+```
+
+::
+
 Nuxt uses [unjs/c12](https://c12.unjs.io) and [unjs/giget](https://giget.unjs.io) for extending remote layers. Check the documentation for more information and all available options.
 
 ::read-more{to="/docs/guide/going-further/layers"}