Merge branch 'source' into blog-post-docs

Author: benjie

.eslintrc.cjs

@@ -5,7 +5,15 @@ const MARKDOWN_EXT = "md,mdx"
 
 module.exports = {
   root: true,
-  plugins: ["@graphql-eslint", "mdx", "@typescript-eslint", "tailwindcss"],
+  plugins: [
+    "@graphql-eslint",
+    "mdx",
+    "@typescript-eslint",
+    "tailwindcss",
+    "react",
+    "@next/next",
+    "react-hooks",
+  ],
   overrides: [
     {
       files: [`**/*.{${CODE_EXT}}`],
@@ -14,8 +22,42 @@ module.exports = {
         "plugin:@typescript-eslint/recommended",
         "plugin:tailwindcss/recommended",
         "prettier",
+        "plugin:@next/next/recommended",
+        "plugin:react-hooks/recommended-legacy",
+        "plugin:react/recommended",
       ],
       rules: {
+        "react/react-in-jsx-scope": "off", // TS checks this
+        "react/prop-types": "off", // and this
+        "no-undef": "off", // and this too
+        // This is type checking for projects without `@types/react`. Disabled due to false positives.
+        "react/no-unknown-property": "off",
+
+        "react/no-unescaped-entities": [
+          "warn", // quotes and apostrophes are okay
+          {
+            forbid: [
+              {
+                char: "<",
+                alternatives: ["&lt;"],
+              },
+              {
+                char: ">",
+                alternatives: ["&gt;"],
+              },
+              {
+                char: "{",
+                alternatives: ["&#123;"],
+              },
+              {
+                char: "}",
+                alternatives: ["&#125;"],
+              },
+            ],
+          },
+        ],
+        "@next/next/no-img-element": "off", // straight up upsell, small `img`s actually don't need optimization
+
         "tailwindcss/classnames-order": "off",
         "@typescript-eslint/no-restricted-imports": [
           "error",
@@ -41,6 +83,9 @@ module.exports = {
         tailwindcss: {
           whitelist: ["roboto-mono"],
         },
+        react: {
+          version: "detect",
+        },
       },
     },
     {
@@ -63,6 +108,8 @@ module.exports = {
       },
       rules: {
         "mdx/remark": "error",
+        "no-unused-expressions": "off",
+        "react/jsx-no-undef": "off",
       },
     },
     {
@@ -90,7 +137,9 @@ module.exports = {
     {
       files: [
         `src/pages/blog/**/*.{${MARKDOWN_EXT}}`,
+        `src/pages/graphql-js/running-an-express-graphql-server.mdx`,
         `src/code/**/*.{${MARKDOWN_EXT}}`,
+        `src/app/conf/**/*.{${MARKDOWN_EXT}}`,
       ],
       rules: {
         // Disable `remark-lint-first-heading-level` since in blogs we don't want to enforce the first heading to be an `h1`

.github/workflows/prettier.yml renamed to .github/workflows/check.yml

@@ -1,4 +1,4 @@
-name: Prettier Check
+name: Lint and check formatting
 
 on: pull_request
 
@@ -16,5 +16,9 @@ jobs:
 
       - name: Install Dependencies
         run: pnpm i
+
+      - name: Run ESLint
+        run: pnpm lint --quiet
+
       - name: Run Prettier Check
         run: pnpm format:check

.github/workflows/conference-sync.yml

@@ -0,0 +1,26 @@
+# Sched's API rate limits are very limited, so we sync non-critical part of the data on a cron.
+on:
+  workflow_dispatch:
+  # schedule:
+  # - cron: "*/10 * * * *" # every ten minutes
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Sync conference data from Sched
+        run: |
+          tsx scripts/sync-sched/sync.ts --year 2025
+        env:
+          SCHED_ACCESS_TOKEN_2025: ${{ secrets.SCHED_ACCESS_TOKEN_2025 }}
+
+      - name: Commit changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          file_pattern: "scripts/sync-sched/*.json"
+          commit_message: "Sync conference data from Sched"

.gitignore

@@ -61,3 +61,5 @@ src/__generated__/
 .next/
 public/sitemap.xml
 out/
+
+tsconfig.tsbuildinfo

.prettierignore

@@ -4,4 +4,8 @@ pnpm-lock.yaml
 !src/pages/blog/2024-04-11-announcing-new-graphql-website/index.mdx
 !src/pages/blog/2024-08-15-graphql-local-initiative.mdx
 !src/pages/community/foundation/community-grant.mdx
+!src/pages/blog/2025-06-01-graphiql-4/index.mdx
 *.jpg
+
+scripts/sync-sched/*.json
+src/github-stats.json

CONTRIBUTING.md

@@ -20,6 +20,7 @@ There are many ways to get involved. Follow this guide and feel free to [reach o
   - [Add a resource to the Community page](#add-a-resource-to-the-community-page)
   - [Add a question to the FAQ](#add-a-question-to-the-faq)
   - [Write a new section or guide](#write-a-new-section-or-guide)
+  - [Add a blog post](#add-a-blog-post)
 - [Making changes to the code](#making-changes-to-the-code)
   - [Browser support](#browser-support)
 - [Contributing something else](#contributing-something-else)
@@ -149,6 +150,12 @@ Then, use our [development guide](#development-guide) to determine where your ne
 
 Once it's ready for review, please [open a pull request](https://github.com/graphql/graphql.github.io/pulls).
 
+### Add a blog post
+
+This repository holds the [graphql.org blog](https://graphql.org/blog/) at [source/src/pages/blog](https://github.com/graphql/graphql.github.io/tree/source/src/pages/blog). Blog posts may contain announcements, news, best practices and more.
+
+Contributions are very welcome!
+
 ## Making changes to the code
 
 Before diving into any code updates, please [open an issue](https://github.com/graphql/graphql.github.io/issues/new) describing the change(s) you'd like to make.

next.config.js

@@ -27,6 +27,25 @@ export default withLess(
   withNextra({
     // reactStrictMode: true, provoke duplicated codemirror editors
     webpack(config) {
+      // #region MDX
+      const mdxRule = config.module.rules.find(rule =>
+        rule.test?.test?.(".mdx"),
+      )
+      if (mdxRule) {
+        mdxRule.resourceQuery = {
+          not: /raw/,
+        }
+      }
+      // Instead of transforming MDX, with ?source we can get
+      // the raw content to process in a Server Component.
+      config.module.rules.push({
+        test: /\.mdx$/i,
+        resourceQuery: /raw/,
+        type: "asset/source",
+      })
+      // #endregion MDX
+
+      // #region SVGs
       const fileLoaderRule = config.module.rules.find(rule =>
         rule.test?.test?.(".svg"),
       )
@@ -62,6 +81,7 @@ export default withLess(
           },
         },
       )
+      // #endregion SVGs
 
       return config
     },

package.json

@@ -21,74 +21,79 @@
   },
   "dependencies": {
     "@graphql-tools/schema": "10.0.15",
-    "@headlessui/react": "^1.7.17",
-    "@radix-ui/react-radio-group": "^1.1.3",
+    "@headlessui/react": "^2.2.4",
+    "@radix-ui/react-radio-group": "^1.2.2",
     "@tailwindcss/container-queries": "^0.1.1",
     "@tailwindcss/nesting": "0.0.0-insiders.565cd3e",
-    "@tailwindcss/typography": "^0.5.10",
-    "autoprefixer": "^10.4.17",
-    "clsx": "^2.1.0",
+    "@tailwindcss/typography": "^0.5.15",
+    "autoprefixer": "^10.4.20",
+    "calendar-link": "^2.10.0",
+    "clsx": "^2.1.1",
     "codemirror": "^5.65.19",
     "codemirror-graphql": "1.3.2",
     "date-fns": "^2.30.0",
-    "fast-glob": "^3.3.2",
+    "fast-glob": "^3.3.3",
+    "github-slugger": "2.0.0",
     "graphql": "16.10.0",
     "gray-matter": "^4.0.3",
     "hast-util-to-string": "3.0.1",
-    "iframe-resizer-react": "^1.1.0",
+    "iframe-resizer-react": "^1.1.1",
     "leaflet": "^1.9.4",
     "lucide-react": "^0.469.0",
-    "markdown-to-jsx": "^7.4.0",
+    "markdown-to-jsx": "^7.7.2",
     "marked": "5.1.2",
     "motion": "^12.11.0",
-    "next": "^14.2.5",
-    "next-image-export-optimizer": "^1.12.3",
-    "next-query-params": "^5.0.0",
+    "next": "^14.2.22",
+    "next-image-export-optimizer": "^1.18.0",
+    "next-query-params": "^5.0.1",
     "next-sitemap": "^4.2.3",
     "next-with-less": "^3.0.1",
     "nextra": "3.0.0-alpha.28",
     "nextra-theme-docs": "3.0.0-alpha.28",
     "numbro": "2.5.0",
     "p-limit": "^4.0.0",
     "parser-front-matter": "1.6.4",
-    "postcss": "^8.4.33",
+    "postcss": "^8.4.49",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-medium-image-zoom": "5.2.13",
     "react-use-measure": "^2.1.7",
     "rss": "1.2.2",
     "server-only": "0.0.1",
     "string-similarity": "^4.0.4",
-    "string-strip-html": "^13.4.5",
-    "tailwindcss": "^3.4.1",
+    "string-strip-html": "^13.4.8",
+    "tailwindcss": "^3.4.17",
     "timeago.js": "4.0.2",
     "unified": "11.0.5",
     "unist-util-visit": "^5.0.0",
     "use-query-params": "^2.2.1"
   },
   "devDependencies": {
     "@graphql-eslint/eslint-plugin": "4.3.0",
-    "@svgr/webpack": "^8.0.1",
-    "@types/codemirror": "5.60.7",
+    "@next/eslint-plugin-next": "^15.3.3",
+    "@svgr/webpack": "^8.1.0",
+    "@types/codemirror": "5.60.16",
     "@types/hast": "3.0.4",
-    "@types/node": "^22.10.2",
-    "@types/react": "^18.2.73",
+    "@types/node": "^22.10.5",
+    "@types/react": "^18.3.18",
     "@types/rss": "0.0.32",
     "@types/string-similarity": "^4.0.2",
     "@typescript-eslint/eslint-plugin": "7.18.0",
     "@typescript-eslint/parser": "7.18.0",
     "eslint": "8.57.1",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-mdx": "^3.1.5",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-tailwindcss": "3.17.5",
-    "prettier": "3.4.2",
-    "prettier-plugin-pkg": "^0.18.1",
-    "prettier-plugin-tailwindcss": "^0.6.9",
+    "prettier": "3.5.3",
+    "prettier-plugin-pkg": "^0.20.0",
+    "prettier-plugin-tailwindcss": "^0.6.12",
     "remark-frontmatter": "5.0.0",
     "remark-lint-first-heading-level": "3.1.2",
     "remark-lint-heading-increment": "3.1.2",
-    "tsx": "^4.7.0",
-    "typescript": "^5.4.3"
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
   },
   "pnpm": {
     "patchedDependencies": {

patches/[email protected]

@@ -9,3 +9,18 @@ index af0891e3c2084edd326f40e6e18107b193640e0b..885858fa17285fb75649cf0ebd2576d1
  import { createElement } from "react";
  const DEFAULT_COMPONENTS = {
    img: (props) => createElement(
+diff --git a/package.json b/package.json
+index 0625691ebc1d79d7b7d22bb3b001f00a57519772..53d4b0c951a762ae056004789c9aca819e0ade62 100644
+--- a/package.json
++++ b/package.json
+@@ -20,6 +20,10 @@
+       "import": "./dist/server/remark-plugins/index.js",
+       "types": "./dist/server/remark-plugins/index.d.ts"
+     },
++    "./rehype-plugins": {
++      "import": "./dist/server/rehype-plugins/index.js",
++      "types": "./dist/server/rehype-plugins/index.d.ts"
++    },
+     "./hooks": {
+       "import": "./dist/client/hooks/index.js",
+       "types": "./dist/client/hooks/index.d.ts"