Migrate to Nextra 3 (#217)

* Migrate to Nextra 3

* Migrate to Nextra 3

* Upgrade to nextra 3.0.5

* Fix failing CI

* Fix issue with navigation bar ordering

docs/next-env.d.ts

@@ -2,4 +2,4 @@
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/basic-features/typescript for more information.
+// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.

docs/next.config.js

@@ -1,12 +1,13 @@
-const withNextra = require('nextra')({
+import nextra from 'nextra';
+
+const withNextra = nextra({
     theme: 'nextra-theme-docs',
     themeConfig: './theme.config.tsx',
-    defaultShowCopyCode: true,
 });
 
-module.exports = {
-    ...withNextra(),
+export default withNextra({
+    output: 'export',
     images: {
         unoptimized: true,
     },
-};
+});

docs/package.json

@@ -2,10 +2,11 @@
   "name": "forui-docs",
   "version": "0.0.1",
   "description": "Documentation for Forui.",
+  "type": "module",
   "scripts": {
     "dev": "next dev",
     "build": "next build",
-    "export": "next build && next export",
+    "export": "next build",
     "start": "next start"
   },
   "bugs": {
@@ -15,18 +16,18 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "lucide-react": "^0.447.0",
-    "next": "^13.5.6",
-    "nextra": "^2.13.4",
-    "nextra-theme-docs": "^2.13.4",
+    "next": "^14.2.14",
+    "nextra": "^3.0.8",
+    "nextra-theme-docs": "^3.0.8",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "tailwind-merge": "^2.4.0"
+    "tailwind-merge": "^2.5.2"
   },
   "devDependencies": {
     "@types/node": "22.7.4",
-    "autoprefixer": "^10.4.19",
-    "postcss": "^8.4.38",
-    "tailwindcss": "^3.4.4",
-    "typescript": "^5.0.0"
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.47",
+    "tailwindcss": "^3.4.13",
+    "typescript": "^5.6.2"
   }
 }

docs/pages/_meta.ts

@@ -0,0 +1,24 @@
+export default {
+  index: {
+    title: 'Home',
+    type: 'page'
+  },
+  docs: {
+    title: 'Documentation',
+    type: 'page'
+  },
+  social: {
+    title: 'Core Team',
+    type: 'menu',
+    items: {
+      'x-joe': {
+        title: 'Joe Kawai',
+        href: 'https://x.com/kawaijoe'
+      },
+      'x-matthias': {
+        title: 'Matthias Ngeo',
+        href: 'https://x.com/matthiasngeo'
+      }
+    }
+  }
+};

docs/pages/docs/_meta.ts

@@ -0,0 +1,27 @@
+export default {
+  index: 'Getting Started',
+  themes: 'Themes',
+  'icon-library': 'Icon Library',
+  api_reference: {
+    title: 'API Reference ↗',
+    href: 'https://pub.dev/documentation/forui',
+    newWindow: true
+  },
+  pub_dev: {
+    title: 'Pub Dev ↗',
+    href: 'https://pub.dev/packages/forui',
+    newWindow: true
+  },
+
+  '-- widgets': {
+    type: 'separator',
+    title: 'Widgets'
+  },
+  // TODO: Workaround for a seperator bug. Remove when patched.
+  // A page need to be listed after a separator or else the order will be messed up.
+  accordion: 'Accordion',
+  '*': {
+    title: ''
+  },
+
+};

docs/pages/index.mdx

@@ -29,13 +29,13 @@ The library is designed with the following core principles in mind:
 
 ## Quick Links
 
-import {Cards, Card} from 'nextra/components';
+import {Cards} from 'nextra/components';
 import {Sparkles, MessagesSquare, FolderGit2} from 'lucide-react';
 
 <Cards>
-    <Card icon={<Sparkles/>} title="Get Started" href="/docs"/>
-    <Card icon={<MessagesSquare/>} title="Discussion" href="https://github.com/forus-labs/forui/discussions"/>
-    <Card icon={<FolderGit2/>} title="Source" href="https://github.com/forus-labs/forui"/>
+    <Cards.Card icon={<Sparkles/>} title="Get Started" href="/docs"/>
+    <Cards.Card icon={<MessagesSquare/>} title="Discussion" href="https://github.com/forus-labs/forui/discussions"/>
+    <Cards.Card icon={<FolderGit2/>} title="Source" href="https://github.com/forus-labs/forui"/>
 </Cards>
 
 ## FAQ