diff --git a/docs/app/_meta.ts b/docs/app/_meta.ts
index 3fb850bfc6..0e94ab3c4f 100644
--- a/docs/app/_meta.ts
+++ b/docs/app/_meta.ts
@@ -7,33 +7,42 @@ export default {
type: 'page',
title: 'Documentation'
},
- showcase: {
- type: 'page',
- theme: {
- typesetting: 'article',
- layout: 'full'
- }
- },
- about: {
- type: 'page',
- theme: {
- typesetting: 'article'
- }
- },
- version: {
+ versions: {
type: 'menu',
- title: 'Version',
+ title: 'Versions',
items: {
- _3: {
+ '3': {
title: 'Nextra v3 Docs ↗',
href: 'https://nextra-v2-pyibc76cq-shud.vercel.app',
newWindow: true
},
- _2: {
+ '2': {
title: 'Nextra v2 Docs ↗',
href: 'https://nextra-v2-oe0zrpzjp-shud.vercel.app',
newWindow: true
}
}
- }
+ },
+ about: {
+ type: 'page',
+ theme: {
+ typesetting: 'article'
+ }
+ },
+ showcase: {
+ type: 'page',
+ theme: {
+ typesetting: 'article',
+ layout: 'full',
+ timestamp: false
+ }
+ },
+ sponsors: {
+ type: 'page',
+ title: 'Sponsors',
+ theme: {
+ typesetting: 'article',
+ timestamp: false
+ }
+ },
}
diff --git a/docs/app/about/page.mdx b/docs/app/about/page.mdx
index 1038b13217..ac84b082e9 100644
--- a/docs/app/about/page.mdx
+++ b/docs/app/about/page.mdx
@@ -1,5 +1,3 @@
-import { Cards } from 'nextra/components'
-
export const metadata = {
sidebarTitle: 'About'
}
@@ -10,15 +8,28 @@ Nextra was initially created by [Vercel](https://vercel.com) members
[Shu Ding](https://twitter.com/shuding_) and
[Paco Coursey](https://twitter.com/pacocoursey) in 2020. Since 2021,
[Yixuan Xu](https://twitter.com/yixuanxu94) contributed tremendously to the
-project. In 2022, [Dimitri Postolov](https://twitter.com/dimaMachina_) from
+project.
+
+In 2022, [Dimitri Postolov](https://twitter.com/dimaMachina_) from
[The Guild](https://the-guild.dev) joined the core team to help with the
-development of 2.0.
+development of Nextra 2.
+
+In 2024 Nextra 3 was released, current primary maintainer
+[Dimitri Postolov](https://twitter.com/dimaMachina_) fully developed it, and
+[Oscar Xie](https://github.com/87xie)
+[actively contributed](https://github.com/shuding/nextra/pulls?q=sort%3Aupdated-desc+is%3Apr+author%3A87xie+is%3Aclosed+created%3A%3C2024-10-03)
+to this release.
+
+In 2024 Nextra 4 prerelease with [App Router](https://nextjs.org/docs/app)
+support was released, [Dimitri Postolov](https://twitter.com/dimaMachina_) fully
+developed it too. Currently, it's under development and
+[we are receiving feedback](https://github.com/shuding/nextra/issues/2600#issuecomment-2385107206).
## Team
-Currently, the project is maintained by [Shu Ding](https://twitter.com/shuding_)
-and [Dimitri Postolov](https://twitter.com/dimaMachina_). You can check out the
-full list of contributors on
+Currently, the project is maintained by
+[Dimitri Postolov](https://twitter.com/dimaMachina_). You can check out the full
+list of contributors on
[GitHub](https://github.com/shuding/nextra/graphs/contributors).
## Credits
@@ -53,16 +64,3 @@ product.
## License
The Nextra project and themes are licensed under the MIT license.
-
-## Sponsors
-
-
-
- <>
-
-
diff --git a/docs/app/docs/guide/organize-files/page.mdx b/docs/app/docs/guide/organize-files/page.mdx
index 364e455cbc..52baefcfeb 100644
--- a/docs/app/docs/guide/organize-files/page.mdx
+++ b/docs/app/docs/guide/organize-files/page.mdx
@@ -77,12 +77,55 @@ page:
-
- It's also possible to use the `.jsx`, `.ts`, `.tsx` extensions for `_meta`
- files (e.g. `_meta.ts`)
-
+### Allowed Extensions
-For example, you can put this in your `pages/_meta.js` file:
+It's possible to use the `.jsx`, `.ts` and `.tsx` extensions for `_meta` files
+as well (e.g. `_meta.ts`).
+
+### Sorting Pages Alphabetically
+
+You can use ESLint's built-in `sort-keys` rule, append
+`/* eslint sort-keys: error */` comment at the top of your `_meta` file, and you
+will receive ESLint's errors about incorrect order.
+
+### Usage with `next-sitemap`
+
+If you are using
+[next-sitemap](https://github.com/iamvishnusankar/next-sitemap), you will
+probably need to add `exclude: ['*/_meta']{:js}` to your
+`next-sitemap.config.js` file, as it is
+[tricky to exclude `_meta` files from the build](https://github.com/vercel/next.js/issues/8974#issuecomment-542525837).
+
+### Allowed Keys Values
+
+The type of your `_meta` keys should be always `string` and not `number` since
+[numbers are always ordered first](https://dev.to/frehner/the-order-of-js-object-keys-458d)
+for JavaScript objects.
+
+Following:
+
+```js filename="pages/_meta.js"
+export default {
+ foo: '',
+ 1992_10_21: '',
+ 1: ''
+}
+```
+
+Will be converted to:
+
+{/* prettier-ignore */}
+```js filename="pages/_meta.js"
+export default {
+ '1': '',
+ '19921021': '',
+ foo: ''
+}
+```
+
+## Example
+
+Put this in your `pages/_meta.js` file:
```js filename="pages/_meta.js"
export default {
@@ -108,18 +151,6 @@ export default {
}
```
-
- You can use ESLint's built-in rule sort keys with a `/* eslint sort-keys:
- error */` comment to sort your sidebar items alphabetically.
-
-
-
- If you are using
- [next-sitemap](https://github.com/iamvishnusankar/next-sitemap), you will
- probably need to add `exclude: ['*/_meta']` to your `next-sitemap.config.js`
- file, as it is tricky to exclude `_meta` files from the build.
-
-
The extra configurations are passed to the **theme** as additional information.
Check the corresponding pages for more information:
diff --git a/docs/app/showcase/_logos/react-flow.jpg b/docs/app/showcase/_logos/react-flow.jpg
new file mode 100644
index 0000000000..c085ea5227
Binary files /dev/null and b/docs/app/showcase/_logos/react-flow.jpg differ
diff --git a/docs/app/showcase/_logos/svelte-flow.jpg b/docs/app/showcase/_logos/svelte-flow.jpg
new file mode 100644
index 0000000000..42d88a98a2
Binary files /dev/null and b/docs/app/showcase/_logos/svelte-flow.jpg differ
diff --git a/docs/app/showcase/_logos/xyflow.jpg b/docs/app/showcase/_logos/xyflow.jpg
new file mode 100644
index 0000000000..f145289660
Binary files /dev/null and b/docs/app/showcase/_logos/xyflow.jpg differ
diff --git a/docs/app/showcase/page.mdx b/docs/app/showcase/page.mdx
index 5360440bf8..131c59d23f 100644
--- a/docs/app/showcase/page.mdx
+++ b/docs/app/showcase/page.mdx
@@ -3,196 +3,173 @@ import { Cards } from 'nextra/components'
+ 