@aeei/docusaurus-theme

A compiled shadcn Base Nova theme for Docusaurus documentation.

Features

• shadcn 4.12.0 Base Nova components backed by Base UI
• official Neutral light/dark tokens, Geist, Pretendard Korean fallback, Geist Mono, and Lucide
• responsive GNB, sticky/collapsible LNB, TOC, paginator, and footer
• Markdown, GFM, MDX, admonitions, tabs, code blocks, and Mermaid
• optional build-time local search or Algolia DocSearch
• optional page-level Markdown copy/view using the official Base Nova ButtonGroup
• compiled CSS; consumers need no Tailwind or Sass configuration
• SSR-safe responsive layout and keyboard/focus behavior

Install

npm install @aeei/docusaurus-theme \
@docusaurus/core @docusaurus/plugin-content-docs \
@docusaurus/preset-classic @docusaurus/theme-common

Minimal configuration:

// docusaurus.config.tsimporttype{Config}from"@docusaurus/types";constconfig: Config={presets: ["classic"],themes: ["@aeei/docusaurus-theme"],themeConfig: {colorMode: {defaultMode: "light",disableSwitch: false,respectPrefersColorScheme: true,},docs: {sidebar: {hideable: true,autoCollapseCategories: false,},},},};exportdefaultconfig;

The package ships Base Nova tokens, fonts, preflight, animations, and compiled theme CSS. Consumer Tailwind/Sass config is neither required nor read.

Container width

The navbar, docs content, footer, OpenAPI layout, and large dialogs share a 90rem maximum width by default. Set one theme option to use a narrower or wider constant:

themes: [["@aeei/docusaurus-theme",{containerMaxWidth: "80rem"}],],

Positive px/rem strings are accepted. Numbers are interpreted as pixels.

Search

Search is disabled by default.

Local search

themes: [["@aeei/docusaurus-theme",{search: "local"}]];

Each production build extracts rendered Markdown/MDX routes into build/search-index.json. The browser fetches that same-origin index only when search opens. Protect the index behind the same auth/network boundary as private docs.

Algolia

themes: [["@aeei/docusaurus-theme",{search: "algolia"}]],themeConfig: {algolia: {appId: process.env.ALGOLIA_APP_ID,apiKey: process.env.ALGOLIA_SEARCH_API_KEY,indexName: process.env.ALGOLIA_INDEX_NAME,},},

Use a public Search API key, never an Admin API key.

Copy Page

The visual control is theme-native Base Nova. Markdown route generation is delegated to docusaurus-plugin-copy-page-button; its injected UI is disabled.

npm install docusaurus-plugin-copy-page-button

plugins: [["docusaurus-plugin-copy-page-button",{injectButton: false,generateMarkdownRoutes: true},],],themes: [["@aeei/docusaurus-theme",{copyPage: true}],],

The primary action copies the generated Markdown. The menu can view the .md route or copy its link. External AI actions are intentionally excluded for private-doc safety.

Mermaid

npm install @docusaurus/theme-mermaid @mermaid-js/layout-elk

markdown: {mermaid: true},themes: ["@docusaurus/theme-mermaid","@aeei/docusaurus-theme"],

Starter

examples/docs-starter is the live-demo source and a copyable docs-first starter. Routine authors edit:

docs/**/*.md
docs/**/*.mdx
static/**

• Markdown and GFM
• Search and Copy Page
• MDX components
• Mermaid diagrams

Development

yarn install
yarn workspace @aeei/docusaurus-theme build
yarn workspace @aeei/docs-starter start

Production smoke:

yarn workspace @aeei/docusaurus-theme build
yarn workspace @aeei/docs-starter build

Publishing to npm

Maintainers only, after explicit visual approval:

yarn workspace @aeei/docusaurus-theme build
cd packages/docusaurus-theme
npm pack --dry-run
npm publish --access public

Requirements:

• npm account authorized for the @aeei scope
• npm login/2FA completed
• package version not already published
• theme build, starter build, isolated tarball build, Jest, TypeScript/LSP, Playwright, and visual evidence passing

Consumers then install a pinned release:

npm install @aeei/docusaurus-theme@0.1.11

This repository does not publish automatically from an unapproved working tree.

Attribution

This repository is a modified fork of PaloAltoNetworks/docusaurus-openapi-docs. It is maintained independently and is not an official Palo Alto Networks project.

See THIRD_PARTY_NOTICES.md and package LICENSES/ for Docusaurus, shadcn/ui, Base UI, Lucide, Mermaid, Geist, Pretendard, animation, and upstream notices.

License

MIT. Existing upstream copyright and permission notices are preserved.