Major Changes

• e7e8e84: show react components, variable interpolation and latex in toc

• c7f03e5: remove toc.headingComponent

• ea1a736: remove next-seo and useNextSeoProps, use head option instead

• c2ad837: update to MDX3

• 148278c: rename tailwind prefix nx- to _ to reduce bundle size

• 919fe97: set "peerDependencies.next": ">=13"

• 47b125d: fix global style conflicts for <a>/<button>/<summary>/<input>/[tabindex]:not([tabindex='-1']

• ba30c6c: use render props for className with selected, disabled and hover state for <Tab>

• d7d8a3e: new styles for code blocks aka in next.js

• 2872606: remove image prop from <Card> component, image will be showed based on truthiness children prop now

  set icon as optional prop

• 63ca28b: Remove support of "_meta.json", use "_meta.{js,jsx,ts,tsx}" instead.

• ebe652d: remove sidebar.titleComponent, use JSX for styling separators and titles

• eca7535: - remove Steps, Callout, Tabs, Tab, Cards, Card, FileTree exports, export them now from nextra/components

  • remove useMDXComponents export, export it now from nextra/mdx
  • set by default sidebar.toggleButton to true

• 128e195: fix React warning, remove PageOpts.toc, use toc prop from components.wrapper

• 63ca28b: remove config.serverSideError

• f2dd18d: - rename theme config options

  i18n.text → i18n.name

  banner.text → banner.content

  editLink.text → editLink.content

  footer.text → footer.content

• 198dbcc: use toc with JSX elements for remote content

• 191e6c4: - use shikiji instead of shiki

  • rename useSSG to useData

• 6eb3118: rename primaryHue and primarySaturation theme options to color.hue and color.saturation

• c7f03e5: rename pageOpts.headings to toc

• 8c1b9d5: remove <MatchSorterSearch>

Minor Changes

• eb943d0: add theme.topContent and theme.bottomContent

• 0fe55db: add import { useRouter } from 'nextra/hooks' for fetching locale and defaultLocale

• c77485e: set default head option as null

• 1dcb91a: export useThemeConfig

• 6ec3241: Add Terraform/Move icon https://github.com/shuding/nextra/pull/2811 https://github.com/shuding/nextra/pull/2808

• 5a63701: add icons for following languages:

  • GraphQL (graphql)
  • C++ (c++, cpp)
  • C# (csharp, c#, cs)
  • Python (python, py)

  allow disallow mobile word wrap button in code blocks with word-wrap=false meta data setting

• a52a869: add frontmatter.sidebarTitle support for setting page label in sidebar via frontmatter

• 6ec3241: Make the <Tab> component be crawlable and indexable by search engines by default

• b47880d: export useMenu hook

• b776b16: add backgroundColor.light and backgroundColor.dark theme options

• 6070b02: rename frontmatter.sidebar_label to frontmatter.sidebarTitle

• 3043826: add shikiji twoslash

  Demo feature: https://nextra-v2-na3obnhub-shuding1.vercel.app/docs/guide/twoslash-support

• 6070b02: move removeLinks function from nextra-theme-docs to nextra/remove-links

• 962cea6: allow items: Map for type: 'menu' since object can't guaranty the insertion order

• 440ff42: add MathJax support

• 1a97327: keep loading, placeholder and themeSwitch.useOptions default theme options only for en lang

Patch Changes

• b045cc3: fix invisible mobile menu after click on hamburger

• eeb4c4c: enable outline: 'none' only for :focus-visible state, to fix double ring in Firefox

• 376b895: fixes case when setting disabled: true on the scroll to top button prevents scrolling to most top

  scroll to most top in toc element too

• 34e25cd: migrate search to @headlessui/react Combobox

• 73239c4: To ensure consistent horizontal padding, set the default language as plaintext for code blocks. This prevents any loss of formatting for code blocks without a specified language.

• 57f3963: Remove intersection-observer polyfill

• 2b9b95b: migrate to @headlessui/react v2

• 7457d6b: remove git-url-parse to keep bundle smaller

• 2a3e3e7: Fix first list item in <FileTree> not within permitted parent elements

• 6070b02: load flexsearch dynamically to reduce bundle size

• 0b4d43b: Avoid the sidebar collapse having unintended animations when sidebar.autoCollapse is set to true.

• 31c2ee7: fix removeLinks when input node is link

• bf963cd: Remove the aria-hidden attribute from scroll-to-top button when it is visible

• 829c417: - fix overflow when clicking on <details> with open state

  • fix animation on mobile when clicking on <details> with open state

• cb24790: fix broken export default statement in mdx files

• de56507: fix vertical margin for nested ordered <ol> and unordered <ul> lists

• 8c99baf: enhance search input to better support CJK language users

• a8c2196: use dynamic import for loading mermaid

• 0b5cc9d: make nextra compatible with windows

• 7b0b7e9: fix page scroll jump while entering characters in the search input

• 45471df: fix “Scroll to top” is not supposed to be interactable when it is hidden.

  display:children doesn't collapse breadcrumbs

  hide external links from pagination

  remove xmlns attribute from icons

• 8ffe2fe: remove focus-visible polyfill

• fe5061b: fix for remote docs

• 6945f38: fix not rendered default <meta name="description" /> and <meta property="og:description" />

• 1a634cd: remove explicit ZodError assertion

• ad108ff: use overflow-x-auto instead overflow-x-scroll for <Table>

• 4f0f6b2: Omit ...{:type} inline code annotations from search index #2922

• 150184b: attach heading anchor id attribute to heading (like Pagefind do) and fix heading anchor styles when theme.typesetting: 'article' is set

• 80c9764: ensure zod is removed from production build with /* @__PURE__ */ comments

• 9df7f58: Fix nav-links not highlighting on hover in dark mode

• 7bb18e3: Add a generic for themeConfig in NextraThemeLayoutProps to improve type inference.

• 9b41180: backToTop is hidden when enabled but when toc.extraContent, feedback.content and editLink.component are falsy

• 6f4c83a: fix unclickable links in TOC

  allow passing recmaPlugins in mdxOptions

• f255696: Improve styles for reduced motion preferences

• 9f55bd1: update rehype-pretty-code/shikiji to latest

• d21634d: export getComponents

• 452e5bd: Add <Playground> component

  https://nextra-v2-9x7fp6hti-shud.vercel.app/docs/guide/advanced/playground

• e95faa1: - fixed <summary> lost whitespaces when there is some HTML element inside

  • fixed hydration errors and <summary> was not rendered when <details> text content follows directly after <summary> element

• ccaf3d4: Add the autoImportThemeStyle option to the Nextra configuration. This allows users to import the official Nextra theme CSS into a specific cascade layer.

• cee94a6: Consider the navbar height when setting the root margin for the active anchor intersection observer

• 2630461: fix TypeError: undefined is not iterable (cannot read property Symbol(Symbol.iterator)) on dev environment when frontMatter.searchable: false

• 217f708: update next-themes

  fix wrong numbering for nested <Steps>

• ca51306: Enhance focus ring style consistency.

• f662237: avoid focus-visible style being cut off by overflow-hidden

• 3c6193d: Remove unnecessary sortPages from server/utils.ts

• 1a97327: Update the backToTop option in the docs theme configuration to support i18n

• 799174f: fixed react warning Warning: React has detected a change in the order of Hooks called by Body when themeConfig.main options is used

• 363b85f: add flex-shrink: 0 for indent in FileTree for <Ident> and svg icons in <Folder> and <File>

• 237c345: Make React 18 as minimal requirement

• eb943d0: hardcode flexsearch version to 0.7.31, because package is broken on 0.7.41

• ad108ff: fix <Bleed> overflows incorrectly in firefox

• 4fb2452: fix invisible mobile menu when layout: "raw" is specified in _meta file

• 7faa096: fix visible hidden pages on mobile which set up with display: 'hidden'

• 315ca82: remove possible links in toc elements

• a95e745: Fix the line highlighting background-color does not extend to the full width of the code block when a scrollbar appears with line numbers.

• 363b85f: fix RangeError: Maximum call stack size exceeded in findSummary when child.props.children is undefined

• Updated dependencies [e7e8e84]

• Updated dependencies [7188278]

• Updated dependencies [d1e3e9a]

• Updated dependencies [73239c4]

• Updated dependencies [2b9b95b]

• Updated dependencies [023d37b]

• Updated dependencies [0fe55db]

• Updated dependencies [50a52fd]

• Updated dependencies [c2ad837]

• Updated dependencies [2a3e3e7]

• Updated dependencies [a3b67ae]

• Updated dependencies [1a36469]

• Updated dependencies [799174f]

• Updated dependencies [98f439c]

• Updated dependencies [6ec3241]

• Updated dependencies [148278c]

• Updated dependencies [c7f03e5]

• Updated dependencies [3644e1c]

• Updated dependencies [919fe97]

• Updated dependencies [cb24790]

• Updated dependencies [47b125d]

• Updated dependencies [982862f]

• Updated dependencies [a8c2196]

• Updated dependencies [ba30c6c]

• Updated dependencies [0b5cc9d]

• Updated dependencies [5a63701]

• Updated dependencies [60ec68c]

• Updated dependencies [d7d8a3e]

• Updated dependencies [fe5061b]

• Updated dependencies [2872606]

• Updated dependencies [a52a869]

• Updated dependencies [6ec3241]

• Updated dependencies [1a634cd]

• Updated dependencies [63ca28b]

• Updated dependencies [ad108ff]

• Updated dependencies [ad4823d]

• Updated dependencies [4f0f6b2]

• Updated dependencies [1f3e7cd]

• Updated dependencies [ab07609]

• Updated dependencies [2f3be33]

• Updated dependencies [90c129e]

• Updated dependencies [f71e660]

• Updated dependencies [150184b]

• Updated dependencies [66cce1d]

• Updated dependencies [c74ae90]

• Updated dependencies [7615b62]

• Updated dependencies [6070b02]

• Updated dependencies [7bb18e3]

• Updated dependencies [b9f88e3]

• Updated dependencies [8efbb45]

• Updated dependencies [6f4c83a]

• Updated dependencies [d8a406b]

• Updated dependencies [9f55bd1]

• Updated dependencies [4e55c06]

• Updated dependencies [128e195]

• Updated dependencies [8bce16d]

• Updated dependencies [ccaf3d4]

• Updated dependencies [3043826]

• Updated dependencies [2630461]

• Updated dependencies [576cb6f]

• Updated dependencies [217f708]

• Updated dependencies [57bc0e2]

• Updated dependencies [ca51306]

• Updated dependencies [f662237]

• Updated dependencies [3c6193d]

• Updated dependencies [1f3e7cd]

• Updated dependencies [198dbcc]

• Updated dependencies [363b85f]

• Updated dependencies [fef635e]

• Updated dependencies [6070b02]

• Updated dependencies [237c345]

• Updated dependencies [191e6c4]

• Updated dependencies [440ff42]

• Updated dependencies [7faa096]

• Updated dependencies [9099c35]

• Updated dependencies [98f439c]

• Updated dependencies [a95e745]

• Updated dependencies [80e11e0]

• Updated dependencies [c7f03e5]

  • nextra@3.0.0