Redesign (v2) (#873)

* all in one

* add temporarily missing images to make build pass

* use the-guild-org/shared-config/setup@v1

* fix eslint

* Update Dockerfile

* Update packages/nextra-theme/src/index.tsx

Co-authored-by: Benoît Rouleau <[email protected]>

* Update packages/nextra-theme/src/index.tsx

* Update website/scripts/fetch-remote-docs.ts

Co-authored-by: Benoît Rouleau <[email protected]>

* Update fetch-remote-docs.ts

* Update website/scripts/fetch-remote-docs.ts

* 2/4 move `@graphprotocol/nextra-theme` to `@graphprotocol/docs` (#732)

* aa

* more

* lint fix

* 3/4 Refactor `_meta.js` to prefer `sidebarTitle` (#733)

* move mdxStyles

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* more

* lint

* update nextra

* 4/4 move `pages` to `src/pages` (#734)

* move pages to src

* some refactoring

* Update Node

* Remove unneeded `try…catch`

* `pnpm check:fix`

---------

Co-authored-by: benface <[email protected]>

---------

Co-authored-by: benface <[email protected]>

* Update dependencies

* Fix tests

* Change `@` alias to `src/` and move some files around

* Start work on new design

* Temp stuff

* Try to fix CI

* Update dependencies

* WIP

* style updates (#854)

* style updates

* remove navbar hiding on small screens (this was a test)

* align icons and nav labels to top

* lint

* remove unnecessary w-full

* Make search and locale switcher functional

* Add icons + refactor and improve how navigation groups are computed

* Add “partially selected” state

* Quick fix

* Huge refactoring + add a bunch of missing components, still missing breadcrumbs

* Fixes and improvements (thanks AK for the feedback!)

* Home page content + footer + fixes and tweaks

* Fixes and tweaks

* Squash some TODOs

* Remove console log

* style tweaks for home page (#872)

* Make 404 page work + improve footer + last couple tweaks and fixes

* Missed this in the merge

* Use `sidebarTitle` instead of `_meta.js`

* Last minute fixes

---------

Co-authored-by: Dimitri POSTOLOV <[email protected]>
Co-authored-by: AK <[email protected]>

Author: 3 people

.eslintrc.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 const isVSCode = Boolean(process.env.VSCODE_PID)
 
 /** @type {import('eslint').Linter.Config} */
@@ -21,7 +23,11 @@ module.exports = {
       // Only lint the English pages because the Markdown for the other languages is auto-generated from English (via Crowdin).
       // But include all languages when running the ESLint extension in VS Code (in case the user has "eslint.validate": ["mdx"]),
       // otherwise there will be random errors since the non-English files don't match any ruleset.
-      files: [`website/pages/${!isVSCode ? 'en/' : ''}**/*.{md,mdx}`],
+      files: [`website/src/pages/${isVSCode ? '' : 'en/'}**/*.{md,mdx}`],
+      excludedFiles: [
+        'website/src/pages/*/subgraphs/developing/creating/graph-ts/*.md',
+        'website/src/pages/*/subgraphs/querying/graph-client/*.md',
+      ],
       parser: 'eslint-mdx',
       processor: 'mdx/remark',
       plugins: ['mdx'],

.github/workflows/ci-cd-pull-request.yml

@@ -19,10 +19,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Install dependencies
         run: pnpm install
@@ -43,10 +40,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Install dependencies
         run: pnpm install
@@ -67,10 +61,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Install dependencies
         run: pnpm install
@@ -92,10 +83,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Install dependencies
         run: pnpm install

.github/workflows/opengraph.yml

@@ -24,10 +24,7 @@ jobs:
           ref: ${{ env.COMMIT }}
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Deploy
         working-directory: ./packages/og-image

.github/workflows/website-integrity.yml

@@ -21,10 +21,7 @@ jobs:
         run: git fetch origin main
 
       - name: Set up env
-        uses: the-guild-org/shared-config/setup@main
-        with:
-          nodeVersion: 20
-          packageManager: pnpm
+        uses: the-guild-org/shared-config/setup@v1
 
       - name: Build Site
         run: pnpm build

.gitignore

@@ -37,5 +37,5 @@ build/
 .eslintcache
 dist/
 .turbo/
-packages/og-image/vender/*.wasm
+packages/og-image/vendor/*.wasm
 .wrangler/

.nvmrc

@@ -1 +1 @@
-20
+22

.prettierignore

@@ -3,4 +3,6 @@
 out/
 pnpm-lock.yaml
 dist/
-website/remote-files/*.json
+# ignore below md since they are fetched from GitHub
+website/src/pages/*/subgraphs/developing/creating/graph-ts/*.md
+website/src/pages/*/subgraphs/querying/graph-client/*.md

.remarkrc.mjs

@@ -1,6 +1,12 @@
+import remarkFrontmatter from 'remark-frontmatter'
+
+/**
+ * This config is used by `eslint-plugin-mdx` to lint the MDX files, not by Nextra.
+ * Nextra uses the remark and rehype plugins registered in `next.config.js`, under `mdxOptions`.
+ */
 export default {
   plugins: [
-    'frontmatter', // should be defined
+    remarkFrontmatter,
     ['remark-lint-first-heading-level', 2],
     ['remark-lint-restrict-elements', { type: 'heading', depth: 1 }],
     'remark-lint-heading-increment',

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:20-alpine as builder
+FROM node:22-alpine AS builder
 
 ARG ENVIRONMENT
 ARG ORIGIN
@@ -14,14 +14,11 @@ RUN corepack enable pnpm
 
 WORKDIR /app
 
-COPY . .
-
-# install the packages
-RUN pnpm install --frozen-lockfile --ignore-scripts
+COPY . ./
 
+RUN pnpm install --frozen-lockfile
 RUN pnpm build
 
-## production environment
 FROM nginx:1.16.0-alpine
 
 COPY --from=builder ./app/nginx.conf /etc/nginx/

README.md

@@ -8,7 +8,7 @@ Please read [`CONTRIBUTING.md`](https://github.com/graphprotocol/docs/blob/main/
 
 ## Local Setup
 
-This project is built on [Next.js](https://nextjs.org/). You can run it on your machine, provided you have [Node 20+](https://nodejs.org/en/) and [`pnpm`](https://pnpm.io) installed.
+This project is built on [Next.js](https://nextjs.org/). You can run it on your machine, provided you have [Node 22+](https://nodejs.org/en/) and [`pnpm`](https://pnpm.io) installed.
 
 First, clone the repo: