Nextra 3 x Pages Router (#2245)

* [v3] use `overflow-x-auto` instead `overflow-x-scroll` for `<Table />` (#2828)

* aa

* aa

* [v3] Add Terraform icon (#2811)

* [v3] Add terraform codeblock icon

* [v3] Fix lint nextra-theme-docs

* Add Terraform/Move icon, Make the `<Tab />` component be crawlable and indexable by search engines by default (#2829)

* add

* Make the `<Tab />` component be crawlable and indexable by search engines by default

* Version Packages (alpha) (#2790)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix unclickable links in TOC / allow passing `recmaPlugins` in `mdxOptions` (#2866)

aa

* Version Packages (alpha) (#2867)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] fix vertical margin for nested ordered `<ol />` and unordered `<ul />` lists (#2969)

* fix

* prettier

* use pnpm/action-setup@v4

* Version Packages (alpha) (#2970)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] fixes case when setting `disabled: true` on the scroll to top button prevents scrolling to most top (#2981)

aa

* update pnpm & prettier (#2983)

* update prettier

* update pnpm

* [v3] fix page scroll jump while entering characters in the search input (#2984)

aa

* update next.js to 14.2.5 (#2985)

* Version Packages (alpha) (#2982)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* update eslint deps (#2986)

* update eslint deps

* aa

* prettier

* [v3] fixed `<summary />` lost whitespaces when there is some HTML element inside (#2987)

* aa

* aa

* aa

* changeset

* prettier

* aa

* prettier

* rollback

* rollback

* aa

* prettier

* aa

* [v3] Fix the line-numbers style in syntax highlighting (#2929)

* Fix the line-numbers style in syntax highlighting

* Update .changeset/warm-cameras-vanish.md

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Omit `...{:type}` annotations from search index (#2922)

* Omit `...{:type}` annotations from search index

* Prettier

* Lint

* Update packages/nextra/src/server/remark-plugins/remark-structurize.ts

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Lint

* polish

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* add missing changeset

* Version Packages (alpha) (#2989)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* prettify

* fix(deps): update dependency @vercel/og to ^0.6.0 (#3005)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency sharp to ^0.33.0 (#3006)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency jsdom to v24 (#3008)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* update node version

* use node.js 20

* add `node-version-file: .node-version`

* fix(deps): update dependency katex to v0.16.10 [security] (#3001)

* fix(deps): update dependency katex to v0.16.10 [security]

* fix types check

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency autoprefixer to v10.4.19 (#2996)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency rimraf to v5.0.9 (#2998)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @tailwindcss/typography to v0.5.13 (#3002)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v1.7.19 (#3009)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency unified to v11.0.5 (#3000)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tailwindcss to v3.4.6 (#2999)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @napi-rs/simple-git to v0.1.17 (#3010)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency postcss to v8.4.39 (#2997)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency katex to v0.16.11 (#3011)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency rehype-pretty-code to v0.13.2 (#3012)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dawidd6/action-download-artifact action to v6 (#3013)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] use dynamic import for loading `mermaid` (#2994)

* update mermaid

* update mermaid

* pnpm i

* use stable version

* chore(deps): update dependency postcss-import to v16 (#3016)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @testing-library/react to v16 (#3014)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency postcss-cli to v11 (#3015)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.14.11 (#3019)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @svgr/webpack to v8.1.0 (#3018)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency estree-util-value-to-estree to v3.1.2 (#3028)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency rimraf to v6 (#3034)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v10.18.0 (#3029)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency remark-smartypants to v3 (#3040)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tsx to v4.16.2 (#3023)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency turbo to v1.13.4 (#3024)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency clsx to v2.1.1 (#3027)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency zod to v3.23.8 (#3031)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency yaml to v2.4.5 (#3030)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update react monorepo (#3026)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix types check, update turbo

* update eslint-plugin-tailwindcss

* fix(deps): update dependency zod-validation-error to v3 (#3041)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency p-limit to v6 (#3039)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11 (#3038)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @changesets/cli to v2.27.7 (#3004)

* chore(deps): update dependency @changesets/cli to v2.27.7

* aa

* commit lock

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency @vitejs/plugin-react to v4.3.1 (#3020)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency typescript to v5.5.3 (#3025)

* chore(deps): update dependency typescript to v5.5.3

* bump ts

* bump ts

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency jsdom to v24.1.1 (#3042)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency vitest to v2.0.4 (#3045)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] fix `RangeError: Maximum call stack size exceeded` in `findSummary` when `child.props.children` is `undefined` (#3046)

* aa

* aa

* Version Packages (alpha) (#3017)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.3.9 (#3050)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency eslint-plugin-sonarjs to v1.0.4-alpha.2 (#3049)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency typescript to v5.5.4 (#3043)

* chore(deps): update dependency typescript to v5.5.4

* fix

* lint

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* fix(deps): update dependency framer-motion to v11.3.11 (#3051)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.3.18 (#3053)

fix(deps): update dependency framer-motion to v11.3.12

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency postcss to v8.4.40 (#3057)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.14.12 (#3054)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency eslint-plugin-sonarjs to v1.0.4 (#3052)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency yaml to v2.5.0 (#3056)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* ignore loading pageMap for dynamic locale `/[locale]` (#3061)

* Revert "fix(deps): update dependency yaml to v2.5.0" (#3064)

Revert "fix(deps): update dependency yaml to v2.5.0 (#3056)"

This reverts commit 04654df.

* fix(deps): update dependency framer-motion to v11.3.18 (#3063)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tailwindcss to v3.4.7 (#3062)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* update eslint to 9.8.0 (#3066)

* update eslint to 9.8.0

* vite

* configure eslint-plugin-react-hooks updates

* chore(deps): update dependency eslint-plugin-unicorn to v55 (#3068)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency yaml to v2.5.0 (#3067)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Version Packages (alpha) (#3065)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix `useRouter` in `nextra/hooks`, use `asPath` instead `route` because locale can be dynamic `/[locale]` (#3075)

aa

* fix(deps): update dependency framer-motion to v11.3.19 (#3071)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.14.13 (#3073)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Version Packages (alpha) (#3076)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] handle case when meta object was added in `transformPageMap` (#3078)

aa

* Version Packages (alpha) (#3079)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* chore(deps): update dependency turbo to v2.0.10 (#3080)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency vitest to v2.0.5 (#3083)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Update renovate.json5

* fix(deps): update dependency framer-motion to v11.3.21 (#3087)

fix(deps): update dependency framer-motion to v11.3.20

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency zod-validation-error to v3.3.1 (#3088)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency turbo to v2.0.11 (#3085)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tsx to v4.16.5 (#3081)

chore(deps): update dependency tsx to v4.16.3

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* update typescript-eslint (#3095)

* chore(deps): update dependency tsx to v4.16.5 (#3094)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.14.14 (#3093)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.3.21 (#3096)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* update renovate.json5

* update renovate.json5

* chore(deps): update dependency autoprefixer to v10.4.20 (#3098)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency postcss to v8.4.41 (#3102)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency turbo to v2.0.12 (#3105)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.3.24 (#3107)

fix(deps): update dependency framer-motion to v11.3.22

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] remove unnecessary `sortPages` from `server/utils` (#3129)

* [v3] fixes for some found issues in `the-guild.dev` (#3130)

a

* [v3] fix theme-blog heading styles in post layout (#3117)

* [v3] fix theme-blog heading styles in post layout

* remove more `_not-prose`

* small fix

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] attach heading anchor `id` attribute to heading (like Pagefind do) and fix heading anchor styles when `theme.typesetting: 'article'` is set (#3132)

aa

* [v3] specify default language for code blocks (#3108)

[v3] specify the default language as plaintext for code blocks

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] switch to the dark theme provided by `@tailwindcss/typography` (#3120)

* [v3] switch to the dark theme provided by `tailwindcss/typography`

* prettier

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] fix nav-links not highlighting on hover in dark mode (#3109)

* [v3] fix nav-links not highlighting on hover in dark mode

* update .changeset/polite-baboons-look.md

* fix

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] Avoid skipping the heading level in the posts layout (#3100)

* [v3] Avoid skipping the heading level in the posts layout

* polish

* Update .changeset/gold-ants-tie.md

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Version Packages (alpha) (#3131)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] fix not rendered default `<meta name="description" />` and `<meta property="og:description" />` (#3133)

* aa

* prettier

* [v3] add a generic for `themeConfig` to improve type inference (#3140)

* Version Packages (alpha) (#3134)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] remove explicit `ZodError` type assertion (#3143)

* [v3] remove focus-visible polyfill (#3145)

* [v3] enhance search input to better support CJK language users (#3156)

* [v3] enhance search input to better support CJK language users

* update code formatting

* fix summary typo

* update code formatting

* Version Packages (alpha) (#3144)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* chore(deps): update dependency tsx to v4.19.0 (#3115)

* chore(deps): update dependency tsx to v4.19.0

* aa

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency jsdom to v25 (#3168)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency rehype-pretty-code to v0.14.0 (#3167)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.2 (#3114)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency rehype-katex to v7.0.1 (#3164)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tailwindcss to v3.4.10 (#3111)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @testing-library/react to v16.0.1 (#3161)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @napi-rs/simple-git to v0.1.19 (#3162)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency turbo to v2.1.1 (#3166)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency sharp to v0.33.5 (#3165)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @tailwindcss/typography to v0.5.15 (#3110)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] avoid focus-visible style being cut off by overflow-hidden (#3160)

aa

* chore(deps): update dependency @types/react to v18.3.5 (#3169)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] Avoid the sidebar collapse having unintended animations when `sidebar.autoCollapse` is set to `true` (#3157)

* more

* more

* more

* more

* aa

* fix lint

* chore(deps): update dependency postcss-lightningcss to v1.0.1 (#3171)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency esbuild to v0.23.1 (#3170)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @theguild/remark-mermaid to ^0.1.0 (#3173)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] Add `<Playground />` component (#3174)

* [nextra] Playground

* move to nextra.site

* polish

* prettier

* more

* fix types

* more

* rename

* rename

* more

* more

* more

* more

* add mermaid code block

* it works

* aaa

* dada

* ad

* fix prettier

* polish

* more

* pnpm i

* fix

* fix tests

* do not increase global bundle size

* add changeset

---------

Co-authored-by: hariria <[email protected]>

* Version Packages (alpha) (#3172)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* chore(deps): update dependency eslint-plugin-sonarjs to v2 (#3175)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] remove intersection-observer polyfill (#3177)

* chore(deps): update dependency postcss to v8.4.42 (#3180)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* update mermaid (#3179)

* a

* update mermaid

* upd

* [v3] update remark plugins (#3181)

* update some of remark plugins

* upd

* fix(deps): update shiki monorepo to v1.15.2 (#3032)

* fix(deps): update shiki monorepo to v1.15.1

* upd

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* fix(deps): update shiki monorepo to v1.15.2 (#3184)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.3 (#3187)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v2 (#3037)

* fix(deps): update dependency @headlessui/react to v2

* more

* more

* more

* prettier

* remove popper

* upd lock

* more

* migrate navbar

* lint

* add changeset

* Update .changeset/clever-timers-impress.md

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* fix(deps): update shiki monorepo to v1.16.0 (#3189)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] migrate search to `@headlessui/react` Combobox (#3186)

* fix(deps): update dependency @headlessui/react to v2

* more

* more

* more

* prettier

* remove popper

* upd lock

* more

* migrate navbar

* lint

* add changeset

* migrate search to headlessui

* Update packages/nextra-theme-docs/src/components/search.tsx

* remove `@popperjs/core`

* clear input after navigating

fixes

* lint

* more nice refactoring

* more stuff

* remove `onCompositionStart` and `onCompositionEnd`

* review fixes

* remove on key down

* fix lint

* skip test

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update shiki monorepo to v1.16.1 (#3190)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* tiny fixes after headlessui v2 migration (#3191)

* tiny fixes after headlessui v2 migration 2 (#3193)

* fix TabList scroll, and selected color
convert `arrow-right.tsx` and `expand.tsx` to svg
disable scroll on `<body />` while mobile menu is opened

* more

* aa

* try

* add shrink-0

* Version Packages (alpha) (#3178)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v2.1.4 (#3195)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.4 (#3197)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency yaml to v2.5.1 (#3198)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency postcss to v8.4.45 (#3188)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v2.1.5 (#3202)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.5 (#3204)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update shiki monorepo to v1.16.2 (#3205)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix `<details />` on mobile (#3206)

* more

* more

* more

* polish

* Apply suggestions from code review

* fix(deps): update dependency @headlessui/react to v2.1.6 (#3218)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update shiki monorepo to v1.16.3 (#3216)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] fix first item in `FileTree` not within permitted parent element (#3212)

* [v3] fix first item in `FileTree` not within permitted parent element

* Update packages/nextra/src/client/components/file-tree.tsx

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency concurrently to v9 (#3211)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Version Packages (alpha) (#3210)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v2.1.7 (#3222)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tailwindcss to v3.4.11 (#3223)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] add auto-import-theme-style option in nextra configuration (#3220)

* [v3] add auto-import-theme-style option in nextra configuration

* remove the style field in `package.json`

* Update .changeset/red-rockets-perform.md

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* dry in styles.css swr-site example

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Version Packages (alpha) (#3224)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* fix(deps): update shiki monorepo to v1.17.0 (#3221)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency typescript to v5.6.2 (#3217)

* chore(deps): update dependency typescript to v5.5.3

* bump ts

* bump ts

* chore(deps): update dependency typescript to v5.6.2

* fix

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency tsx to v4.19.1 (#3227)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency concurrently to v9.0.1 (#3226)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @headlessui/react to v2.1.8 (#3228)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] improve styles for reduced motion preferences (#3196)

* [v3] improve styles for reduced motion preferences

* fix clear timeout missing

* add a passive option to resize listener

* Update packages/nextra-theme-docs/src/components/sidebar.tsx

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* polish

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* polish

* fix(deps): update dependency framer-motion to v11.5.4 (#3116)

fix(deps): update dependency framer-motion to v11.5.0

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* docs: _meta.js documentation (#2950)

* docs: _meta.js documentation

* Apply suggestions from code review

* prettier

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency vitest to v2.1.0 (#3232)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.5.4 (#3233)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] add documentation for customize the cascade layers (#3234)

* [v3] add documentation for customize the cascade layers

* Update docs/pages/docs/guide/customize-the-cascade-layers.mdx

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Update docs/pages/docs/guide/customize-the-cascade-layers.mdx

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* rename to _app.jsx

* Update docs/pages/docs/guide/customize-the-cascade-layers.mdx

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Revert "rename to _app.jsx"

This reverts commit 01f6d88.

* rename to _app.jsx

* move to the advanced folder

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency turbo to v2.1.2 (#3238)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] remove `image` prop from `<Card>` component, image will be showed based on truthiness `children` prop now (#3243)

* a

* b

* add changeset

* Update packages/nextra/src/client/components/cards.tsx

* chore(deps): update dependency vitest to v2.1.1 (#3245)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] use render props for className with `selected`, `disabled` and `hover` state for `<Tab>` (#3244)

* use render props for className with `selected`, `disabled` and `hover` state for `<Tab>`

* fix border primary

* [v3] fix global style conflicts for `<a>`/`<button>`/`<summary>`/`<input>`/`[tabindex]:not([tabindex='-1']` (#3248)

* aa

* more

* more

* icons

* button

* more

* more

* more

* focusable

* aa

* more

* more

* summary and anchor in heading

* toc

* breadcrumb

* banner

* navlinks

* anchor

* tabs

* aa

* aa

* more

* aa

* aa

* aa

* changeset

* Apply suggestions from code review

* Update docs/pages/docs/guide/syntax-highlighting.mdx

* Update docs/pages/docs/guide/syntax-highlighting.mdx

* Update packages/nextra-theme-docs/src/components/back-to-top.tsx

* Update packages/nextra/src/client/components/file-tree.tsx

* Update packages/nextra/src/client/components/file-tree.tsx

* more

* more

* polish

* Update packages/nextra-theme-docs/src/components/navbar.tsx

* more

* more

* more

* Update .changeset/giant-jobs-watch.md

* chore(deps): update dependency postcss to v8.4.47 (#3247)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Version Packages (alpha) (#3231)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* [v3] consider navbar height for the anchor intersection observer (#3249)

* [v3] consider navbar height for the anchor intersection observer

* fix root margin must be specified in pixels or percent

* polish

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] remove aria-hidden attr when scroll-to-top button is visible (#3251)

* [v3] remove aria-hidden attr when scroll-to-top button is visible

* Update packages/nextra-theme-docs/src/components/back-to-top.tsx

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* chore(deps): update dependency @types/react to v18.3.6 (#3253)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency zod-validation-error to v3.4.0 (#3252)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] support for h2 and h4 headings with steps component (#3237)

* [v3] support h2 headings with steps component

* support for h2 and h4 headings with steps component

* polish

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Version Packages (alpha) (#3250)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.7 (#3256)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] make react 18 as minimal requirement (#3260)

* chore(deps): update dependency esbuild to v0.24.0 (#3269)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.5.6 (#3266)

fix(deps): update dependency framer-motion to v11.5.5

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.8 (#3267)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @vercel/og to v0.6.3 (#3265)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency jsdom to v25.0.1 (#3271)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* bump lint (#3274)

* chore(deps): update dependency tailwindcss to v3.4.12 (#3257)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.8 (#3276)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency jsdom to v25.0.1 (#3277)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.5.6 (#3278)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency zod-validation-error to v3.4.0 (#3279)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Version Packages (alpha) (#3261)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* chore(deps): update dependency @rollup/plugin-alias to v5.1.1 (#3282)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency tailwindcss to v3.4.13 (#3283)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.6.0 (#3287)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.9 (#3285)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] enhance focus ring style consistency (#3286)

* [v3] enhance focus ring style consistency

* Update tabs.tsx

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* fix focus param missing

* Update packages/nextra-theme-docs/css/styles.css

Co-authored-by: Dimitri POSTOLOV <[email protected]>

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* pnpm i

* fix(deps): update dependency framer-motion to v11.8.0 (#3294)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.9 (#3284)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.9 (#3293)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency vite to v5.4.8 (#3296)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency next to v14.2.13 (#3295)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency @theguild/remark-mermaid to v0.1.3 (#3297)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(deps): update dependency framer-motion to v11.9.0 (#3302)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/node to v20.16.10 (#3300)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): update dependency @types/react to v18.3.10 (#3301)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* [v3] update the back-to-top option to support i18n (#3258)

* [v3] update the back-to-top option to support i18n

* fix eslint sort-keys warning

* avoid displaying undefined as text

* keep `loading`, `placeholder` and `themeSwitch.useOptions` default theme options only for `en` lang

* keep it simpler

* lint

* prettier

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Version Packages (alpha) (#3292)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* Feature/Added-typescript-documentation (#3254)

* Added typescript documentation

* upd

---------

Co-authored-by: Nicolas Javkin <[email protected]>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Add ISSUE_TEMPLATE and PULL_REQUEST_TEMPLATE (#2875)

* Add ISSUE_TEMPLATE and PULL_REQUEST_TEMPLATE

Add ISSUE_TEMPLATE and PULL_REQUEST_TEMPLATE to the .github directory. These templates are designed to assist contributors in reporting issues and submitting pull requests by providing guidance on the necessary information to include. This helps streamline the contribution process for both issue reporting and pull requests.

* prettier

---------

Co-authored-by: Fun117 <[email protected]>
Co-authored-by: Dimitri POSTOLOV <[email protected]>

* docs: Update steps.mdx documentation (#2232)

* Update steps.mdx

Update the docs about the <Steps /> component with the information on how to exclude the headings from ToC.

* Update docs/pages/docs/guide/built-ins/steps.mdx

* Update docs/pages/docs/guide/built-ins/steps.mdx

* polish

* prettier

* Update docs/pages/docs/guide/built-ins/steps.mdx

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Created cards.mdx (#1870)

* Created cards.mdx

New docs page for the Docs Theme on the Cards component

* fix

* prettier

* more

* more

* more

* more

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Update i18n.mdx (#2739)

* Update i18n.mdx

The i18n new format is working good!

* add note

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* Update start.mdx - static exports (#2563)

* Update start.mdx - static exports

added documentation on how to statically deploy the documentation, and how to edit the next.config.js

* more

* more

* more

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>

* [v3] more docs polish content before stable release (#3304)

* polish

* polish custom theme

* more

* more

* more

* more

* more

* more

* more

* more

* more

* polish

* more

* more

* Update docs/pages/docs/docs-theme.mdx

* more

* more

* pre exit

* Version Packages (#3305)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>
Co-authored-by: Andrew Hariri <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: 87xie <[email protected]>
Co-authored-by: Jason Siefken <[email protected]>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Andrii Bodnar <[email protected]>
Co-authored-by: nicojav <[email protected]>
Co-authored-by: Nicolas Javkin <[email protected]>
Co-authored-by: Fun117 <[email protected]>
Co-authored-by: Fun117 <[email protected]>
Co-authored-by: Vlasta <[email protected]>
Co-authored-by: Evan Koumarelas <[email protected]>
Co-authored-by: Abdelrahman Ragab <[email protected]>
Co-authored-by: Samuel <[email protected]>

.eslintrc.cjs

@@ -13,7 +13,7 @@ const TAILWIND_CONFIG = {
 module.exports = {
   root: true,
   reportUnusedDisableDirectives: true,
-  ignorePatterns: ['next-env.d.ts'],
+  ignorePatterns: ['next-env.d.ts', 'generated-page-map.js'],
   overrides: [
     // Rules for all files
     {
@@ -24,8 +24,12 @@ module.exports = {
         'plugin:import/typescript',
         'prettier'
       ],
-      plugins: ['import', 'unicorn'],
+      plugins: ['import', 'unicorn', 'sonarjs'],
       rules: {
+        'no-extra-boolean-cast': [
+          'error',
+          { enforceForInnerExpressions: true }
+        ],
         'prefer-object-has-own': 'error',
         'logical-assignment-operators': [
           'error',
@@ -47,6 +51,24 @@ module.exports = {
         'unicorn/no-array-for-each': 'error',
         'unicorn/prefer-string-replace-all': 'error',
         '@typescript-eslint/prefer-for-of': 'error',
+        quotes: ['error', 'single', { avoidEscape: true }], // Matches Prettier, but also replaces backticks
+        '@typescript-eslint/no-unused-vars': [
+          'error',
+          {
+            argsIgnorePattern: '^_',
+            varsIgnorePattern: '^_' // allow underscores in destructuring
+          }
+        ],
+        'prefer-object-spread': 'error',
+        'prefer-arrow-callback': ['error', { allowNamedFunctions: true }],
+        'unicorn/prefer-at': 'error',
+        'sonarjs/no-small-switch': 'error',
+        'prefer-const': ['error', { destructuring: 'all' }],
+        'unicorn/prefer-array-index-of': 'error',
+        'sonarjs/no-unused-collection': 'error',
+        'unicorn/catch-error-name': 'error',
+        'unicorn/prefer-optional-catch-binding': 'error',
+        'unicorn/filename-case': 'error',
         // todo: enable
         '@typescript-eslint/no-explicit-any': 'off',
         '@typescript-eslint/no-non-null-assertion': 'off',
@@ -60,8 +82,8 @@ module.exports = {
       extends: [
         'plugin:react/recommended',
         'plugin:react/jsx-runtime',
-        'plugin:react-hooks/recommended',
-        'plugin:@next/next/recommended'
+        'plugin:react-hooks/recommended'
+        // 'plugin:@next/next/recommended'
       ],
       rules: {
         'react/prop-types': 'off',
@@ -99,15 +121,12 @@ module.exports = {
     {
       files: '**/*.{ts,tsx,cts,mts}',
       extends: [
+        'plugin:deprecation/recommended'
         // TODO: fix errors
         // 'plugin:@typescript-eslint/recommended-requiring-type-checking'
       ],
       parserOptions: {
-        project: [
-          'packages/*/tsconfig.json',
-          'docs/tsconfig.json',
-          'tsconfig.eslint.json'
-        ]
+        projectService: true
       },
       rules: {
         '@typescript-eslint/no-unnecessary-type-assertion': 'error',
@@ -123,7 +142,7 @@ module.exports = {
       plugins: ['typescript-sort-keys'],
       settings: {
         tailwindcss: {
-          config: 'packages/nextra-theme-docs/tailwind.config.js',
+          config: 'packages/nextra-theme-docs/tailwind.config.ts',
           callees: ['cn'],
           whitelist: [
             'nextra-breadcrumb',
@@ -150,8 +169,8 @@ module.exports = {
       files: 'packages/nextra-theme-blog/**',
       settings: {
         tailwindcss: {
-          config: 'packages/nextra-theme-blog/tailwind.config.js',
-          whitelist: ['subheading-', 'post-item', 'post-item-more']
+          config: 'packages/nextra-theme-blog/tailwind.config.ts',
+          whitelist: ['subheading-']
         }
       }
     },
@@ -161,10 +180,14 @@ module.exports = {
       files: 'packages/nextra/**',
       settings: {
         tailwindcss: {
-          config: 'packages/nextra-theme-docs/tailwind.config.js',
+          config: 'packages/nextra-theme-docs/tailwind.config.ts',
           callees: ['cn'],
-          whitelist: ['nextra-code-block', 'nextra-filetree']
+          whitelist: ['nextra-code', 'nextra-filetree']
         }
+      },
+      rules: {
+        ...TAILWIND_CONFIG.rules,
+        'import/extensions': ['error', 'ignorePackages']
       }
     },
     // ⚙️ Docs
@@ -173,9 +196,20 @@ module.exports = {
       files: 'docs/**',
       settings: {
         tailwindcss: {
-          config: 'docs/tailwind.config.js',
+          config: 'docs/tailwind.config.ts',
           callees: ['cn'],
-          whitelist: ['dash-ring', 'theme-1', 'theme-2', 'theme-3', 'theme-4']
+          whitelist: [
+            'dash-ring',
+            'theme-1',
+            'theme-2',
+            'theme-3',
+            'theme-4',
+            'subtitle',
+            'headline',
+            'content-container',
+            'feat-darkmode',
+            'features-container'
+          ]
         },
         next: { rootDir: 'docs' }
       }
@@ -186,7 +220,11 @@ module.exports = {
       files: 'examples/swr-site/**',
       settings: {
         tailwindcss: {
-          config: 'examples/swr-site/tailwind.config.js'
+          config: 'examples/swr-site/tailwind.config.ts',
+          cssFiles: [
+            'examples/swr-site/styles.css',
+            'packages/nextra-theme-docs/dist/style.css'
+          ]
         },
         next: { rootDir: 'examples/swr-site' }
       }
@@ -208,8 +246,7 @@ module.exports = {
     {
       files: [
         'prettier.config.js',
-        'postcss.config.js',
-        'tailwind.config.js',
+        'postcss.config.{js,cjs}',
         'next.config.js',
         '.eslintrc.cjs'
       ],

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+---
+
+**Describe the bug** A clear and concise description of what the bug is.
+
+**To Reproduce** Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior** A clear and concise description of what you expected to
+happen.
+
+**Screenshots** If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
+
+**Additional context** Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.** A clear and
+concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like** A clear and concise description of what you
+want to happen.
+
+**Describe alternatives you've considered** A clear and concise description of
+any alternative solutions or features you've considered.
+
+**Additional context** Add any other context or screenshots about the feature
+request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,27 @@
+<!--
+Thank you for contributing to this project! You must fill out the information below before we can review this pull request. By explaining why you're making a change (or linking to an issue) and what changes you've made, we can triage your pull request to the best possible team for review.
+-->
+
+### Why:
+
+Closes:
+
+<!-- If there's an existing issue for your change, please link to it above.
+If there's _not_ an existing issue, please open one first to make it more likely that this update will be accepted: https://github.com/shuding/nextra/issues/new/choose. -->
+
+### What's being changed (if available, include any code snippets, screenshots, or gifs):
+
+<!-- Let us know what you are changing. Share anything that could provide the most context. -->
+
+### Check off the following:
+
+- [ ] I have reviewed my changes in staging, available via the **View
+      deployment** link in this PR's timeline (this link will be available after
+      opening the PR).
+
+  - For content changes, you will also see an automatically generated comment
+    with links directly to pages you've modified. The comment won't appear if
+    your PR only edits files in the `data` directory.
+
+- [ ] For content changes, I have completed the
+      [self-review checklist](https://docs.github.com/en/contributing/collaborating-on-github-docs/self-review-checklist).

.github/workflows/lint.yml

@@ -7,25 +7,22 @@ on:
 jobs:
   lint:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18]
 
     steps:
       - name: Cancel Previous Runs
         uses: styfle/[email protected]
         with:
           access_token: ${{ github.token }}
 
-      - name: Checkout Master
+      - name: Checkout Main
         uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
-      - name: Use Node.js ${{ matrix.node-version }}
+      - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version-file: .node-version
           cache: pnpm
 
       - name: Install Dependencies

.github/workflows/nextjs-bundle-analysis.yml

@@ -24,14 +24,15 @@ jobs:
         with:
           access_token: ${{ github.token }}
 
-      - uses: actions/checkout@v4
+      - name: Checkout Main
+        uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version-file: .node-version
           cache: pnpm
 
       - name: Install Dependencies
@@ -66,7 +67,7 @@ jobs:
           path: ${{ matrix.package }}/.next/analyze/__bundle_analysis.json
 
       - name: Download Base Branch Bundle Stats
-        uses: dawidd6/action-download-artifact@v3
+        uses: dawidd6/action-download-artifact@v6
         if: success() && github.event.number
         with:
           name: bundle-${{ matrix.package == 'docs' && 'docs' || 'swr-site' }}

.github/workflows/release.yml

@@ -11,15 +11,16 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Main
+        uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
       - name: Install Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 18
-          cache: 'pnpm'
+          node-version-file: .node-version
+          cache: pnpm
 
       - name: Install Dependencies
         run: pnpm i

.github/workflows/test.yml

@@ -7,10 +7,9 @@ on:
 jobs:
   test:
     name: Test (${{matrix.os}})
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        node-version: [18]
         os: [ubuntu-latest, windows-latest]
 
     steps:
@@ -19,15 +18,15 @@ jobs:
         with:
           access_token: ${{ github.token }}
 
-      - name: Checkout Master
+      - name: Checkout Main
         uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
-      - name: Use Node.js ${{ matrix.node-version }}
+      - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version-file: .node-version
           cache: pnpm
 
       - name: Install Dependencies

.gitignore

@@ -5,17 +5,12 @@ node_modules/
 dist/
 .turbo/
 out/
-# Theme styles
-packages/nextra-theme-*/style.css
 
-# Stork related
-*/**/public/*.st
-*/**/public/*.toml
-
-.vercel
+.vercel/
 .idea/
 .eslintcache
 .env
 
 tsup.config.bundled*
 tsconfig.tsbuildinfo
+pagefind/

.node-version

@@ -0,0 +1 @@
+20

.prettierignore

@@ -1,10 +1,12 @@
 pnpm-lock.yaml
 .changeset/*.md
+generated-page-map.js
 
-# process.env assignement should be first
-packages/nextra/__test__/locale-with-base-path.test.ts
-
-# bellow files are broken since prettier doesn't support MDX2
-examples/swr-site/pages/remote/graphql-eslint/\[\[...slug\]\].mdx
-examples/swr-site/pages/blog.en-US.mdx
 docs/pages/docs/guide/advanced/latex.mdx
+
+examples/swr-site/nextra-remote-filepaths/*.json
+examples/swr-site/pages/en/remote/graphql-eslint/_meta.ts
+examples/swr-site/pages/en/remote/graphql-yoga/_meta.ts
+
+docs/pages/docs/guide/built-ins/cards.mdx
+docs/pages/docs/guide/advanced/playground.mdx