feat: docs in website! (#5)

merge the docs repo into the website at /docs. doing this at deploy time proved tricky, so now we just build all the things together. markdown files can be added directly to `src/pages/docs/your-topic-here.md` and add it to a `_meta.json` at the same level to set it's link title and position in the nav. License: MIT --------- Signed-off-by: Oli Evans <[email protected]> Co-authored-by: Vasco Santos <[email protected]>
storacha · Nov 13, 2023 · 484e0c1 · 484e0c1
1 parent 962cf3d
commit 484e0c1
Show file tree

Hide file tree

Showing 19 changed files with 3,296 additions and 102 deletions.
diff --git a/next.config.js b/next.config.js
@@ -2,10 +2,16 @@
 const nextConfig = {
   output: 'export',
   images: { unoptimized: true },
+  trailingSlash: true,
   reactStrictMode: true,
   experimental: {
     serverComponentsExternalPackages: ['shiki', 'vscode-oniguruma']
   }
 }
 
-module.exports = nextConfig
+const withNextra = require('nextra')({
+  theme: 'nextra-theme-docs',
+  themeConfig: './src/theme.config.jsx'
+})
+
+module.exports = withNextra(nextConfig)
diff --git a/package.json b/package.json
@@ -11,6 +11,8 @@
   },
   "dependencies": {
     "next": "14.0.1",
+    "nextra": "^2.13.2",
+    "nextra-theme-docs": "^2.13.2",
     "react": "^18",
     "react-dom": "^18",
     "shiki": "^0.14.5"