feat(config): add themeDir option

vuejs · Jan 4, 2024 · 2aefd57 · 2aefd57
1 parent d279e63
commit 2aefd57
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 1 deletion.
diff --git a/docs/reference/site-config.md b/docs/reference/site-config.md
@@ -437,6 +437,19 @@ export default {
 }
 ```
 
+### themeDir
+
+- Type: `string`
+- Default: `./.vitepress/theme` if exists, otherwise [Default Theme](../guide/extending-default-theme) path.
+
+The directory of the [theme entry file](../guide/custom-theme#theme-resolving), relative to [project root](../guide/routing#root-and-source-directory).
+
+```ts
+export default {
+  themeDir: './awesome-theme'
+}
+```
+
 ### ignoreDeadLinks
 
 - Type: `boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[]`

diff --git a/src/node/config.ts b/src/node/config.ts
@@ -97,7 +97,10 @@ export async function resolveConfig(
   }
 
   // resolve theme path
-  const userThemeDir = resolve(root, 'theme')
+  const userThemeDir = userConfig.themeDir
+    ? normalizePath(path.resolve(root, userConfig.themeDir))
+    : resolve(root, 'theme')
+
   const themeDir = (await fs.pathExists(userThemeDir))
     ? userThemeDir
     : DEFAULT_THEME_PATH

diff --git a/src/node/siteConfig.ts b/src/node/siteConfig.ts
@@ -64,6 +64,7 @@ export interface UserConfig<ThemeConfig = any>
   outDir?: string
   assetsDir?: string
   cacheDir?: string
+  themeDir?: string
 
   shouldPreload?: (link: string, page: string) => boolean