Format

Update bun.lock
Enhance layout handling for OpenAPI and full-width modes
2026-09-14 06:35:17 +00:00 · 2026-01-28 14:01:16 +01:00 · 2026-01-28 13:59:52 +01:00 · 2026-01-28 13:50:48 +01:00 · 2026-01-28 13:48:56 +01:00 · 2026-01-28 11:16:50 +01:00
673 changed files with 38396 additions and 11403 deletions
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix UX issue about highlighting the search term in search result sections
@@ -1,9 +0,0 @@
---
-gitbook: patch
---
-
-Fix three small visual issues
-
- Fix sidebar showing on `no-toc` pages in the gradient theme
- Fix variant selector truncating incorrectly in header when sections are present
- Fix page cover alignment on `lg` screens without TOC
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Respect fullWidth and defaultWidth for images
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Hide scrollbar on sections
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Add docs.testgitbook.com to ADAPTIVE_CONTENT_HOSTS list
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-fix nested a tag causing hydration error
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-fix href being empty in TOC
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix navigation between sections/variants when previewing a site in v2
@@ -0,0 +1,6 @@
+---
+"gitbook": minor
+"@gitbook/react-openapi": patch
+---
+
+Support code themes customization
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add sidesheet component, use it for TOC and AIChat
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Add support for inline icons.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix revision id for computed content
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Add circular corners and depth styling
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix crash when integration script fails to render block.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Set <html lang> based on translated language
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Add authorization header for OAuth2
@@ -1,6 +0,0 @@
---
-'@gitbook/react-openapi': patch
-'gitbook': patch
---
-
-Improve support for OAuth2 security type
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Adds Columns layout block to GBO
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Support social links
@@ -0,0 +1,5 @@
+---
+"@gitbook/embed": patch
+---
+
+Fix signed JWT token usage
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Support dark-mode specific page cover image
@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Fix OpenAPI example not showing
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Update Models page styling
@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Serve a markdown version of the page when the "Accept" header contains "text/markdown".
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Align styling of PageLinkItem and PageDocumentItem
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Show scrollbars
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Optimize performances by using a smarter per-request cache arround data cached functions
@@ -0,0 +1,5 @@
+---
+"@gitbook/openapi-parser": patch
+---
+
+Update scalar dependencies.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-add a force-revalidate api route to force bust the cache in case of errors
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Add support for icons in buttons.
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Fix rendering of ogimage with SVG logos.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Better conditional display of page actions
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Best effort at preserving current variant when navigating between sections by matching the pathname against site spaces in the new section.
@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Improve OpenAPI server URL validation
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix crash when integration is triggering invalid requests.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Optimize the fetch of revision files by using only the getRevision cache.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-encode customization header
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Rework full-width layout, add support for full-width page option
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix CodeBlock layout
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Scroll to active TOC when clicking a link
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-fix ISR on preview env
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Add support for text alignment for headings and paragraphs.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix concurrent execution in Vercel causing pages to not be attached to the proper tags.
@@ -1,5 +0,0 @@
---
-"@gitbook/react-contentkit": patch
---
-
-Add basic error handling when transitioning between states.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Generate a llms-full.txt version of the docs site
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Don't crash ogimage generation on RTL text, as a workaround until we can support it.
@@ -1,5 +0,0 @@
---
-gitbook: minor
---
-
-Add support for site customization option to change how external links open.
@@ -1,5 +0,0 @@
---
-"@gitbook/fonts": minor
---
-
-Initial version of the package
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix rendering of ogimage when logo or icon are AVIF images.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix ordered list item index calculation
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Add margin to adjacent buttons
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix ogimage generation failing with some JPEG images.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Standardise toggle chevrons across the app
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix page group not expanded by default
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Don't cache unexpected API errors for more than a few minutes.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix an issue where PDF export URLs were not keeping their query params.
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Fix markdown page generation for groups
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-add a global error boundary
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Indent JSON python code sample
@@ -1,6 +0,0 @@
---
-'@gitbook/react-openapi': patch
-'gitbook': patch
---
-
-Handle nullish OpenAPI mediaTypeObject
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix missing title on button to close the announcement banner.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Make icons for page groups more contrasting
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Add AI chat
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Ignore case while highlighting search results.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Consistently show variant selector in section bar if site has sections
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Include page group children under the .md route
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Make TOC height dynamic based on visible header and footer elements
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Clicking an active TOC item toggles its descendants
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix viewing a page from a revision
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix InlineLinkTooltip having a negative impact on performance, especially on larger pages.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Grow InlineActionButton to take available width on line
@@ -1,6 +0,0 @@
---
-'@gitbook/openapi-parser': patch
-'@gitbook/react-openapi': patch
---
-
-Optional label in OpenAPI x-codeSamples
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix bold header links hover color
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-cache fonts and static image used in OGImage in memory
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix border being added to cards
@@ -0,0 +1,5 @@
+---
+"@gitbook/icons": patch
+---
+
+Simplify installation by using public fontawesome mirror.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Add metadata for adding site to Apple devices home
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Handle nested deprecated properties in generateSchemaExample
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix crash during rendering of ogimage for VA sites with default icon.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Add `urlObject.hash` to `linker.toLinkForContent` to pass through URL fragment identifiers, used in search
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Allow to zoom images on mobile if relevant
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-apply customization for dynamic context
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Reverse order of feedback smileys
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Deduplicate path parameters from OpenAPI spec
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-Fix ogimage using incorrect Google Font depending on language.
@@ -1,5 +0,0 @@
---
-gitbook: patch
---
-
-remove trailing slash from linker
@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Add OpenAPI 3.1 nullable array support
@@ -54,10 +54,9 @@ After forking this repository, you'll want to [create a branch](https://docs.git
 #### 3. Install dependencies and run the project locally

 ##### Prerequisites:
- Node.js (Version: >=20.6)
-  - Use `nvm` for easy Node management
- [Bun](https://bun.sh/) (Version: >=1.2.15)
-  - We use a text-based lockfile which isn't supported below 1.2.15
+
+- [Node.js](https://nodejs.org/en) (see "engines" in `package.json`)
+- [Bun](https://bun.sh/) (see "packageManager" in `package.json`)

 ##### Setup steps:

@@ -30,7 +30,7 @@ runs:
            apiToken: ${{ inputs.apiToken }}
            accountId: ${{ inputs.accountId }}
            workingDirectory: ./
-            wranglerVersion: '4.10.0'
+            wranglerVersion: '4.43.0'
            environment: ${{ inputs.environment }}
            command: deployments status --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc

@@ -49,7 +49,7 @@ runs:
            apiToken: ${{ inputs.apiToken }}
            accountId: ${{ inputs.accountId }}
            workingDirectory: ./
-            wranglerVersion: '4.10.0'
+            wranglerVersion: '4.43.0'
            environment: ${{ inputs.environment }}
            command: versions deploy ${{ steps.extract_current_version.outputs.version_id }}@100% ${{ inputs.serverVersionId }}@0% -y --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc

@@ -61,7 +61,7 @@ runs:
            apiToken: ${{ inputs.apiToken }}
            accountId: ${{ inputs.accountId }}
            workingDirectory: ./
-            wranglerVersion: '4.10.0'
+            wranglerVersion: '4.43.0'
            environment: ${{ inputs.environment }}
            command: versions deploy ${{ inputs.middlewareVersionId }}@100% -y --config ./packages/gitbook/openNext/customWorkers/middlewareWrangler.jsonc

@@ -71,7 +71,7 @@ runs:
            apiToken: ${{ inputs.apiToken }}
            accountId: ${{ inputs.accountId }}
            workingDirectory: ./
-            wranglerVersion: '4.10.0'
+            wranglerVersion: '4.43.0'
            environment: ${{ inputs.environment }}
            command: versions deploy ${{ inputs.serverVersionId }}@100% -y --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc

@@ -1,37 +0,0 @@
-name: 'Setup Playwright'
-description: 'Install Playwright and dependencies'
-runs:
-    using: 'composite'
-    steps:
-        # Run npm ci and get Playwright version
-        - name: 🏗 Prepare Playwright env
-          shell: bash
-          run: |
-              PLAYWRIGHT_VERSION=$(npm ls --json @playwright/test | jq --raw-output '.dependencies["gitbook"].dependencies["@playwright/test"].version')
-              echo "PLAYWRIGHT_VERSION=$PLAYWRIGHT_VERSION" >> $GITHUB_ENV
-
-        # Cache browser binaries, cache key is based on Playwright version and OS
-        - name: 🧰 Cache Playwright browser binaries
-          uses: actions/cache@v4
-          id: playwright-cache
-          with:
-              path: '~/.cache/ms-playwright'
-              key: '${{ runner.os }}-playwright-${{ env.PLAYWRIGHT_VERSION }}'
-              restore-keys: |
-                  ${{ runner.os }}-playwright-
-
-        # Install browser binaries & OS dependencies if cache missed
-        - name: 🏗 Install Playwright browser binaries & OS dependencies
-          if: steps.playwright-cache.outputs.cache-hit != 'true'
-          shell: bash
-          working-directory: packages/gitbook
-          run: |
-              bun x playwright install --with-deps chromium
-
-        # Install only the OS dependencies if cache hit
-        - name: 🏗 Install Playwright OS dependencies
-          if: steps.playwright-cache.outputs.cache-hit == 'true'
-          shell: bash
-          working-directory: packages/gitbook
-          run: |
-              bun x playwright install-deps
@@ -70,7 +70,7 @@ runs:
              apiToken: ${{ inputs.apiToken }}
              accountId: ${{ inputs.accountId }}
              workingDirectory: ./
-              wranglerVersion: '4.10.0'
+              wranglerVersion: '4.43.0'
              environment: ${{ inputs.environment }}
              command: deploy --config ./packages/gitbook/openNext/customWorkers/doWrangler.jsonc

@@ -81,7 +81,7 @@ runs:
              apiToken: ${{ inputs.apiToken }}
              accountId: ${{ inputs.accountId }}
              workingDirectory: ./
-              wranglerVersion: '4.10.0'
+              wranglerVersion: '4.43.0'
              environment: ${{ inputs.environment }}
              command: ${{ format('versions upload --tag {0} --message "{1}"', inputs.commitTag, inputs.commitMessage) }} --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc

@@ -104,7 +104,7 @@ runs:
              apiToken: ${{ inputs.apiToken }}
              accountId: ${{ inputs.accountId }}
              workingDirectory: ./
-              wranglerVersion: '4.10.0'
+              wranglerVersion: '4.43.0'
              environment: ${{ inputs.environment }}
              command: ${{ format('versions upload --tag {0} --message "{1}"', inputs.commitTag, inputs.commitMessage) }} --config ./packages/gitbook/openNext/customWorkers/middlewareWrangler.jsonc
        
@@ -4,8 +4,7 @@ on:
    push:
        branches:
            - main
-env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
+            - changeset-release/main
 jobs:
    format:
        runs-on: ubuntu-latest
@@ -35,13 +34,10 @@ jobs:
              env:
                  PUPPETEER_SKIP_DOWNLOAD: 1
            - run: bun unit
-    build-oss:
-        # CI to check that the repository builds correctly on a machine without the credentials
+    build:
        runs-on: ubuntu-latest
-        name: Build (Open Source)
+        name: Build
        timeout-minutes: 6
-        env:
-            NPM_TOKEN_READONLY: ''
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -4,8 +4,6 @@ on:
    push:
      branches:
        - main
-env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (preview)
@@ -102,7 +100,7 @@ jobs:
        runs-on: ubuntu-latest
        name: Visual Testing v2
        needs: deploy-v2-vercel
-        timeout-minutes: 10
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -110,8 +108,8 @@ jobs:
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
              run: bun install --frozen-lockfile
-            - name: Setup Playwright
-              uses: ./.github/actions/setup-playwright
+              env:
+                  PUPPETEER_SKIP_DOWNLOAD: 1
            - name: Run Playwright tests
              run: bun e2e
              env:
@@ -123,7 +121,7 @@ jobs:
        runs-on: ubuntu-latest
        name: Visual Testing v2 (Cloudflare)
        needs: deploy-v2-cloudflare
-        timeout-minutes: 10
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -131,8 +129,8 @@ jobs:
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
              run: bun install --frozen-lockfile
-            - name: Setup Playwright
-              uses: ./.github/actions/setup-playwright
+              env:
+                  PUPPETEER_SKIP_DOWNLOAD: 1
            - name: Run Playwright tests
              run: bun e2e
              env:
@@ -144,7 +142,7 @@ jobs:
        runs-on: ubuntu-latest
        name: Visual Testing Customers v2
        needs: deploy-v2-vercel
-        timeout-minutes: 10
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -152,8 +150,8 @@ jobs:
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
              run: bun install --frozen-lockfile
-            - name: Setup Playwright
-              uses: ./.github/actions/setup-playwright
+              env:
+                  PUPPETEER_SKIP_DOWNLOAD: 1
            - name: Run Playwright tests
              run: bun e2e-customers
              env:
@@ -165,7 +163,7 @@ jobs:
        runs-on: ubuntu-latest
        name: Visual Testing Customers v2 (Cloudflare)
        needs: deploy-v2-cloudflare
-        timeout-minutes: 10
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -173,8 +171,8 @@ jobs:
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
              run: bun install --frozen-lockfile
-            - name: Setup Playwright
-              uses: ./.github/actions/setup-playwright
+              env:
+                  PUPPETEER_SKIP_DOWNLOAD: 1
            - name: Run Playwright tests
              run: bun e2e-customers
              env:
@@ -182,9 +180,9 @@ jobs:
                  SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
                  ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}
                  ARGOS_BUILD_NAME: 'customers-v2'
-    pagespeed-testing-v2:
+    browserless-testing-v2-vercel:
        runs-on: ubuntu-latest
-        name: PageSpeed Testing v1
+        name: Browserless Testing v2 (Vercel)
        needs: deploy-v2-vercel
        steps:
            - name: Checkout
@@ -195,8 +193,26 @@ jobs:
              run: bun install --frozen-lockfile
              env:
                  PUPPETEER_SKIP_DOWNLOAD: 1
-            - name: Run pagespeed tests
-              run: bun ./packages/gitbook/tests/pagespeed-testing.ts
+            - name: Run tests
+              run: cd ./packages/gitbook && bun e2e-browserless
              env:
                  BASE_URL: ${{needs.deploy-v2-vercel.outputs.deployment-url}}
-                  PAGESPEED_API_KEY: ${{ secrets.PAGESPEED_API_KEY }}
+                  SITE_BASE_URL: ${{ needs.deploy-v2-vercel.outputs.deployment-url }}/url/
+    # browserless-testing-v2-cloudflare:
+    #     runs-on: ubuntu-latest
+    #     name: Browserless Testing v2 (Cloudflare)
+    #     needs: deploy-v2-cloudflare
+    #     steps:
+    #         - name: Checkout
+    #           uses: actions/checkout@v4
+    #         - name: Setup Bun
+    #           uses: ./.github/composite/setup-bun
+    #         - name: Install dependencies
+    #           run: bun install --frozen-lockfile
+    #           env:
+    #               PUPPETEER_SKIP_DOWNLOAD: 1
+    #         - name: Run tests
+    #           run: cd ./packages/gitbook && bun e2e-browserless
+    #           env:
+    #               BASE_URL: ${{needs.deploy-v2-cloudflare.outputs.deployment-url}}
+    #               SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
@@ -3,8 +3,6 @@ on:
    push:
        branches:
            - main
-env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (production)
@@ -3,8 +3,6 @@ on:
    push:
        branches:
            - main
-env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (staging)
@@ -4,9 +4,6 @@ on:
    push:
        branches:
            - main
-
-env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
    
 concurrency: ${{ github.workflow }}-${{ github.ref }}

@@ -14,29 +11,38 @@ jobs:
    publish:
        name: Publish
        runs-on: ubuntu-latest
+        permissions:
+            id-token: write
+            pull-requests: write
+            contents: write
        steps:
            - name: Checkout Repo
              uses: actions/checkout@v3
              with:
                  # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
                  fetch-depth: 0
+            - name: Setup Node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 22
+                  registry-url: 'https://registry.npmjs.org'
+            # Ensure npm 11.5.1 or later is installed
+            - name: Update npm
+              run: npm install -g npm@latest
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
              run: bun install --frozen-lockfile
              env:
                  PUPPETEER_SKIP_DOWNLOAD: 1
-            - name: Create Release Pull Request or Publish to npm
+            - name: Create Release Pull Request
              id: changesets
              uses: changesets/action@v1
              with:
-                  publish: npm run release
-                  version: npm run changeset-version
+                  publish: bun run publish-all-packages
+                  version: bun run changeset-version
              env:
                  # Using a PAT instead of GITHUB_TOKEN because we need to run workflows when releases are created
                  # https://github.com/orgs/community/discussions/26875#discussioncomment-3253761
                  GITHUB_TOKEN: ${{ secrets.GH_PERSONAL_TOKEN }}
-                  NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-                  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
-                  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

@@ -25,3 +25,7 @@ yarn-error.log*

 # TypeScript
 *.tsbuildinfo
+.npmrc
+
+# Bun pack artifacts
+packages/*/*.tgz
@@ -1 +1 @@
-v20.6
+v22.3
@@ -35,10 +35,10 @@ To run a local version of this project, please follow these simple steps.

 ### Prerequisites

-   Node.js (Version: >=20.6)
+- Node.js (Version: >= 22.3)
    - Use nvm for easy Node management
-   Bun (Version: >=1.2.1)
-    - We use a text-based lockfile which isn't supported below 1.2.1
+- [Bun](https://bun.sh/) (Version: >=1.2.15)
+  - We use a text-based lockfile which isn't supported below 1.2.15

 ### Set up

@@ -77,23 +77,7 @@ All pull-requests will be tested against both visual and performances testing to

 ## Fonts and Icons

-GitBook Open uses fontawesome. During development, your local environment will use the free version. However, only the pro version will be accepted by CI. If you see the following error:
-
-```
-The GitBook icon is missing. It indicates that the dependencies were installed without the correct font-awesome package. These changes have probably been persisted in the Bun lockfile. Read the README for more information.
-```
-
-It means that you've changed the GBO dependencies and bundled in the free version. Only GitBook staff can help with this - if you're not on the GitBook team, please ping us in the PR and we'll help get things moving.
-
-If you are GitBook staff, you'll need our NPM token in your local environment.
-
-```
-.env.local
-
-NPM_TOKEN_READONLY=xxx
-```
-
-and then reinstall dependencies.
+GitBook Open uses fontawesome. For self-hosting and local development, for licensing reasons, only the icons from the free version should be used.

 ## Contributing

--- a/Show More
+++ b/Show More