Configuration

Customizing shadcn-docs-nuxt.

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.
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. light is for the icon shown in light mode, dark is for the icon shown in dark mode.
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

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.
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.
enableboolean
true
Whether to turn on the search feature.
inAsideboolean
false
Whether to show the search bar in the sidebar.