atlas-docs Theme
Configure the atlas-docs reader theme and its top navigation model.
`atlas-docs` is the built-in header-led reader theme. Use it when your docs site needs a top navigation layer that switches between major knowledge areas.
Layout and best fit
This theme puts branding and major groups in the header, then shows the current group's navigation in the sidebar. It fits product docs, developer portals, and sites that want to separate areas such as Guides, API, and Reference.
Required companion config
Switching `site.theme.id` to `atlas-docs` is only part of the setup. You also need `site.navigation.topNav`. The current contract supports two top-nav item types: `nav-group` and `external`. A `nav-group.groupId` must point at a top-level `section` or `folder` id in every enabled language navigation file.
What you can configure today
`atlas-docs` supports reader branding fields such as `siteTitle`, `logoSrc`, and `logoAlt`. It also supports `site.theme.chrome.showSearch`, `site.theme.codeTheme`, and the shared color tokens `primary`, `primaryForeground`, `accent`, and `accentForeground`.
Runtime behavior
`atlas-docs` supports search and language switching, and does not currently support dark mode. Top navigation labels can be localized by language, and external items can optionally open in a new tab.