Upgrade Docusaurus to v3.7.0 and migrate to Bun package manager

- Upgrade Docusaurus from 2.4.3 to 3.7.0
- Update React to 18.x and MDX to v3
- Migrate from npm to Bun for faster package management
- Fix theme customizations for Docusaurus 3 compatibility:
  - Update imports from @docusaurus/theme-common/internal to new client packages
  - Add BlogPostPageStructuredData and ContentVisibility components
- Fix MDX v3 breaking changes:
  - Escape angle brackets (<2, <10, <pool_name>) with backticks or HTML entities
  - Escape dollar signs ($name, ${name}) in code documentation
- Update prism-react-renderer import path for v2
- Add format: 'detect' to markdown config for CommonMark support
- Remove unused ShareLinks import from BlogFooter

Author: claude

.ci/validate-feeds.sh

@@ -4,7 +4,7 @@
 set -e
 
 echo "Building site to generate feeds..."
-npm run build
+bun run build
 
 echo ""
 echo "Validating RSS/Atom feeds..."

.gitlab-ci.yml

@@ -24,11 +24,11 @@ variables:
 # Validate RSS/Atom feeds before building and deploying
 validate_feeds:
   stage: validate
-  image: node:18
+  image: oven/bun:1.1
   before_script:
     # Install xmllint for XML validation
     - apt-get update && apt-get install -y libxml2-utils jq
-    - npm ci
+    - bun install --frozen-lockfile
   script:
     - bash .ci/validate-feeds.sh
   artifacts:

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:18.20
+FROM oven/bun:1.1
 
 ARG ARG_REACT_APP_API_SERVER
 ENV REACT_APP_API_SERVER=$ARG_REACT_APP_API_SERVER
@@ -27,14 +27,14 @@ ENV UMAMI_SCRIPT_URL=$ARG_UMAMI_SCRIPT_URL
 WORKDIR /docs
 
 COPY package.json ./
-COPY package-lock.json ./
-RUN npm ci
+COPY bun.lock ./
+RUN bun install --frozen-lockfile
 
 COPY . .
 # Make cache folder if not exists.
 RUN mkdir -p .cache
 RUN mv .cache node_modules
-RUN npm run build
+RUN bun run build
 
 EXPOSE 3000
-CMD ["npm", "run", "serve"]
+CMD ["bun", "run", "serve"]

blog/20250721-dblab-engine-4-0-released.mdx

@@ -226,7 +226,7 @@ When creating a branch or a clone takes a second and costs nothing extra, teams
 ## Performance at scale
 
 Testing with production workloads demonstrates:
-- **Clone creation**: <2 seconds for any database, regardless of size (even if it's 50 TiB!)
+- **Clone creation**: &lt;2 seconds for any database, regardless of size (even if it's 50 TiB!)
 - **Snapshot creation**: O(1) operation regardless of database size
 - **Branch switching**: Instant (pointer update only)
 - **Concurrent users**: 15 users on 10 TiB database with 30-second clone creation under load

blog/20251105-postgres-marathon-2-012.mdx

@@ -150,7 +150,7 @@ time pgbackrest \
 # Start with --process-max=8 for a balance of speed and resource usage
 # Increase to 16-32 for maximum speed on fast networks (10+ Gbps)
 # Network compression (--compress-level-network=1) provides minimal benefit 
-# on fast networks (<6% improvement) but is useful for slower networks (<10 Gbps)
+# on fast networks (<6% improvement) but is useful for slower networks (&lt;10 Gbps)
 ```
 
 If CPU resources are constrained on the source server, reduce priority for pgBackRest processes on the primary:
@@ -297,7 +297,7 @@ For production deployments:
 
 1. Start with `--process-max=$(($(nproc)/2))` to balance performance with system load
 2. Monitor CPU usage on both source and destination during backup
-3. Network compression (`--compress-level-network=1`) doesn't seem to be providing a significant improvement on fast networks (10+ Gbps). Use it for slower networks (<10 Gbps) where it can be more beneficial
+3. Network compression (`--compress-level-network=1`) doesn't seem to be providing a significant improvement on fast networks (10+ Gbps). Use it for slower networks (&lt;10 Gbps) where it can be more beneficial
 4. Consider using `renice` on the source server if CPU contention affects production workload
 5. Ensure sufficient I/O capacity on the destination to handle parallel writes
 6. For high parallelism (64+), increase SSH limits: `MaxStartups=200:30:300` and `MaxSessions=200` in `/etc/ssh/sshd_config`. Alternatively, SSH ControlMaster creates a single persistent connection that all subsequent SSH sessions multiplex through — we haven't tested this approach yet, but it's worth exploring for reducing connection overhead at high parallelism levels

bun.lock

@@ -56,8 +56,8 @@ Replacement rules are applied to all log fields of the incoming PostgreSQL CSV l
 ## Regular expressions
 The syntax of the regular expressions accepted is the same general syntax used by Perl, Python, and other languages.  You can find syntax details here: https://github.com/google/re2/wiki/Syntax.
 
-In a template, a variable is denoted by a substring of the form $name or ${name}, where name is a non-empty sequence of letters, digits, and underscores. 
-A purely numeric name like `$1` refers to a submatch with the corresponding index; other names refer to capturing parentheses named with the `(?P<name>...)` syntax. 
+In a template, a variable is denoted by a substring of the form `$name` or `${name}`, where name is a non-empty sequence of letters, digits, and underscores.
+A purely numeric name like `$1` refers to a submatch with the corresponding index; other names refer to capturing parentheses named with the `(?P<name>...)` syntax.
 A reference to an out-of-range or unmatched index or a name that is not present in the regular expression is replaced by an empty string.
 
 To insert a literal `$` in the output, use `$$` in the template.

docs/dblab-howtos/administration/ci-observer-postgres-log-masking.md

@@ -29,7 +29,7 @@ The clone's container name is associated with its port number, such as `dblab_cl
 
 #### Container labels 
 - `dblab_clone`
-- <pool_name>
+- `<pool_name>`
 
 #### Responsibility
 - Provides a thin clone: an independent PostgreSQL database server with thinly cloned / branched data directory

docs/reference-guides/database-lab-engine-components.md

@@ -39,6 +39,11 @@ module.exports = {
   organizationName: 'postgres-ai',
   projectName: 'docs',
 
+  // Use CommonMark for .md files to avoid MDX parsing issues
+  markdown: {
+    format: 'detect',
+  },
+
   customFields: {
     signInUrl: SIGN_IN_URL,
     apiUrlPrefix: API_URL_PREFIX,
@@ -379,8 +384,8 @@ module.exports = {
     },
 
     prism: {
-      theme: require('prism-react-renderer/themes/nightOwlLight'),
-      darkTheme: require('prism-react-renderer/themes/nightOwl'),
+      theme: require('prism-react-renderer').themes.nightOwlLight,
+      darkTheme: require('prism-react-renderer').themes.nightOwl,
     },
   },
 
@@ -605,6 +610,7 @@ module.exports = {
           showReadingTime: true,
           editUrl: 'https://gitlab.com/postgres-ai/docs/-/edit/master/',
           path: 'blog',
+          onInlineTags: 'ignore',
           routeBasePath: 'blog',
           postsPerPage: 10,
           blogSidebarTitle: 'Categories',