add nextra (#141)

apps/documentation/next.config.mjs → apps/documentation/next.config.js

@@ -1,3 +1,5 @@
+import nextra from "nextra"
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   reactStrictMode: true,
@@ -15,4 +17,10 @@ const nextConfig = {
   },
 }
 
-export default nextConfig
+const withNextra = nextra({
+  theme: "nextra-theme-docs",
+  themeConfig: "./theme.config.jsx",
+  // ... your Nextra config
+})
+
+export default withNextra(nextConfig)

apps/documentation/package.json

@@ -13,6 +13,8 @@
   },
   "dependencies": {
     "next": "14.2.3",
+    "nextra": "3.0.0-alpha.24",
+    "nextra-theme-docs": "3.0.0-alpha.24",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

apps/documentation/src/pages/_app.tsx

@@ -0,0 +1,13 @@
+import "@/globals.css"
+import type { AppProps } from "next/app"
+import { Montserrat } from "next/font/google"
+
+const font = Montserrat({ subsets: ["latin"] })
+
+export default function MyApp({ Component, pageProps }: AppProps) {
+  return (
+    <main className={font.className}>
+      <Component {...pageProps} />
+    </main>
+  )
+}

apps/documentation/src/pages/_meta.tsx

@@ -0,0 +1,6 @@
+export default {
+  index: {
+    title: "Home",
+    type: "page",
+  },
+}

apps/documentation/src/pages/about.mdx

@@ -0,0 +1,3 @@
+# Welcome to Nextra
+
+Hello, world!

apps/documentation/src/pages/index.mdx

@@ -0,0 +1,6 @@
+<div className="flex justify-center pt-10">
+  <div className="prose dark:prose-invert">
+    <h1>OberonCMS</h1>
+    <p>We're nearly here now...</p>
+  </div>
+</div>

apps/documentation/theme.config.jsx

@@ -0,0 +1,38 @@
+import { useConfig } from "nextra-theme-docs"
+import Image from "next/image"
+
+export default {
+  logo: <Image src="/icon.svg" width="30" height="30" alt="OberonCMS logo" />,
+  project: {
+    link: "https://github.com/tohuhono/oberon",
+  },
+  docsRepositoryBase:
+    "https://github.com/tohuhono/oberon/tree/main/apps/documentation/",
+  useNextSeoProps() {
+    return {
+      titleTemplate: "%s – SWR",
+    }
+  },
+  head: () => {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const { frontMatter } = useConfig()
+
+    return (
+      <>
+        <meta
+          property="og:title"
+          content={frontMatter.title || "OberonCMS Documentation"}
+        />
+        <meta
+          property="og:description"
+          content={
+            frontMatter.description ||
+            "A CMS for developers, designers and content creators."
+          }
+        />
+      </>
+    )
+  },
+
+  // ... other theme options
+}

apps/documentation/tsconfig.json

@@ -18,13 +18,15 @@
     "emitDeclarationOnly": false,
     "paths": {
       "@/*": ["./src/*"]
-    }
+    },
+    "strictNullChecks": true
   },
   "include": [
     "next-env.d.ts",
-    "src/**/*.ts",
-    "src/**/*.tsx",
-    ".next/types/**/*.ts"
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    "theme.config.jsx"
   ],
   "exclude": ["node_modules"]
 }