docs: Deploy new site alongside old one (#5360)

Co-authored-by: Josh Goldberg ✨ <[email protected]>

Author: mark-wiemer

.github/workflows/nightly-site-deploy.yml

@@ -1,5 +1,6 @@
 # Deploy `mochajs.org` branch nightly by hitting a netlify build URL.
 # This updates the list of supporters
+# It uses commands from netlify.toml at root of repo
 
 name: Nightly mochajs.org Deploy
 

docs-next/README.md

@@ -7,3 +7,19 @@ npm i
 npm run generate
 npm run dev
 ```
+
+To merge with the old site:
+
+```shell
+npm i
+npm run build-with-old
+```
+
+To preview the old and new site:
+
+```shell
+cd .. # back to root dir
+npm run docs:preview
+```
+
+The new site will be at `http://localhost:8080/next`

docs-next/astro.config.ts

@@ -2,9 +2,7 @@ import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
 
 export default defineConfig({
-  // For now, this is only being deployed to mocha-docs-next.netlify.app.
-  // Soon we'll move it onto mochajs.org/next.
-  ...(!process.env.NETLIFY_BUILD_BASE && { base: "/next" }),
+  base: "/next",
   integrations: [
     starlight({
       components: {

docs-next/package.json

@@ -9,6 +9,7 @@
     "docs": "cd .. && npm i && cd docs-next && npm run generate && npm run build",
     "build": "astro check && astro build",
     "preview": "astro preview",
+    "build-with-old": "npm run generate && npm run build -- --outDir ../docs/_site/next",
     "astro": "astro"
   },
   "dependencies": {

netlify.toml

@@ -14,8 +14,7 @@
 
 [build.environment]
   DEBUG = "mocha:docs*"
-  NODE_VERSION = "16"
-  RUBY_VERSION = "2.7.2"
+  NODE_VERSION = "20" # LTS until 2026-04-30
 
 [context.deploy-preview]
   command = "npm run docs"