# Docusaurus themes

We provide official Docusaurus themes.

## Main themes

The main themes implement the user interface for the [docs](/guides/api-plugins-plugin-content-docs), [blog](/guides/api-plugins-plugin-content-blog) and [pages](/guides/api-plugins-plugin-content-pages) plugins.

- [@docusaurus/theme-classic](/guides/api-themes-theme-classic)
- 🚧 other themes are planned

:::callout{intent="warning"}
The goal is to have all themes share the exact same features, user-experience and configuration.

Only the UI design and underlying styling framework should change, and you should be able to change theme easily.

We are not there yet: only the classic theme is production ready.
:::

## Enhancement themes

These themes will enhance the existing main themes with additional user-interface related features.

- [@docusaurus/theme-live-codeblock](/guides/api-themes-theme-live-codeblock)
- [@docusaurus/theme-search-algolia](/guides/api-themes-theme-search-algolia)

## Related pages

- [Theme configuration](./api-themes-theme-configuration.md)
- [📦 theme-classic](./api-themes-theme-classic.md)
- [📦 theme-live-codeblock](./api-themes-theme-live-codeblock.md)
- [📦 theme-search-algolia](./api-themes-theme-search-algolia.md)
- [📦 theme-mermaid](./api-themes-theme-mermaid.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.