This website requires JavaScript.

Configuration

Customizing shadcn-docs-nuxt.

1 min read

shadcn-docs-nuxt is configured through app.config.ts.

app.config.ts
export default defineAppConfig({
  shadcnDocs: {
    header: {
      xxx
    },
    aside: {
      xxx
    },
    main: {
      xxx
    },
    xxx
  },
});

Fields Reference

Illustrative type declarations:

interface ILink {
  title?: string;
  icon?: string;
  to: string;
  target?: string;
}

interface INav {
  title: string;
  links?: (ILink & { description: string })[];
  to?: string;
  target?: string;
}

site

namestring
The site name shown on the tap title: <page> - <site_name>.
descriptionstring
The site description for SEO.
ogImagestring
The path to the Open Graph image.

theme

customizableboolean
true
Whether the theme can be customized by the user (show the customize button in the header).
colorColor
zinc
The default color theme. https://www.shadcn-vue.com/themes.html
radiusstring
0.5
The default radius.

header

titlestring
The title shown on the header next to the icon.
showTitleboolean
true
Whether to show the title text on the header.
borderboolean
false
Whether to show the bottom border of the header.
darkModeToggleboolean
true
Whether to show the dark mode toggle.
logo{ light: string; dark: string; }
{ light: '/logo.svg', dark: '/logo-dark.svg' }
The path to the logo image files in /public. light is for the icon shown in light mode, dark is for the icon shown in dark mode.
showTitleInMobileboolean
false
Whether to show the logo and title in mobile. (Recommended to use with button styled search bar)
navINav[]
[]
The content of the navbar in the header.
linksILink[]
[]
The links on the right of the header.

aside

useLevelboolean
true
Whether to use level-styled sidebar.
collapseboolean
false
Whether to collapse all collapsible by default.

main

paddedboolean
true
Whether the page is padded.
breadCrumbboolean
true
Whether to show the bread crumb.
showTitleboolean
true
Whether to show the title section.
codeCopyToastboolean
true
Whether to show a toast on code copy.
codeIconRecord<string, string>
The icon mapping for language / filename in the code group header.

footer

creditsstring
''
The credit text on the left side of the footer.
linksILink[]
[]
The links on the right side of the footer.

toc

enableboolean
true
Whether to turn on the toc section.
enableInMobileboolean
false
Whether to turn on the toc section in mobile.
titlestring
'On This Page'
The title for the toc section.
linksILink[]
[]
The links under the toc section.

search

enableboolean
true
Whether to turn on the search feature.
inAsideboolean
false
Whether to show the search bar in the sidebar.
style'input' | 'button'
input
Whether the search bar is displayed as a input or a button.
Invalid Date
Previous page
Installation
Next page
Themes

šŸƒ Related posts