Modules x Nextra 4 (#2527)

* more

* aa

* add

* aa

* aa

* aa

* aa

* aa

* aa

* aa

* more

* more

* more

* more

* more

* more

* more

* more

* adjust header

* polish

* Merge branch 'master' into nextra-4

# Conflicts:
#	yarn.lock

* Merge branch 'master' into nextra-4

# Conflicts:
#	yarn.lock

Author: dimaMachina

.changeset/graphql-modules-2479-dependencies.md

@@ -1,5 +1,7 @@
 ---
 'graphql-modules': patch
 ---
+
 dependencies updates:
-  - Updated dependency [`ramda@^0.30.0` ↗︎](https://www.npmjs.com/package/ramda/v/0.30.0) (from `^0.29.0`, in `dependencies`)
+
+- Updated dependency [`ramda@^0.30.0` ↗︎](https://www.npmjs.com/package/ramda/v/0.30.0) (from `^0.29.0`, in `dependencies`)

.gitignore

@@ -24,12 +24,13 @@ node_modules
 .env
 
 # Builds
-dist
+dist/
 
 # IDE
-.idea
+.idea/
 
 .bob
 tsconfig.tsbuildinfo
 
-.next
+.next/
+out/

.prettierignore

@@ -1,5 +0,0 @@
-website/src/pages/docs/advanced/middlewares.mdx
-website/src/pages/docs/advanced/subscriptions.mdx
-website/src/pages/docs/di/providers.mdx
-website/src/pages/docs/recipes/migration.mdx
-website/out

website/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/pages/api-reference/config/typescript for more information.
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

website/next.config.js renamed to website/next.config.ts

@@ -1,7 +1,7 @@
 import { withGuildDocs } from '@theguild/components/next.config';
 
 export default withGuildDocs({
-  redirects: () =>
+  redirects: async () =>
     Object.entries({
       '/di/introduction': '/docs/di/introduction',
       '/docs/di': '/docs/di/introduction',
@@ -27,4 +27,10 @@ export default withGuildDocs({
       permanent: true,
     })),
   output: 'export',
+  env: {
+    SITE_URL: 'https://the-guild.dev/graphql/modules',
+  },
+  nextraConfig: {
+    contentDirBasePath: '/docs',
+  },
 });

website/package.json

@@ -4,13 +4,15 @@
   "version": "0.0.0",
   "type": "module",
   "scripts": {
-    "build": "next build && next-sitemap",
-    "dev": "next",
+    "build": "next build",
+    "dev": "next --turbopack",
+    "pagefind": "pagefind --site .next/server/app --output-path out/_pagefind",
+    "postbuild": "next-sitemap && yarn pagefind",
     "start": "next start",
     "analyze": "cross-env ANALYZE=true next build"
   },
   "dependencies": {
-    "@theguild/components": "^7.0.0",
+    "@theguild/components": "^9.1.2",
     "next": "15.1.6",
     "next-sitemap": "4.2.3",
     "react": "^19.0.0",
@@ -29,13 +31,14 @@
     ]
   },
   "devDependencies": {
+    "pagefind": "1.3.0",
     "@theguild/tailwind-config": "0.6.2",
     "@types/node": "22.10.7",
     "@types/react": "19.0.7",
     "cross-env": "7.0.3",
     "postcss-import": "16.1.0",
-    "postcss-lightningcss": "1.0.1",
     "tailwindcss": "3.4.17",
+    "postcss-lightningcss": "1.0.1",
     "typescript": "5.7.3"
   }
 }

website/postcss.config.js

@@ -0,0 +1 @@
+export { default } from '@theguild/tailwind-config/postcss.config';

website/src/pages/_meta.ts renamed to website/src/app/_meta.ts

@@ -1,17 +1,17 @@
 export default {
   index: {
-    title: 'Home',
-    type: 'page',
     display: 'hidden',
-    theme: {
-      layout: 'raw',
-    },
   },
   docs: {
     title: 'Documentation',
     type: 'page',
   },
   changelog: {
-    type: 'page',
+    theme: {
+      toc: false,
+      timestamp: false,
+      sidebar: false,
+      breadcrumb: false,
+    },
   },
 };

website/src/app/changelog/page.mdx

@@ -0,0 +1,16 @@
+---
+searchable: false
+---
+
+import fs from 'node:fs/promises'
+import { compileMdx, MDXRemote } from '@theguild/components/server'
+
+# Changelog
+
+<MDXRemote
+  compiledSource={await compileMdx(
+    (await fs.readFile('../packages/graphql-modules/CHANGELOG.md', 'utf8'))
+      // Remove first line
+      .replace(/^# .+/, '')
+  )}
+/>

website/src/app/docs/[[...mdxPath]]/page.tsx

@@ -0,0 +1,28 @@
+import { NextPageProps } from '@theguild/components';
+import {
+  generateStaticParamsFor,
+  importPage,
+} from '@theguild/components/pages';
+import { Giscus } from '../../../giscus';
+import { useMDXComponents } from '../../../mdx-components';
+
+export const generateStaticParams = generateStaticParamsFor('mdxPath');
+
+export async function generateMetadata(props: NextPageProps<'...mdxPath'>) {
+  const params = await props.params;
+  const { metadata } = await importPage(params.mdxPath);
+  return metadata;
+}
+
+const Wrapper = useMDXComponents().wrapper;
+
+export default async function Page(props: NextPageProps<'...mdxPath'>) {
+  const params = await props.params;
+  const result = await importPage(params.mdxPath);
+  const { default: MDXContent, toc, metadata } = result;
+  return (
+    <Wrapper toc={toc} metadata={metadata} bottomContent={<Giscus />}>
+      <MDXContent {...props} params={params} />
+    </Wrapper>
+  );
+}