chore(create-discord-bot): release create-discord-bot@4.0.0 (#10947)

* chore(create-discord-bot): release create-discord-bot@4.0.0

* chore(ci): handle identical deploy to create-discord-app

---------

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

.commitlintrc.json

@@ -5,8 +5,9 @@
 		"type-enum": [
 			2,
 			"always",
-			["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types", "typings"]
+			["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types"]
 		],
-		"scope-case": [0]
+		"scope-case": [0],
+		"subject-exclamation-mark": [0]
 	}
 }

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# .git-blame-ignore-revs
+# switched to eslint-config-neon for mainlib discord.js
+b03c65c34c6e8bab7f97d507d6ccd7c441a14360

.github/.kodiak.toml

@@ -2,7 +2,7 @@ version = 1
 
 [merge]
 require_automerge_label = false
-blocking_labels = ['blocked', 'in review']
+blocking_labels = ['blocked', 'in review', 'semver:major']
 method = 'squash'
 
 [merge.message]

.github/CODEOWNERS

@@ -1,13 +1,18 @@
 # Learn how to add code owners here:
-# https://help.github.com/en/articles/about-code-owners
+# https://help.github.com/articles/about-code-owners
 
 * @iCrawl
 
+package.json @discordjs/core
+pnpm-lock.yaml @discordjs/core
+
 /apps/guide/ @discordjs/website @discordjs/guide
 /apps/guide/src/content/ @discordjs/guide
 /apps/website/ @discordjs/website
 
 /packages/actions/ @discordjs/actions
+/packages/api-extractor/ @discordjs/api-extractor-utils
+/packages/api-extractor-model/ @discordjs/api-extractor-utils
 /packages/api-extractor-utils/ @discordjs/api-extractor-utils
 /packages/brokers/ @discordjs/brokers
 /packages/builders/ @discordjs/builders

.github/COMMIT_CONVENTION.md

@@ -7,7 +7,7 @@
 Messages must be matched by the following regex:
 
 ```js
-/^(revert: )?(feat|fix|docs|style|refactor|perf|test|workflow|build|ci|chore|types|wip)(\(.+\))?: .{1,72}/;
+/^(revert: )?(feat|fix|docs|style|refactor|perf|test|build|ci|chore|types)(\(.+\))?!?: .{1,72}/;
 ```
 
 #### Examples
@@ -55,6 +55,7 @@ A commit message consists of a **header**, **body** and **footer**. The header h
 ```
 
 The **header** is mandatory and the **scope** of the header is optional.
+If the commit contains **Breaking Changes**, a `!` can be added before the `:` as an indicator.
 
 ### Revert
 

.github/ISSUE_TEMPLATE/01-package_bug_report.yml

@@ -62,7 +62,7 @@ body:
       description: List necessary versions here. This includes your package version, runtime version, operating system etc.
       placeholder: |
         - discord.js 14.12.1 (`npm ls discord.js` or another package)
-        - Node.js 16.11.0 (`node --version`)
+        - Node.js 22.12.0 (`node --version`)
         - TypeScript 5.1.6 (`npm ls typescript` if you use it)
         - macOS Ventura 13.3.1
     validations:
@@ -107,7 +107,7 @@ body:
         - Guilds
         - GuildMembers
         - GuildModeration
-        - GuildEmojisAndStickers
+        - GuildExpressions
         - GuildIntegrations
         - GuildWebhooks
         - GuildInvites

.github/labeler.yml

@@ -1,60 +1,100 @@
 apps:guide:
-  - apps/guide/*
-  - apps/guide/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - apps/guide/*
+          - apps/guide/**/*
 apps:website:
-  - apps/website/*
-  - apps/website/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - apps/website/*
+          - apps/website/**/*
 packages:api-extractor:
-  - packages/api-extractor/*
-  - packages/api-extractor/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/api-extractor/*
+          - packages/api-extractor/**/*
 packages:api-extractor-model:
-  - packages/api-extractor-model/*
-  - packages/api-extractor-model/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/api-extractor-model/*
+          - packages/api-extractor-model/**/*
 packages:brokers:
-  - packages/brokers/*
-  - packages/brokers/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/brokers/*
+          - packages/brokers/**/*
 packages:builders:
-  - packages/builders/*
-  - packages/builders/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/builders/*
+          - packages/builders/**/*
 packages:collection:
-  - packages/collection/*
-  - packages/collection/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/collection/*
+          - packages/collection/**/*
 packages:core:
-  - packages/core/*
-  - packages/core/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/core/*
+          - packages/core/**/*
 packages:create-discord-bot:
-  - packages/create-discord-bot/*
-  - packages/create-discord-bot/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/create-discord-bot/*
+          - packages/create-discord-bot/**/*
 packages:discord.js:
-  - packages/discord.js/*
-  - packages/discord.js/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/discord.js/*
+          - packages/discord.js/**/*
 packages:docgen:
-  - packages/docgen/*
-  - packages/docgen/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/docgen/*
+          - packages/docgen/**/*
 packages:formatters:
-  - packages/formatters/*
-  - packages/formatters/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/formatters/*
+          - packages/formatters/**/*
 packages:next:
-  - packages/next/*
-  - packages/next/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/next/*
+          - packages/next/**/*
 packages:proxy:
-  - packages/proxy/*
-  - packages/proxy/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/proxy/*
+          - packages/proxy/**/*
 packages:proxy-container:
-  - packages/proxy-container/*
-  - packages/proxy-container/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/proxy-container/*
+          - packages/proxy-container/**/*
 packages:rest:
-  - packages/rest/*
-  - packages/rest/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/rest/*
+          - packages/rest/**/*
 packages:ui:
-  - packages/ui/*
-  - packages/ui/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/ui/*
+          - packages/ui/**/*
 packages:util:
-  - packages/util/*
-  - packages/util/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/util/*
+          - packages/util/**/*
 packages:voice:
-  - packages/voice/*
-  - packages/voice/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/voice/*
+          - packages/voice/**/*
 packages:ws:
-  - packages/ws/*
-  - packages/ws/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/ws/*
+          - packages/ws/**/*

.github/labels.yml

@@ -10,6 +10,8 @@
   color: 7ef7ef
 - name: backport
   color: 88aabb
+- name: backport-candidate
+  color: 0075ca
 - name: blocked
   color: fc1423
 - name: bug
@@ -38,8 +40,6 @@
   color: 80c042
 - name: good first issue
   color: 7057ff
-- name: has PR
-  color: 4b1f8e
 - name: help wanted
   color: '008672'
 - name: in progress

.github/workflows/cleanup-cache.yml

@@ -1,4 +1,4 @@
-# https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows#force-deleting-cache-entries
+# https://docs.github.com/actions/using-workflows/caching-dependencies-to-speed-up-workflows#force-deleting-cache-entries
 name: Cleanup caches
 on:
   pull_request:
@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Cleanup caches
         run: |

.github/workflows/deploy-website.yml

@@ -14,12 +14,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install Node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/deprecate-version.yml

@@ -34,12 +34,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install Node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/documentation.yml

@@ -36,14 +36,14 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ inputs.ref || '' }}
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
@@ -53,15 +53,18 @@ jobs:
 
       - name: Checkout main repository
         if: ${{ inputs.ref && inputs.ref != 'main' }}
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           path: 'main'
 
       - name: Build main
         if: ${{ inputs.ref && inputs.ref != 'main' }}
         shell: bash
+        env:
+          COREPACK_ENABLE_STRICT: 0
         run: |
           cd main
+          pnpm self-update 10
           pnpm install --frozen-lockfile --prefer-offline --loglevel error
           pnpm run build
           cd ..
@@ -75,7 +78,7 @@ jobs:
 
       - name: Apply tag to api-extractor config
         if: ${{ env.REF_TYPE == 'tag' && !inputs.ref }}
-        run: sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ steps.extract-tag.outputs.semver }}!' "packages/${{ steps.extract-tag.outputs.package}}/"
+        run: sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ github.ref_name }}!' "packages/${{ steps.extract-tag.outputs.package}}/api-extractor.json"
 
       - name: Build docs
         run: pnpm run docs
@@ -93,7 +96,7 @@ jobs:
           done
 
       - name: Checkout docs repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: 'discordjs/docs'
           token: ${{ secrets.DJS_DOCS }}
@@ -102,8 +105,14 @@ jobs:
       - name: Upload documentation to database
         if: ${{ env.REF_TYPE == 'tag' && (!inputs.ref || inputs.ref == 'main') }}
         env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./packages/actions/src/uploadDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -112,8 +121,14 @@ jobs:
       - name: Upload documentation to database
         if: ${{ env.REF_TYPE == 'tag' && inputs.ref && inputs.ref != 'main' }}
         env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./main/packages/actions/src/uploadDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -122,7 +137,10 @@ jobs:
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'tag' && (!inputs.ref || inputs.ref == 'main') }}
         env:
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./packages/actions/src/uploadSplitDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -131,7 +149,10 @@ jobs:
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'tag' && inputs.ref && inputs.ref != 'main' }}
         env:
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./main/packages/actions/src/uploadSplitDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -154,27 +175,45 @@ jobs:
       - name: Upload documentation to database
         if: ${{ env.REF_TYPE == 'branch' && (!inputs.ref || inputs.ref == 'main') }}
         env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./packages/actions/src/uploadDocumentation
 
       - name: Upload documentation to database
         if: ${{ env.REF_TYPE == 'branch' && inputs.ref && inputs.ref != 'main' }}
         env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./main/packages/actions/src/uploadDocumentation
 
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'branch' && (!inputs.ref || inputs.ref == 'main') }}
         env:
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./packages/actions/src/uploadSplitDocumentation
 
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'branch' && inputs.ref && inputs.ref != 'main' }}
         env:
-          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./main/packages/actions/src/uploadSplitDocumentation
 
       - name: Move docs to correct directory
@@ -211,12 +250,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/issue-triage.yml

@@ -6,7 +6,7 @@ jobs:
   issue-triage:
     runs-on: ubuntu-latest
     steps:
-      - uses: github/issue-labeler@v3.2
+      - uses: github/issue-labeler@v3.4
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           configuration-path: .github/issue-labeler.yml

.github/workflows/label-sync.yml

@@ -15,9 +15,9 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Label sync
-        uses: crazy-max/ghaction-github-labeler@v4
+        uses: crazy-max/ghaction-github-labeler@v5
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/lock.yml

@@ -11,7 +11,7 @@ jobs:
     permissions:
       issues: write
     steps:
-      - uses: dessant/lock-threads@v4
+      - uses: dessant/lock-threads@v5
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           issue-inactive-days: 365

.github/workflows/pr-triage.yml

@@ -1,13 +1,35 @@
 name: 'PR Triage'
 on:
   pull_request_target:
+    types:
+      - opened
+      - edited
+      - reopened
+      - synchronize
 jobs:
-  pr-triage:
-    name: PR Triage
+  label:
+    name: Label
+    if: github.event.action != 'edited'
     runs-on: ubuntu-latest
     steps:
-      - name: Automatically label PR
-        uses: actions/labeler@v4
+      - name: Label pull request
+        uses: actions/labeler@v5
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           sync-labels: true
+  validate-title:
+    name: Validate title
+    if: github.event.action != 'synchronize'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate pull request title
+        env:
+          TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          REGEX="^(revert: )?(feat|fix|docs|style|refactor|perf|test|build|ci|chore|types)(\\(.+\\))?!?: .{1,72}$"
+
+          echo "Title: \"$TITLE\""
+
+          if [[ ! "$TITLE" =~ $REGEX ]]; then
+            exit 1
+          fi

.github/workflows/publish-dev-docker.yml

@@ -10,18 +10,18 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to DockerHub
         run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin

.github/workflows/publish-dev.yml

@@ -43,14 +43,14 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
           registry-url: https://registry.npmjs.org/
 
       - name: Check the current development version
@@ -72,7 +72,7 @@ jobs:
       - name: Publish package
         if: steps.release-check.outputs.release == '1'
         run: |
-          pnpm --filter=${{ matrix.package }} run release --preid "dev.$(date +%s)-$(git rev-parse --short HEAD)"
+          pnpm --filter=${{ matrix.package }} run release --preid "dev.$(date +%s)-$(git rev-parse --short HEAD)" --skip-changelog
           pnpm --filter=${{ matrix.package }} publish --provenance --no-git-checks --tag dev || true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/publish-docker.yml

@@ -7,18 +7,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to DockerHub
         run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin

.github/workflows/publish-release.yml

@@ -14,12 +14,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
           registry-url: https://registry.npmjs.org/
 
       - name: Install dependencies
@@ -39,3 +39,11 @@ jobs:
           pnpm --filter=${{ steps.extract-tag.outputs.subpackage == 'true' && '@discordjs/' || '' }}${{ steps.extract-tag.outputs.package }} publish --provenance --no-git-checks
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
+
+      - name: create-discord-bot -> create-discord-app
+        if: steps.extract-tag.outputs.package == 'create-discord-bot'
+        run: |
+          pnpm --filter=create-discord-bot run rename-to-app
+          pnpm --filter=create-discord-app publish --provenance --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/tests.yml

@@ -15,14 +15,14 @@ jobs:
       TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
@@ -62,3 +62,5 @@ jobs:
       - name: Upload Coverage
         if: github.repository_owner == 'discordjs'
         uses: ./packages/actions/src/uploadCoverage
+        with:
+          codecov_token: ${{ secrets.CODECOV_TOKEN }}

.gitignore

@@ -17,6 +17,7 @@ pids
 # Dist
 dist
 dist-docs
+packages/discord-api-types
 
 # Miscellaneous
 .tmp

.npmrc

@@ -1,6 +0,0 @@
-auto-install-peers=false
-resolution-mode=highest
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-public-hoist-pattern[]=*@rushstack/node-core-library*
-public-hoist-pattern[]=*jju*

.vscode/settings.json

@@ -1,32 +1,54 @@
 {
 	"eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact"],
-	"eslint.experimental.useFlatConfig": true,
-	"eslint.workingDirectories": [
-		{ "directory": "${workspaceFolder}" },
-		{ "pattern": "./apps/*/" },
-		{ "pattern": "./packages/*/" }
-	],
+	"eslint.useESLintClass": true,
+	"eslint.useFlatConfig": true,
 	"editor.defaultFormatter": "esbenp.prettier-vscode",
 	"editor.formatOnSave": true,
 	"editor.codeActionsOnSave": {
 		"source.organizeImports": "never",
-		"source.fixAll.eslint": "explicit",
-		"source.fixAll": "explicit"
+		"source.fixAll.eslint": "always",
+		"source.fixAll": "always"
 	},
 	"editor.trimAutoWhitespace": false,
 	"files.associations": {
-		"api-extractor.json": "jsonc",
-		"api-extractor-docs.json": "jsonc",
 		"tsconfig.json": "jsonc",
-		"tsconfig.eslint.json": "jsonc",
-		"tsconfig.docs.json": "jsonc"
+		"tsconfig.eslint.json": "jsonc"
 	},
 	"files.insertFinalNewline": true,
 	"files.eol": "\n",
+	"search.exclude": {
+		"**/.yarn": true,
+		"**/.next": true,
+		"**/dist": true,
+		"**/coverage": true,
+		"**/test-results": true
+	},
+	"search.followSymlinks": false,
+	"search.useParentIgnoreFiles": true,
+	"files.watcherExclude": {
+		"**/.next/*/**": true,
+		"**/.yarn/*/**": true,
+		"**/coverage/*/**": true,
+		"**/dist/*/**": true,
+		"**/test-results/*/**": true
+	},
+	"unocss.disable": true,
 	"npm.packageManager": "pnpm",
 	"typescript.tsdk": "node_modules/typescript/lib",
 	"typescript.enablePromptUseWorkspaceTsdk": true,
-	"unocss.disable": true,
+	"tailwindCSS.experimental.classRegex": [
+		["cva\\(((?:[^()]|\\([^()]*\\))*)\\)", "[\"'`]?([^\"'`]+)[\"'`]?"],
+		["cx\\(((?:[^()]|\\([^()]*\\))*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"],
+		["class:\\s*?[\"'`]([^\"'`]*).*?,"]
+	],
+	"workbench.editor.customLabels.patterns": {
+		"**/app/**/page.tsx": "${dirname} (${filename}.${extname}) - Page",
+		"**/app/**/layout.tsx": "${dirname} (${filename}.${extname}) - Layout",
+		"**/app/**/template.tsx": "${dirname} (${filename}.${extname}) - Template",
+		"**/app/**/error.tsx": "${dirname} (${filename}.${extname}) - Error",
+		"**/app/**/not-found.tsx": "${dirname} (${filename}.${extname}) - Not Found",
+		"**/components/**/page.tsx": "${dirname} (${filename}.${extname}) - Component"
+	},
 	"deno.enable": false,
 	"deno.enablePaths": ["./packages/create-discord-bot/template/Deno"],
 	"deno.lint": false,

README.md

@@ -9,7 +9,9 @@
 		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/v/discord.js.svg?maxAge=3600" alt="npm version" /></a>
 		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/dt/discord.js.svg?maxAge=3600" alt="npm downloads" /></a>
 		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Tests status" /></a>
-		<a href="https://codecov.io/gh/discordjs/discord.js" ><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2" alt="Code coverage" /></a>
+		<a href="https://github.com/discordjs/discord.js/commits/main"><img src="https://img.shields.io/github/last-commit/discordjs/discord.js.svg?logo=github&logoColor=ffffff" alt="Last commit." /></a>
+		<a href="https://github.com/discordjs/discord.js/graphs/contributors"><img src="https://img.shields.io/github/contributors/discordjs/discord.js.svg?maxAge=3600&logo=github&logoColor=fff&color=00c7be" alt="contributors" /></a>
+		<a href="https://codecov.io/gh/discordjs/discord.js"><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2" alt="Code coverage" /></a>
 	</p>
 	<p>
 		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>

apps/guide/.env.development

@@ -1 +1 @@
-METADATA_BASE_URL=http://localhost:3000
+NEXT_PUBLIC_LOCAL_DEV=true

apps/guide/.gitignore

@@ -16,13 +16,10 @@ pids
 .env*.local
 
 # Dist
-.contentlayer
 .next
-public/searchIndex
-src/styles/unocss.css
+.source
 
 # Miscellaneous
 .tmp
 .vscode
-lighthouse-results
-
+.vercel

apps/guide/.prettierignore

@@ -1,7 +1,8 @@
-.contentlayer
 .next
 .turbo
 .vscode
 coverage
+src/assets/readme
 src/styles/unocss.css
 next-env.d.ts
+.source

apps/guide/.prettierrc.cjs

@@ -0,0 +1,6 @@
+/** @type {import('prettier').Config} */
+module.exports = {
+	...require('../../.prettierrc.json'),
+	plugins: ['prettier-plugin-tailwindcss'],
+	tailwindFunctions: ['cva', 'cx'],
+};

apps/guide/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2022 Noel Buechler
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

apps/guide/README.md

@@ -14,10 +14,6 @@
 	</p>
 </div>
 
-## About
-
-The official guide for discord.js, made to help you get started easily with the library.
-
 ## Links
 
 - [Website][website] ([source][website-source])
@@ -47,6 +43,6 @@ If you don't understand something in the documentation, you are experiencing pro
 [guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
 [discord]: https://discord.gg/djs
 [discord-api]: https://discord.gg/discord-api
-[source]: https://github.com/discordjs/discord.js/tree/main/apps/guide
+[source]: https://github.com/discordjs/discord.js/tree/main/apps/website
 [related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
 [contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md

apps/guide/content/docs/index.mdx

@@ -0,0 +1,7 @@
+---
+title: Hello World
+---
+
+## Introduction
+
+I love Anime.

apps/guide/contentlayer.config.ts

@@ -1,94 +0,0 @@
-import { remarkCodeHike } from '@code-hike/mdx';
-import { defineDocumentType, makeSource } from 'contentlayer/source-files';
-import { type Node, toString } from 'hast-util-to-string';
-import { h } from 'hastscript';
-import { escape } from 'html-escaper';
-import rehypeAutolinkHeadings from 'rehype-autolink-headings';
-import rehypeSlug from 'rehype-slug';
-import remarkGfm from 'remark-gfm';
-import codeHikeThemeDarkPlus from './src/styles/code-hike-theme-dark-plus.json';
-
-export const Content = defineDocumentType(() => ({
-	name: 'Content',
-	filePathPattern: `**/*.mdx`,
-	contentType: 'mdx',
-	fields: {
-		title: {
-			type: 'string',
-			required: true,
-		},
-		category: {
-			type: 'string',
-			required: true,
-		},
-	},
-	computedFields: {
-		slug: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => doc._raw.flattenedPath.replace(/\d+-/g, ''),
-		},
-		url: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => `/guide/${doc._raw.flattenedPath.replace(/\d+-/g, '')}`,
-		},
-	},
-}));
-
-const LinkIcon = h(
-	'svg',
-	{
-		width: '1.25rem',
-		height: '1.25rem',
-		viewBox: '0 0 24 24',
-		fill: 'none',
-		stroke: 'currentColor',
-		strokeWidth: '2',
-		strokeLinecap: 'round',
-		strokeLinejoin: 'round',
-	},
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71',
-	}),
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71',
-	}),
-);
-
-const createSROnlyLabel = (text: any) => {
-	return h('span', { class: 'sr-only' }, `Section titled ${escape(text)}`);
-};
-
-export default makeSource({
-	contentDirPath: 'src/content',
-	documentTypes: [Content],
-	mdx: {
-		remarkPlugins: [remarkGfm, [remarkCodeHike, { theme: codeHikeThemeDarkPlus, lineNumbers: true }]],
-		rehypePlugins: [
-			rehypeSlug,
-			[
-				rehypeAutolinkHeadings,
-				{
-					properties: {
-						class:
-							'relative inline-flex place-items-center place-content-center outline-none text-black dark:text-white pr-2 -ml-8 opacity-0 group-hover:opacity-100',
-					},
-					behavior: 'prepend',
-					content: (heading: Node) => [
-						h(
-							`span.anchor-icon`,
-							{
-								ariaHidden: 'true',
-							},
-							LinkIcon,
-						),
-						createSROnlyLabel(toString(heading)),
-					],
-				},
-			],
-		],
-	},
-});

apps/guide/next-env.d.ts

@@ -2,4 +2,4 @@
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/basic-features/typescript for more information.
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

apps/guide/next.config.js

@@ -1,25 +0,0 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-/* eslint-disable @typescript-eslint/no-require-imports */
-// import bundleAnalyzer from '@next/bundle-analyzer';
-// import { withContentlayer } from 'next-contentlayer';
-const bundleAnalyzer = require('@next/bundle-analyzer');
-const { withContentlayer } = require('next-contentlayer');
-
-const withBundleAnalyzer = bundleAnalyzer({
-	enabled: process.env.ANALYZE === 'true',
-});
-
-module.exports = withBundleAnalyzer(
-	withContentlayer({
-		reactStrictMode: true,
-		experimental: {
-			typedRoutes: true,
-		},
-		images: {
-			dangerouslyAllowSVG: true,
-			contentDispositionType: 'attachment',
-			contentSecurityPolicy: "default-src 'self'; frame-src 'none'; sandbox;",
-		},
-		poweredByHeader: false,
-	}),
-);

apps/guide/next.config.ts

@@ -0,0 +1,38 @@
+import { createMDX } from 'fumadocs-mdx/next';
+import type { NextConfig } from 'next';
+
+const withMDX = createMDX();
+
+export default withMDX({
+	reactStrictMode: true,
+	serverExternalPackages: ['typescript', 'twoslash'],
+	images: {
+		dangerouslyAllowSVG: true,
+		contentDispositionType: 'attachment',
+		contentSecurityPolicy: "default-src 'self'; frame-src 'none'; sandbox;",
+		remotePatterns: [
+			{
+				protocol: 'http',
+				hostname: 'localhost',
+			},
+		],
+	},
+	poweredByHeader: false,
+	logging: {
+		fetches: {
+			fullUrl: true,
+		},
+	},
+	experimental: {
+		ppr: true,
+		reactCompiler: true,
+		useCache: true,
+		dynamicOnHover: true,
+	},
+	eslint: {
+		ignoreDuringBuilds: true,
+	},
+	typescript: {
+		ignoreBuildErrors: true,
+	},
+} satisfies NextConfig);

apps/guide/package.json

@@ -2,22 +2,21 @@
 	"$schema": "https://json.schemastore.org/package.json",
 	"name": "@discordjs/guide",
 	"version": "0.1.0",
-	"description": "Imagine a guide... that explores the many possibilities for your discord.js bot",
+	"description": "Imagine a bot... the most popular way to build discord bots",
 	"private": true,
 	"scripts": {
-		"test": "vitest run",
 		"build:check": "tsc --noEmit",
-		"build:local": "pnpm run build:prod",
-		"build:prod": "next build",
-		"build:analyze": "cross-env ANALYZE=true pnpm run build:prod",
+		"build:local": "cross-env NEXT_PUBLIC_LOCAL_DEV=true pnpm run build:prod",
+		"build:prod": "pnpm run build:next",
+		"build:next": "next build",
 		"preview": "next start",
-		"dev": "next dev",
-		"generate:contentlayer": "contentlayer build",
-		"lint": "pnpm run build:check && prettier --check . && cross-env TIMING=1 eslint --format=pretty src",
-		"format": "pnpm run build:check && prettier --write . && cross-env TIMING=1 eslint --fix --format=pretty src",
-		"fmt": "pnpm run format"
+		"dev": "next dev -p 3001 --turbopack",
+		"lint": "pnpm run build:check && prettier --check . && cross-env TIMING=1 eslint --format=pretty src ",
+		"format": "pnpm run build:check && prettier --write . && cross-env TIMING=1 eslint --fix --format=pretty src ",
+		"fmt": "pnpm run format",
+		"postinstall": "fumadocs-mdx"
 	},
-	"type": "commonjs",
+	"type": "module",
 	"directories": {
 		"lib": "src"
 	},
@@ -37,7 +36,7 @@
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/discordjs/discord.js.git",
-		"directory": "apps/guide"
+		"directory": "apps/website"
 	},
 	"bugs": {
 		"url": "https://github.com/discordjs/discord.js/issues"
@@ -45,56 +44,66 @@
 	"homepage": "https://discord.js.org",
 	"funding": "https://github.com/discordjs/discord.js?sponsor",
 	"dependencies": {
-		"@code-hike/mdx": "^0.9.0",
-		"@discordjs/ui": "workspace:^",
 		"@react-icons/all-files": "^4.1.0",
-		"@vercel/analytics": "^1.2.2",
-		"@vercel/edge-config": "^1.1.0",
-		"@vercel/og": "^0.6.2",
-		"ariakit": "2.0.0-next.44",
-		"cmdk": "^1.0.0",
-		"contentlayer": "^0.3.4",
-		"next": "14.2.1",
-		"next-contentlayer": "^0.3.4",
-		"next-themes": "^0.3.0",
-		"react": "^18.2.0",
-		"react-custom-scrollbars-2": "^4.5.0",
-		"react-dom": "^18.2.0",
-		"rehype-autolink-headings": "^6.1.1",
-		"rehype-slug": "^5.1.0",
-		"remark-gfm": "^3.0.1",
-		"sharp": "^0.33.3"
+		"@vercel/analytics": "^1.5.0",
+		"cmdk": "^1.1.1",
+		"cva": "1.0.0-beta.3",
+		"fumadocs-core": "^15.4.2",
+		"fumadocs-mdx": "^11.6.6",
+		"fumadocs-twoslash": "^3.1.3",
+		"fumadocs-ui": "^15.4.2",
+		"geist": "^1.4.2",
+		"immer": "^10.1.1",
+		"jotai": "^2.12.5",
+		"jotai-immer": "^0.4.1",
+		"lucide-react": "^0.511.0",
+		"motion": "^12.15.0",
+		"next": "15.4.0-canary.11",
+		"next-mdx-remote-client": "^2.1.2",
+		"next-themes": "^0.4.6",
+		"nuqs": "^2.4.3",
+		"react": "^19.1.0",
+		"react-aria": "^3.40.0",
+		"react-aria-components": "^1.9.0",
+		"react-dom": "^19.1.0",
+		"react-error-boundary": "^6.0.0",
+		"sharp": "^0.34.2",
+		"tailwind-merge": "^3.3.0",
+		"tw-animate-css": "^1.3.2",
+		"twoslash": "^0.3.1",
+		"usehooks-ts": "^3.1.1"
 	},
 	"devDependencies": {
-		"@next/bundle-analyzer": "14.2.1",
-		"@testing-library/react": "^15.0.2",
-		"@testing-library/user-event": "^14.5.2",
-		"@types/html-escaper": "^3.0.2",
-		"@types/node": "18.18.8",
-		"@types/react": "^18.2.79",
-		"@types/react-dom": "^18.2.25",
-		"@unocss/eslint-plugin": "^0.59.3",
-		"@unocss/postcss": "^0.58.5",
-		"@unocss/reset": "^0.59.3",
-		"@vitejs/plugin-react": "^4.2.1",
-		"@vitest/coverage-v8": "^1.5.0",
+		"@next/env": "^15.3.3",
+		"@shikijs/rehype": "^3.4.2",
+		"@tailwindcss/postcss": "^4.1.8",
+		"@tailwindcss/typography": "^0.5.16",
+		"@tailwindcss/vite": "^4.1.8",
+		"@types/mdx": "^2.0.13",
+		"@types/node": "^22.15.26",
+		"@types/react": "^19.1.6",
+		"@types/react-dom": "^19.1.5",
+		"autoprefixer": "^10.4.21",
+		"babel-plugin-react-compiler": "19.1.0-rc.2",
+		"cpy-cli": "^5.0.0",
 		"cross-env": "^7.0.3",
-		"eslint": "^8.57.0",
-		"eslint-config-neon": "^0.1.62",
+		"eslint": "^9.27.0",
+		"eslint-config-neon": "^0.2.7",
 		"eslint-formatter-pretty": "^6.0.1",
-		"happy-dom": "^14.7.1",
-		"hast-util-to-string": "^2.0.0",
-		"hastscript": "^8.0.0",
-		"html-escaper": "^3.0.3",
-		"postcss": "^8.4.38",
-		"prettier": "^3.2.5",
-		"turbo": "^1.13.2",
-		"typescript": "^5.4.5",
-		"unocss": "^0.59.3",
-		"vercel": "^34.0.0",
-		"vitest": "^1.5.0"
+		"git-describe": "^4.1.1",
+		"postcss": "^8.5.4",
+		"prettier": "^3.5.3",
+		"prettier-plugin-tailwindcss": "^0.6.11",
+		"remark-gfm": "^4.0.1",
+		"remark-rehype": "^11.1.2",
+		"shiki": "^3.4.2",
+		"tailwindcss": "^4.1.8",
+		"tailwindcss-react-aria-components": "^2.0.0",
+		"turbo": "^2.5.3",
+		"typescript": "^5.8.2",
+		"vercel": "^42.2.0"
 	},
 	"engines": {
-		"node": ">=18"
+		"node": ">=22.12.0"
 	}
 }

apps/guide/postcss.config.cjs

@@ -1,5 +0,0 @@
-module.exports = {
-	plugins: {
-		'@unocss/postcss': {},
-	},
-};

apps/guide/postcss.config.js

@@ -0,0 +1,5 @@
+export default {
+	plugins: {
+		'@tailwindcss/postcss': {},
+	},
+};

apps/guide/public/logo.svg

@@ -0,0 +1,35 @@
+<svg width="5232" height="945" viewBox="0 0 5232 945" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g filter="url(#filter0_dd)">
+<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="3979" y="20" width="1245" height="907">
+<path d="M4685.1 692.37C4747.89 751.167 4832.06 791.257 4913.55 791.257C5011.09 791.257 5065.87 747.156 5065.87 679.006C5065.87 606.85 5009.75 584.134 4929.59 550.728L4810.68 498.614C4723.84 462.533 4634.33 394.383 4634.33 266.097C4634.33 127.126 4757.25 20.2217 4926.92 20.2217C5029.79 20.2217 5128.66 62.9858 5196.8 131.136L5116.63 230.019C5061.85 183.252 5001.74 155.187 4926.92 155.187C4844.08 155.187 4790.64 193.941 4790.64 258.082C4790.64 326.232 4857.45 351.623 4929.59 381.019L5047.17 430.464C5151.37 474.558 5223.51 540.035 5223.51 666.98C5223.51 808.627 5105.94 926.221 4909.56 926.221C4791.98 926.221 4678.42 879.451 4595.59 797.937L4685.1 692.37Z" fill="white"/>
+<path d="M4362.62 20.2217H4514.42V625.218C4514.42 785.559 4419.32 925.689 4236.89 925.689C4112.78 933.776 4006.36 848.244 3979.19 761.134C4001.8 757.707 4023.82 754.196 4051.3 745.549C4073.15 738.673 4105.83 723.903 4105.83 723.903C4130.43 763.127 4173.98 789.193 4223.6 789.193C4300.39 789.193 4362.64 726.761 4362.64 649.746L4362.62 20.2217Z" fill="white"/>
+</mask>
+<g mask="url(#mask0)">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3958.82 72.292L4012.02 47.467C4066.83 24.1022 4174.84 -22.6272 4282.85 -34.3096C4390.86 -45.992 4498.87 -22.6272 4606.88 -28.4684C4713.28 -34.3096 4821.29 -69.3567 4929.3 -45.992C5037.31 -22.6272 5145.32 59.1493 5200.14 101.498L5253.33 142.386V247.527H5200.14C5145.32 247.527 5037.31 247.527 4929.3 247.527C4821.29 247.527 4713.28 247.527 4606.88 247.527C4498.87 247.527 4390.86 247.527 4282.85 247.527C4174.84 247.527 4066.83 247.527 4012.02 247.527H3958.82V72.292Z" fill="#FF5C5C"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3958.82 76.645L4012.02 115.335C4066.83 154.026 4174.84 233.019 4282.85 233.019C4390.86 233.019 4498.87 154.026 4606.88 128.232C4713.28 102.439 4821.29 128.232 4929.3 141.129C5037.31 154.026 5145.32 154.026 5200.14 154.026H5253.33V426.47H5200.14C5145.32 426.47 5037.31 426.47 4929.3 426.47C4821.29 426.47 4713.28 426.47 4606.88 426.47C4498.87 426.47 4390.86 426.47 4282.85 426.47C4174.84 426.47 4066.83 426.47 4012.02 426.47H3958.82V76.645Z" fill="#F79454"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3958.82 247.527L4012.02 265.951C4066.83 284.375 4174.84 321.223 4282.85 321.223C4390.86 321.223 4498.87 284.375 4606.88 275.163C4713.28 265.951 4821.29 284.375 4929.3 316.617C5037.31 348.859 5145.32 396.071 5200.14 419.101L5253.33 442.131V497.403H5200.14C5145.32 497.403 5037.31 497.403 4929.3 497.403C4821.29 497.403 4713.28 497.403 4606.88 497.403C4498.87 497.403 4390.86 497.403 4282.85 497.403C4174.84 497.403 4066.83 497.403 4012.02 497.403H3958.82V247.527Z" fill="#FFDB5C"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3958.82 407.125L4012.76 420.44C4066.7 433.755 4174.57 460.384 4282.45 460.384C4390.32 460.384 4498.2 433.755 4606.08 440.412C4713.95 447.07 4821.83 487.014 4929.71 487.014C5037.58 487.014 5145.46 447.07 5199.4 427.098L5253.33 407.125V766.624H5199.4C5145.46 766.624 5037.58 766.624 4929.71 766.624C4821.83 766.624 4713.95 766.624 4606.08 766.624C4498.2 766.624 4390.32 766.624 4282.45 766.624C4174.57 766.624 4066.7 766.624 4012.76 766.624H3958.82V407.125Z" fill="#5CFF9D"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5253.34 600.577L5200.14 613.169C5145.33 625.76 5037.31 650.943 4929.3 644.648C4821.29 638.352 4713.28 600.577 4605.27 600.577C4498.87 600.577 4390.86 638.352 4282.85 657.239C4174.84 677.7 4066.83 677.7 4012.02 677.7H3958.82V866.573H4012.02C4066.83 866.573 4174.84 866.573 4282.85 866.573C4390.86 866.573 4498.87 866.573 4605.27 866.573C4713.28 866.573 4821.29 866.573 4929.3 866.573C5037.31 866.573 5145.33 866.573 5200.14 866.573H5253.34V600.577Z" fill="#5C6CFF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3958.82 760.175L4090.21 692.467C4132.12 760.175 4174.84 794.363 4282.85 798.637C4390.86 802.91 4498.87 772.266 4606.88 772.266C4713.28 772.266 4821.29 802.91 4929.3 798.637C5037.31 794.363 5179.98 760.175 5229.96 740.024L5253.33 760.175V940.73H5200.14C5145.32 940.73 5037.31 940.73 4929.3 940.73C4821.29 940.73 4713.28 940.73 4606.88 940.73C4498.87 940.73 4390.86 940.73 4282.85 940.73C4174.84 940.73 4066.83 940.73 4012.02 940.73H3958.82V760.175Z" fill="#B75CFF"/>
+</g>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M4264.21 348.906C4264.21 282.978 4251.78 225.648 4226.94 175.965C4201.14 127.234 4163.88 89.0164 4114.19 61.3076C4064.51 33.5989 4004.32 20.2217 3932.65 20.2217H3667.03V689.056H3892.98H3920.23C3986.6 689.056 4037.45 678.548 4084.65 654.747C4084.59 653.088 4084.57 651.421 4084.57 649.746C4084.57 572.732 4146.82 510.3 4223.61 510.3C4225.89 510.3 4228.16 510.355 4230.41 510.464C4254.5 461.424 4264.21 412.805 4264.21 348.906ZM3827.55 163.544V545.734H3918.32C3976.61 545.734 4020.56 528.534 4050.18 493.183C4079.8 458.785 4095.08 411.967 4095.08 351.772C4095.08 292.533 4080.75 246.67 4052.09 213.229C4023.42 179.786 3980.43 163.544 3924.05 163.544H3827.55Z" fill="#5865F2"/>
+<path d="M4311.87 649.747C4311.87 698.271 4272.53 737.606 4224.01 737.606C4175.49 737.606 4136.15 698.271 4136.15 649.747C4136.15 601.222 4175.49 561.887 4224.01 561.887C4272.53 561.887 4311.87 601.222 4311.87 649.747Z" fill="#5865F2"/>
+<path d="M261.386 689.469C335.011 689.469 398.119 675.125 449.752 645.481C501.386 616.793 540.589 576.63 566.405 524.991C592.222 474.309 605.609 415.02 605.609 349.038C605.609 283.055 593.178 225.679 568.318 175.953C542.501 127.184 505.21 88.933 455.489 61.2012C405.768 33.4694 345.529 20.0816 273.816 20.0816H8V689.469H261.386ZM168.637 546.029V163.522H265.211C321.625 163.522 364.653 179.778 393.338 213.248C422.023 246.717 436.366 292.618 436.366 351.907C436.366 412.152 421.067 459.009 391.426 493.434C361.784 528.816 317.8 546.029 259.474 546.029H168.637ZM878.299 20.0816H717.662V689.469H878.299V20.0816ZM1237.12 709.551C1316.48 709.551 1379.59 690.426 1425.48 651.219C1470.42 612.968 1493.37 560.373 1493.37 494.391C1493.37 444.665 1479.03 403.545 1450.34 371.032C1421.66 339.475 1375.76 312.7 1311.7 292.618L1242.85 270.624C1217.04 260.105 1198.87 249.586 1187.4 239.067C1174.97 228.548 1169.23 216.117 1169.23 199.86C1169.23 159.697 1200.78 139.615 1264.85 139.615C1332.74 139.615 1397.76 161.609 1460.86 206.554V59.2886C1393.93 20.0816 1323.17 0 1247.64 0C1170.19 0 1108.99 18.1691 1065.01 54.5072C1021.02 91.8017 999.031 141.528 999.031 205.598C999.031 253.411 1012.42 292.618 1038.23 323.219C1064.05 354.775 1106.12 379.638 1163.49 399.72L1241.9 425.539C1269.63 437.014 1288.75 447.534 1299.27 458.052C1309.79 468.571 1314.57 482.915 1314.57 499.172C1314.57 545.073 1283.01 568.023 1218.95 568.023C1180.7 568.023 1142.46 560.373 1103.25 546.029C1064.05 531.685 1029.63 513.516 999.031 489.609V638.787C1070.74 685.644 1150.11 709.551 1237.12 709.551ZM1921.29 708.595C1962.43 708.595 2002.57 702.857 2039.85 692.338C2077.17 681.819 2109.67 667.475 2137.39 649.306V502.997C2112.53 520.21 2084.8 533.598 2053.26 544.116C2021.69 554.635 1990.15 560.373 1957.64 560.373C1912.69 560.373 1872.53 551.767 1839.06 533.598C1805.6 516.385 1779.78 492.478 1761.61 460.921C1743.45 429.364 1733.89 393.982 1733.89 353.819C1733.89 313.656 1743.45 278.274 1761.61 246.717C1779.78 215.16 1805.6 191.254 1839.06 174.041C1872.53 156.828 1910.77 148.221 1955.72 148.221C2020.73 148.221 2080.02 168.303 2134.54 207.51V55.4635C2072.39 19.1253 2002.57 0.956277 1923.22 0.956277C1851.49 0.956277 1788.39 16.2564 1734.84 46.857C1680.34 77.4576 1639.22 119.533 1609.58 174.041C1579.94 228.548 1565.6 289.749 1565.6 358.601C1565.6 423.627 1579.94 482.915 1607.67 535.51C1635.4 589.061 1676.51 631.137 1730.06 661.737C1783.61 693.294 1847.67 708.595 1921.29 708.595ZM2561.67 708.595C2629.56 708.595 2689.82 693.294 2743.34 663.65C2795.93 634.006 2838.02 591.93 2867.64 538.379C2897.29 484.828 2911.63 423.627 2911.63 355.732C2911.63 287.837 2897.29 226.635 2867.64 172.128C2838.02 118.577 2795.93 76.5013 2743.34 45.9007C2689.82 16.2564 2629.56 0.956277 2561.67 0.956277C2494.73 0.956277 2434.51 16.2564 2381.92 45.9007C2329.33 76.5013 2288.22 118.577 2258.58 172.128C2228.93 226.635 2213.62 287.837 2213.62 355.732C2213.62 423.627 2228.93 484.828 2258.58 538.379C2288.22 591.93 2329.33 634.006 2381.92 663.65C2434.51 693.294 2494.73 708.595 2561.67 708.595ZM2561.67 556.548C2525.34 556.548 2493.8 547.942 2467.01 530.729C2439.29 513.516 2418.24 489.609 2403.9 459.009C2389.56 429.364 2381.92 394.939 2381.92 356.688C2381.92 318.437 2389.56 284.012 2403.9 252.455C2418.24 221.854 2439.29 197.948 2467.01 179.778C2493.8 161.609 2525.34 153.003 2561.67 153.003C2598.98 153.003 2630.52 161.609 2658.25 179.778C2685.97 197.948 2707.02 221.854 2721.36 252.455C2735.7 284.012 2742.41 318.437 2742.41 356.688C2742.41 394.939 2734.74 429.364 2720.4 459.009C2706.05 489.609 2685.04 513.516 2658.25 530.729C2630.52 547.942 2598.98 556.548 2561.67 556.548ZM3373.13 419.802C3431.46 413.108 3475.42 392.07 3507 357.644C3538.54 323.219 3553.84 279.23 3553.84 226.635C3553.84 162.565 3532.8 112.84 3489.77 75.5452C3446.74 38.2507 3388.44 20.0816 3315.76 20.0816H3021.24V689.469H3181.9V407.37L3379.81 689.469H3572L3373.13 419.802ZM3181.9 154.915H3285.15C3316.72 154.915 3340.63 162.566 3356.87 176.91C3373.13 192.21 3381.73 214.204 3381.73 241.936C3381.73 271.58 3372.17 293.574 3354.01 309.831C3335.85 326.087 3309.06 333.738 3273.7 333.738H3181.9V154.915Z" fill="#5865F2"/>
+</g>
+<defs>
+<filter id="filter0_dd" x="0" y="0" width="5232" height="945" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dy="10"/>
+<feGaussianBlur stdDeviation="4"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.04 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dy="4"/>
+<feGaussianBlur stdDeviation="1.5"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.1 0"/>
+<feBlend mode="normal" in2="effect1_dropShadow" result="effect2_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect2_dropShadow" result="shape"/>
+</filter>
+</defs>
+</svg>

apps/guide/public/site.webmanifest

@@ -1,6 +1,6 @@
 {
-	"name": "discord.js guide",
-	"short_name": "discord.js guide",
+	"name": "discord.js",
+	"short_name": "discord.js",
 	"icons": [
 		{
 			"src": "/android-chrome-192x192.png",

apps/guide/source.config.ts

@@ -0,0 +1,24 @@
+import { rehypeCodeDefaultOptions } from 'fumadocs-core/mdx-plugins';
+import { defineConfig, defineDocs } from 'fumadocs-mdx/config';
+import { transformerTwoslash } from 'fumadocs-twoslash';
+import { createFileSystemTypesCache } from 'fumadocs-twoslash/cache-fs';
+
+export const docs = defineDocs({
+	dir: 'content/docs',
+});
+
+transformerTwoslash({
+	typesCache: createFileSystemTypesCache(),
+});
+
+export default defineConfig({
+	mdxOptions: {
+		rehypeCodeOptions: {
+			themes: {
+				light: 'github-light',
+				dark: 'github-dark',
+			},
+			transformers: [...(rehypeCodeDefaultOptions.transformers ?? []), transformerTwoslash()],
+		},
+	},
+});

apps/guide/src/app/_global-error.tsx

@@ -1,26 +0,0 @@
-'use client';
-
-import { inter } from '~/util/fonts';
-import { Providers } from './providers';
-
-import '~/styles/cmdk.css';
-import '~/styles/main.css';
-
-export default function GlobalError({ error }: { readonly error: Error }) {
-	console.error(error);
-
-	return (
-		<html className={inter.variable} lang="en" suppressHydrationWarning>
-			<body className="bg-light-600 dark:bg-dark-600 dark:text-light-900">
-				<Providers>
-					<main className="mx-auto max-w-2xl min-h-screen">
-						<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-							<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">500</h1>
-							<h2 className="text-[2rem] md:text-[3rem]">Error.</h2>
-						</div>
-					</main>
-				</Providers>
-			</body>
-		</html>
-	);
-}

apps/guide/src/app/api/search/route.ts

@@ -0,0 +1,4 @@
+import { createFromSource } from 'fumadocs-core/search/server';
+import { source } from '@/lib/source';
+
+export const { GET } = createFromSource(source);

apps/guide/src/app/docs-og/[...slug]/route.tsx

@@ -0,0 +1,36 @@
+import { generateOGImage } from 'fumadocs-ui/og';
+import { notFound } from 'next/navigation';
+import { source } from '@/lib/source';
+
+export function generateStaticParams() {
+	return source.generateParams().map((page) => ({
+		...page,
+		slug: [...page.slug, 'image.png'],
+	}));
+}
+
+export async function GET(_req: Request, { params }: { params: Promise<{ slug: string[] }> }) {
+	const { slug } = await params;
+	const page = source.getPage(slug.slice(0, -1));
+	// const fontData = await fetch(new URL('../../../assets/Geist-Regular.ttf', import.meta.url), {
+	// next: { revalidate: 604_800 },
+	// }).then(async (res) => res.arrayBuffer());
+
+	if (!page) {
+		notFound();
+	}
+
+	return generateOGImage({
+		title: page.data.title,
+		description: page.data.description,
+		site: 'discord.js Guide',
+		// fonts: [
+		// 	{
+		// 		name: 'Geist',
+		// 		data: fontData,
+		// 		weight: 900,
+		// 		style: 'normal',
+		// 	},
+		// ],
+	});
+}

apps/guide/src/app/error.tsx

@@ -1,12 +0,0 @@
-'use client';
-
-export default function Error({ error }: { readonly error: Error }) {
-	console.error(error);
-
-	return (
-		<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-			<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">500</h1>
-			<h2 className="text-[2rem] md:text-[3rem]">Error.</h2>
-		</div>
-	);
-}

apps/guide/src/app/guide/[...slug]/not-found.tsx

@@ -1 +0,0 @@
-export { default } from '~/app/not-found';

apps/guide/src/app/guide/[...slug]/page.tsx

@@ -1,21 +0,0 @@
-import { notFound } from 'next/navigation';
-import { allContents } from 'contentlayer/generated';
-import { Mdx } from '~/components/Mdx';
-
-export async function generateStaticParams() {
-	return allContents.map((content) => ({ slug: [content.slug] }));
-}
-
-export default function Page({ params }: { readonly params: { slug: string[] } }) {
-	const content = allContents.find((content) => content.slug === params.slug?.join('/'));
-
-	if (!content) {
-		notFound();
-	}
-
-	return (
-		<article className="max-w-none px-5 prose">
-			<Mdx code={content?.body.code ?? ''} />
-		</article>
-	);
-}

apps/guide/src/app/guide/[[...slug]]/page.tsx

@@ -0,0 +1,53 @@
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page';
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+import { source } from '@/lib/source';
+import { getMDXComponents } from '@/mdx-components';
+
+export async function generateStaticParams() {
+	return source.generateParams();
+}
+
+export async function generateMetadata(props: { params: Promise<{ slug?: string[] }> }) {
+	const params = await props.params;
+	const page = source.getPage(params.slug);
+
+	if (!page) {
+		notFound();
+	}
+
+	const image = ['/docs-og', ...(params.slug ?? []), 'image.png'].join('/');
+	return {
+		title: page.data.title,
+		description: page.data.description,
+		openGraph: {
+			images: image,
+		},
+		twitter: {
+			card: 'summary_large_image',
+			images: image,
+		},
+	} satisfies Metadata;
+}
+
+export default async function Page(props: { readonly params: Promise<{ slug?: string[] }> }) {
+	const params = await props.params;
+	const page = source.getPage(params.slug);
+
+	if (!page) {
+		notFound();
+	}
+
+	const MDX = page.data.body;
+
+	return (
+		<DocsPage full={page.data.full!} toc={page.data.toc}>
+			<DocsTitle>{page.data.title}</DocsTitle>
+			<DocsDescription>{page.data.description}</DocsDescription>
+			<DocsBody>
+				{/* eslint-disable-next-line @stylistic/jsx/jsx-pascal-case */}
+				<MDX components={getMDXComponents()} />
+			</DocsBody>
+		</DocsPage>
+	);
+}

apps/guide/src/app/guide/layout.tsx

@@ -1,25 +1,12 @@
-import type { PropsWithChildren } from 'react';
-import Footer from '~/components/Footer';
-import Header from '~/components/Header';
-import { Nav } from '~/components/Nav';
-import { Providers } from './providers';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/app/layout.config';
+import { source } from '@/lib/source';
 
-export default function Layout({ children }: PropsWithChildren) {
+export default function Layout({ children }: { readonly children: ReactNode }) {
 	return (
-		<Providers>
-			<main className="mx-auto max-w-7xl px-4 lg:max-w-full">
-				<Header />
-				<div className="relative top-6 mx-auto max-w-7xl gap-6 lg:max-w-full lg:flex">
-					<div className="lg:sticky lg:top-23 lg:h-[calc(100vh_-_105px)]">
-						<Nav />
-					</div>
-
-					<div className="mx-auto max-w-5xl min-w-xs w-full pb-10">
-						{children}
-						<Footer />
-					</div>
-				</div>
-			</main>
-		</Providers>
+		<DocsLayout tree={source.pageTree} {...baseOptions}>
+			{children}
+		</DocsLayout>
 	);
 }

apps/guide/src/app/guide/page.tsx

@@ -1,3 +0,0 @@
-export default function Page() {
-	return null;
-}

apps/guide/src/app/guide/providers.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import type { PropsWithChildren } from 'react';
-import { NavProvider } from '~/contexts/nav';
-
-export function Providers({ children }: PropsWithChildren) {
-	return <NavProvider>{children}</NavProvider>;
-}

apps/guide/src/app/layout.config.tsx

@@ -0,0 +1,7 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export const baseOptions: BaseLayoutProps = {
+	nav: {
+		title: 'discord.js Guide',
+	},
+};

apps/guide/src/app/layout.tsx

@@ -1,29 +1,27 @@
 import { Analytics } from '@vercel/analytics/react';
+import { RootProvider } from 'fumadocs-ui/provider';
+import { GeistMono } from 'geist/font/mono';
+import { GeistSans } from 'geist/font/sans';
 import type { Metadata, Viewport } from 'next';
 import type { PropsWithChildren } from 'react';
-import { DESCRIPTION } from '~/util/constants';
-import { inter, jetBrainsMono } from '~/util/fonts';
-import { Providers } from './providers';
+import { ENV } from '@/util/env';
 
-import '~/styles/cmdk.css';
-import '@code-hike/mdx/styles.css';
-import '~/styles/ch.css';
-import '~/styles/main.css';
+import '@/styles/base.css';
 
 export const viewport: Viewport = {
 	themeColor: [
-		{ media: '(prefers-color-scheme: light)', color: '#f1f3f5' },
-		{ media: '(prefers-color-scheme: dark)', color: '#181818' },
+		{ media: '(prefers-color-scheme: light)', color: '#fbfbfb' },
+		{ media: '(prefers-color-scheme: dark)', color: '#1a1a1e' },
 	],
 	colorScheme: 'light dark',
 };
 
 export const metadata: Metadata = {
-	metadataBase: new URL(
-		process.env.METADATA_BASE_URL ? process.env.METADATA_BASE_URL : `http://localhost:${process.env.PORT ?? 3_000}`,
-	),
-	title: 'discord.js',
-	description: DESCRIPTION,
+	metadataBase: new URL(ENV.IS_LOCAL_DEV ? `http://localhost:${ENV.PORT}` : 'https://next.discordjs.guide'),
+	title: {
+		template: '%s | discord.js',
+		default: 'discord.js',
+	},
 	icons: {
 		other: [
 			{
@@ -58,7 +56,6 @@ export const metadata: Metadata = {
 		siteName: 'discord.js',
 		type: 'website',
 		title: 'discord.js',
-		description: DESCRIPTION,
 		images: 'https://discordjs.dev/api/open-graph.png',
 	},
 
@@ -68,15 +65,15 @@ export const metadata: Metadata = {
 	},
 
 	other: {
-		'msapplication-TileColor': '#090a16',
+		'msapplication-TileColor': '#1a1a1e',
 	},
 };
 
-export default function RootLayout({ children }: PropsWithChildren) {
+export default async function RootLayout({ children }: PropsWithChildren) {
 	return (
-		<html className={`${inter.variable} ${jetBrainsMono.variable}`} lang="en" suppressHydrationWarning>
-			<body className="bg-light-600 dark:bg-dark-600 dark:text-light-900">
-				<Providers>{children}</Providers>
+		<html className={`${GeistSans.variable} ${GeistMono.variable} antialiased`} lang="en" suppressHydrationWarning>
+			<body className="overscroll-y-none">
+				<RootProvider>{children}</RootProvider>
 				<Analytics />
 			</body>
 		</html>

apps/guide/src/app/loading.tsx

@@ -1,20 +0,0 @@
-export default function Loading() {
-	return (
-		<div className="mx-4 min-h-screen flex flex-col items-center justify-center gap-4">
-			<svg
-				className="h-9 w-9 animate-spin text-black dark:text-white"
-				fill="none"
-				viewBox="0 0 24 24"
-				xmlns="http://www.w3.org/2000/svg"
-			>
-				<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
-				<path
-					className="opacity-75 dark:opacity-100"
-					d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
-					fill="currentColor"
-				/>
-			</svg>
-			<div className="text-lg font-medium">Loading...</div>
-		</div>
-	);
-}

apps/guide/src/app/not-found.tsx

@@ -1,16 +0,0 @@
-import Link from 'next/link';
-
-export default function NotFound() {
-	return (
-		<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-			<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">404</h1>
-			<h2 className="text-[2rem] md:text-[3rem]">Not found.</h2>
-			<Link
-				className="h-11 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded bg-blurple px-6 text-base text-white font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-white"
-				href="/guide"
-			>
-				Take me back
-			</Link>
-		</div>
-	);
-}

apps/guide/src/app/page.tsx

@@ -1,3 +1,5 @@
-export default function Page() {
-	return null;
+import { redirect } from 'next/navigation';
+
+export default async function Page() {
+	redirect('/guide');
 }

apps/guide/src/app/providers.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { PropsWithChildren } from 'react';
-
-export function Providers({ children }: PropsWithChildren) {
-	return <ThemeProvider attribute="class">{children}</ThemeProvider>;
-}

apps/guide/src/components/DiscordAPITypesLink.tsx

@@ -1,91 +0,0 @@
-import { FiExternalLink } from '@react-icons/all-files/fi/FiExternalLink';
-import type { PropsWithChildren } from 'react';
-import {
-	BASE_URL_DISCORD_API_TYPES,
-	DISCORD_API_TYPES_VERSION,
-	DISCORD_API_TYPES_VOICE_VERSION,
-} from '~/util/constants';
-
-interface DiscordAPITypesLinkOptions {
-	/**
-	 * The initial documentation enum, interface, function etc.
-	 *
-	 * @example `'RESTJSONErrorCodes'`
-	 */
-	readonly parent?: string;
-	/**
-	 * The scope of where this link lives.
-	 *
-	 * @remarks API does not have a scope.
-	 */
-	readonly scope?: 'gateway' | 'globals' | 'payloads' | 'rest' | 'rpc' | 'utils' | 'voice';
-	/**
-	 * The symbol belonging to the parent.
-	 *
-	 * @example '`MaximumNumberOfGuildsReached'`
-	 */
-	readonly symbol?: string;
-	/**
-	 * The type of the {@link DiscordAPITypesLinkOptions.parent}.
-	 *
-	 * @example `'enum'`
-	 * @example `'interface'`
-	 */
-	readonly type?: string;
-}
-
-export function DiscordAPITypesLink({
-	parent,
-	scope,
-	symbol,
-	type,
-	children,
-}: PropsWithChildren<DiscordAPITypesLinkOptions>) {
-	let url = BASE_URL_DISCORD_API_TYPES;
-	let text = 'discord-api-types';
-
-	if (type || parent) {
-		url += `/api/discord-api-types`;
-
-		switch (scope) {
-			case 'globals':
-				url += `-${scope}`;
-				break;
-			case 'gateway':
-			case 'payloads':
-			case 'rest':
-				url += `-${scope}/common`;
-				break;
-			case 'rpc':
-			case 'utils':
-				url += `-${scope}/${DISCORD_API_TYPES_VERSION}`;
-				break;
-			case 'voice':
-				url += `-${scope}/${DISCORD_API_TYPES_VOICE_VERSION}`;
-				break;
-			default:
-				url += `-${DISCORD_API_TYPES_VERSION}`;
-		}
-
-		if (type) {
-			url += `/${type}/${parent}`;
-			if (symbol) url += `#${symbol}`;
-		} else {
-			url += `#${parent}`;
-		}
-
-		text = `${parent}${symbol ? `#${symbol}` : ''}${type?.toUpperCase() === 'FUNCTION' ? '()' : ''}`;
-	}
-
-	return (
-		<a
-			className="inline-flex flex-row place-items-center gap-1"
-			href={url}
-			rel="external noopener noreferrer"
-			target="_blank"
-		>
-			{children ?? text}
-			<FiExternalLink size={18} />
-		</a>
-	);
-}

apps/guide/src/components/DocsLink.tsx

@@ -1,86 +0,0 @@
-import { FiExternalLink } from '@react-icons/all-files/fi/FiExternalLink';
-import type { PropsWithChildren } from 'react';
-import { BASE_URL, BASE_URL_LEGACY, PACKAGES, VERSION } from '~/util/constants';
-
-interface DocsLinkOptions {
-	/**
-	 * Whether to apply brackets to the end of the symbol to denote a method.
-	 *
-	 * @remarks Functions automatically infer this.
-	 */
-	readonly brackets?: boolean;
-	/**
-	 * The package.
-	 *
-	 * @defaultValue `'discord.js'`
-	 */
-	readonly package?: (typeof PACKAGES)[number];
-	/**
-	 * The initial documentation class, function, interface etc.
-	 *
-	 * @example `'Client'`
-	 */
-	readonly parent?: string;
-	/**
-	 * Whether to reference a static property.
-	 *
-	 * @remarks
-	 * This should only be used for the https://discord.js.org domain
-	 * as static properties are not identified in the URL.
-	 */
-	readonly static?: boolean;
-	/**
-	 * The symbol belonging to the parent.
-	 *
-	 * @example '`login'`
-	 */
-	readonly symbol?: string;
-	/**
-	 * The type of the {@link DocsLinkOptions.parent}.
-	 *
-	 * @example `'class'`
-	 * @example `'Function'`
-	 */
-	readonly type?: string;
-}
-
-export function DocsLink({
-	package: docs = PACKAGES[0],
-	type,
-	parent,
-	symbol,
-	brackets,
-	static: staticReference,
-	children,
-}: PropsWithChildren<DocsLinkOptions>) {
-	// In the case of no type and no parent, this will default to the entry point of the respective documentation.
-	let url = docs === PACKAGES[0] ? `${BASE_URL_LEGACY}/${VERSION}/general/welcome` : `${BASE_URL}/${docs}/stable`;
-	let text = `${docs === PACKAGES[0] ? '' : '@discordjs/'}${docs}`;
-
-	// If there is a type and parent, we need to do some parsing.
-	if (type && parent) {
-		const bracketText = brackets || type?.toUpperCase() === 'FUNCTION' ? '()' : '';
-
-		// Legacy discord.js documentation parsing.
-		if (docs === PACKAGES[0]) {
-			url = `${BASE_URL_LEGACY}/${VERSION}/${type}/${parent}`;
-			if (symbol) url += `?scrollTo=${symbol}`;
-
-			text = `${parent}${symbol ? (symbol.startsWith('s-') ? '.' : '#') : ''}${
-				// eslint-disable-next-line prefer-named-capture-group
-				symbol ? `${symbol.replace(/(e|s)-/, '')}` : ''
-			}${bracketText}`;
-		} else {
-			url += `/${parent}:${type}`;
-			if (symbol) url += `#${symbol}`;
-			text = `${parent}${symbol ? `${staticReference ? '.' : '#'}${symbol}` : ''}${bracketText}`;
-		}
-	}
-
-	return (
-		<a className="inline-flex flex-row place-items-center gap-1" href={url} rel="noopener noreferrer" target="_blank">
-			{children ?? text}
-			<FiExternalLink size={18} />
-		</a>
-	);
-}

apps/guide/src/components/Footer.tsx

@@ -1,98 +0,0 @@
-import Image from 'next/image';
-import vercelLogo from '~/assets/powered-by-vercel.svg';
-import workersLogo from '~/assets/powered-by-workers.png';
-
-export default function Footer() {
-	return (
-		<footer className="md:pl-12 md:pr-12">
-			<div className="flex flex-col flex-wrap place-content-center gap-6 pt-12 sm:flex-row md:gap-12">
-				<div className="flex flex-wrap place-content-center place-items-center gap-4">
-					<a
-						className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-						href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"
-						rel="external noopener noreferrer"
-						target="_blank"
-						title="Vercel"
-					>
-						<Image
-							alt="Vercel"
-							blurDataURL="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAABLCAQAAAA1k5H2AAAAi0lEQVR42u3SMQEAAAgDoC251a3gL2SgmfBYBRAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARCAgwWEOSWBnYbKggAAAABJRU5ErkJggg=="
-							height={44}
-							placeholder="blur"
-							src={vercelLogo}
-							width={212}
-						/>
-					</a>
-					<a
-						className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-						href="https://www.cloudflare.com"
-						rel="external noopener noreferrer"
-						target="_blank"
-						title="Cloudflare Workers"
-					>
-						<Image
-							alt="Cloudflare"
-							blurDataURL="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAABLCAQAAAA1k5H2AAAAi0lEQVR42u3SMQEAAAgDoC251a3gL2SgmfBYBRAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARCAgwWEOSWBnYbKggAAAABJRU5ErkJggg=="
-							height={44}
-							placeholder="blur"
-							priority
-							src={workersLogo}
-						/>
-					</a>
-				</div>
-				<div className="flex flex-col place-self-center gap-6 sm:flex-row md:gap-12">
-					<div className="max-w-max flex flex-col gap-2">
-						<div className="text-lg font-semibold">Community</div>
-						<div className="flex flex-col gap-1">
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord.gg/djs"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								Discord
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://github.com/discordjs/discord.js/discussions"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								GitHub discussions
-							</a>
-						</div>
-					</div>
-					<div className="max-w-max flex flex-col gap-2">
-						<div className="text-lg font-semibold">Project</div>
-						<div className="flex flex-col gap-1">
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://github.com/discordjs/discord.js"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								discord.js
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord.js.org/docs"
-								rel="noopener noreferrer"
-								target="_blank"
-							>
-								discord.js documentation
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord-api-types.dev"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								discord-api-types
-							</a>
-						</div>
-					</div>
-				</div>
-			</div>
-		</footer>
-	);
-}

apps/guide/src/components/H1.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H1({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h1 className={`group ${className}`} {...props}>
-			{children}
-		</h1>
-	);
-}

apps/guide/src/components/H2.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H2({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h2 className={`group ${className}`} {...props}>
-			{children}
-		</h2>
-	);
-}

apps/guide/src/components/H3.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H3({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h3 className={`group ${className}`} {...props}>
-			{children}
-		</h3>
-	);
-}

apps/guide/src/components/H4.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H4({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h4 className={`group ${className}`} {...props}>
-			{children}
-		</h4>
-	);
-}

apps/guide/src/components/Header.tsx

@@ -1,92 +0,0 @@
-'use client';
-
-import { VscGithubInverted } from '@react-icons/all-files/vsc/VscGithubInverted';
-import { VscMenu } from '@react-icons/all-files/vsc/VscMenu';
-import { Button } from 'ariakit/button';
-import type { Route } from 'next';
-import dynamic from 'next/dynamic';
-import Link from 'next/link';
-import { usePathname } from 'next/navigation';
-import { Fragment, useMemo } from 'react';
-import { useNav } from '~/contexts/nav';
-
-const ThemeSwitcher = dynamic(async () => import('./ThemeSwitcher'));
-
-export default function Header() {
-	const pathname = usePathname();
-	const { setOpened } = useNav();
-
-	const pathElements = useMemo(
-		() =>
-			pathname
-				.split('/')
-				.slice(1)
-				.map((path, idx, original) => (
-					<Link
-						className="rounded outline-none hover:underline focus:ring focus:ring-width-2 focus:ring-blurple"
-						href={`/${original.slice(0, idx + 1).join('/')}` as Route}
-						key={`${path}-${idx}`}
-					>
-						{path}
-					</Link>
-				)),
-		[pathname],
-	);
-
-	const breadcrumbs = useMemo(
-		() =>
-			pathElements.flatMap((el, idx, array) => {
-				if (idx === 0) {
-					return (
-						<Fragment key={`${el.key}-${idx}`}>
-							<div className="mx-2">/</div>
-							<div>{el}</div>
-							<div className="mx-2">/</div>
-						</Fragment>
-					);
-				}
-
-				if (idx !== array.length - 1) {
-					return (
-						<Fragment key={`${el.key}-${idx}`}>
-							<div>{el}</div>
-							<div className="mx-2">/</div>
-						</Fragment>
-					);
-				}
-
-				return <div key={`${el.key}-${idx}`}>{el}</div>;
-			}),
-		[pathElements],
-	);
-
-	return (
-		<header className="sticky top-4 z-20 border border-light-900 rounded-md bg-white/75 shadow backdrop-blur-md dark:border-dark-100 dark:bg-dark-600/75">
-			<div className="block h-16 px-6">
-				<div className="h-full flex flex-row place-content-between place-items-center gap-8">
-					<Button
-						aria-label="Menu"
-						className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none lg:hidden active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-						onClick={() => setOpened((open) => !open)}
-					>
-						<VscMenu size={24} />
-					</Button>
-					<div className="hidden lg:flex lg:grow lg:flex-row lg:overflow-hidden">{breadcrumbs}</div>
-					<div className="flex flex-row place-items-center gap-4">
-						<Button
-							aria-label="GitHub"
-							as="a"
-							className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded rounded-full bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-							href="https://github.com/discordjs/discord.js"
-							rel="external noopener noreferrer"
-							target="_blank"
-						>
-							<VscGithubInverted size={24} />
-						</Button>
-						<ThemeSwitcher />
-					</div>
-				</div>
-			</div>
-		</header>
-	);
-}

apps/guide/src/components/Mdx.tsx

@@ -1,34 +0,0 @@
-'use client';
-
-import { Alert, Section, DiscordMessages, DiscordMessage, DiscordMessageEmbed } from '@discordjs/ui';
-import { useMDXComponent } from 'next-contentlayer/hooks';
-import { DocsLink } from '~/components/DocsLink';
-import { ResultingCode } from '~/components/ResultingCode';
-import { DiscordAPITypesLink } from './DiscordAPITypesLink';
-import { H1 } from './H1';
-import { H2 } from './H2';
-import { H3 } from './H3';
-import { H4 } from './H4';
-
-export function Mdx({ code }: { readonly code: string }) {
-	const Component = useMDXComponent(code);
-
-	return (
-		<Component
-			components={{
-				Alert,
-				Section,
-				DiscordMessages,
-				DiscordMessage,
-				DiscordMessageEmbed,
-				DiscordAPITypesLink,
-				DocsLink,
-				ResultingCode,
-				h1: H1,
-				h2: H2,
-				h3: H3,
-				h4: H4,
-			}}
-		/>
-	);
-}

apps/guide/src/components/Nav.tsx

@@ -1,32 +0,0 @@
-'use client';
-
-import { Scrollbars } from 'react-custom-scrollbars-2';
-import { useNav } from '~/contexts/nav';
-import { Sidebar } from './Sidebar';
-
-export function Nav() {
-	const { opened } = useNav();
-
-	return (
-		<nav
-			className={`dark:bg-dark-600/75 dark:border-dark-100 border-light-900 top-22 fixed bottom-4 left-4 right-4 z-20 mx-auto max-w-5xl rounded-md border bg-white/75 shadow backdrop-blur-md ${
-				opened ? 'block' : 'hidden'
-			} lg:min-w-xs lg:sticky lg:block lg:h-full lg:w-full lg:max-w-xs`}
-		>
-			<Scrollbars
-				autoHide
-				className="[&>div]:overscroll-none"
-				hideTracksWhenNotNeeded
-				renderThumbVertical={(props) => <div {...props} className="z-30 rounded bg-light-900 dark:bg-dark-100" />}
-				renderTrackVertical={(props) => (
-					<div {...props} className="absolute bottom-0.5 right-0.5 top-0.5 z-30 w-1.5 rounded" />
-				)}
-				universal
-			>
-				<div className="flex flex-col gap-4 p-3">
-					<Sidebar />
-				</div>
-			</Scrollbars>
-		</nav>
-	);
-}

apps/guide/src/components/Outline.tsx

@@ -1,69 +0,0 @@
-import { useMemo, useState } from 'react';
-import { Scrollbars } from 'react-custom-scrollbars-2';
-
-const LINK_HEIGHT = 30;
-const INDICATOR_SIZE = 10;
-const INDICATOR_OFFSET = (LINK_HEIGHT - INDICATOR_SIZE) / 2;
-
-export function Outline({ headings }: { readonly headings: any[] }) {
-	// eslint-disable-next-line react/hook-use-state
-	const [active /* setActive */] = useState(0);
-
-	const headingItems = useMemo(
-		() =>
-			headings.map((heading, idx) => (
-				<a
-					className={`dark:border-dark-100 border-light-800 pl-6.5 focus:ring-width-2 focus:ring-blurple ml-[10px] border-l p-[5px] text-sm outline-none focus:rounded focus:border-0 focus:ring ${
-						idx === active
-							? 'bg-blurple text-white'
-							: 'dark:hover:bg-dark-200 dark:active:bg-dark-100 hover:bg-light-700 active:bg-light-800'
-					}`}
-					href={`#${heading.slug}`}
-					key={heading.slug}
-					style={{ paddingLeft: `${heading.depth * 14}px` }}
-					title={heading.text}
-				>
-					<span className="line-clamp-1">{heading.text}</span>
-				</a>
-			)),
-		[headings, active],
-	);
-
-	// useEffect(() => {
-	// 	const idx = headings.findIndex((heading) => heading.slug === state.hash?.slice(1));
-	// 	if (idx >= 0) {
-	// 		setActive(idx);
-	// 	}
-	// }, [state, headings]);
-
-	return (
-		<Scrollbars
-			autoHide
-			hideTracksWhenNotNeeded
-			renderThumbVertical={(props) => <div {...props} className="z-30 rounded bg-light-900 dark:bg-dark-100" />}
-			renderTrackVertical={(props) => (
-				<div {...props} className="absolute bottom-0.5 right-0.5 top-0.5 z-30 w-1.5 rounded" />
-			)}
-			universal
-		>
-			<div className="flex flex-col break-all p-3 pb-8">
-				<div className="ml-2 mt-4 flex flex-row gap-2">
-					{/* <VscListSelection size={25} /> */}
-					<span className="font-semibold">Contents</span>
-				</div>
-				<div className="ml-2 mt-4 flex flex-col gap-2">
-					<div className="relative flex flex-col">
-						<div
-							className="absolute h-[10px] w-[10px] border-2 border-black rounded-full bg-blurple dark:border-white"
-							style={{
-								left: INDICATOR_SIZE / 2 + 0.5,
-								transform: `translateY(${active * LINK_HEIGHT + INDICATOR_OFFSET}px)`,
-							}}
-						/>
-						{headingItems}
-					</div>
-				</div>
-			</div>
-		</Scrollbars>
-	);
-}

apps/guide/src/components/PageButton.tsx

@@ -1,21 +0,0 @@
-export function PageButton({
-	url,
-	title,
-	direction,
-}: {
-	readonly direction: 'next' | 'prev';
-	readonly title: string;
-	readonly url: string;
-}) {
-	return (
-		<a
-			className="flex flex-row flex-col transform-gpu cursor-pointer select-none appearance-none place-items-center gap-2 rounded bg-light-600 px-4 py-3 leading-none no-underline outline-none active:translate-y-px active:bg-light-800 dark:bg-dark-600 hover:bg-light-700 focus:ring focus:ring-width-2 focus:ring-blurple dark:active:bg-dark-400 dark:hover:bg-dark-500"
-			href={url}
-		>
-			<h3 className="text-md font-semibold">{title}</h3>
-			<p className={`${direction === 'next' ? 'ml-auto' : 'mr-auto'} text-sm text-gray-600 dark:text-gray-400`}>
-				{direction === 'next' ? 'Next Page' : 'Previous Page'}
-			</p>
-		</a>
-	);
-}

apps/guide/src/components/ResultingCode.tsx

@@ -1,3 +0,0 @@
-export function ResultingCode() {
-	return null;
-}

apps/guide/src/components/Section.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import { Section as DJSSection, type SectionOptions } from '@discordjs/ui';
-import type { PropsWithChildren } from 'react';
-
-export function Section(options: PropsWithChildren<SectionOptions>) {
-	return <DJSSection {...options} />;
-}

apps/guide/src/components/Sidebar.tsx

@@ -1,63 +0,0 @@
-'use client';
-
-import type { Route } from 'next';
-import Link from 'next/link';
-import { usePathname } from 'next/navigation';
-import { allContents } from 'contentlayer/generated';
-import { useNav } from '~/contexts/nav';
-import { Section } from './Section';
-
-const items = allContents.map((content) => ({
-	title: content.title,
-	category: content.category,
-	slug: content.slug,
-	href: content.url,
-}));
-
-function transformItemsByCategory(allContents: typeof items) {
-	return allContents.reduce<Record<string, typeof items>>((accumulator: any, content) => {
-		if (!accumulator[content.category]) {
-			accumulator[content.category] = [];
-		}
-
-		accumulator[content.category].push(content);
-		return accumulator;
-	}, {});
-}
-
-const itemsByCategory = transformItemsByCategory(items);
-
-export function Sidebar() {
-	const pathname = usePathname();
-	const { setOpened } = useNav();
-
-	return (
-		<div className="flex flex-col gap-4">
-			{Object.keys(itemsByCategory).map((category, idx) => (
-				<Section
-					buttonClassName="bg-light-600 hover:bg-light-700 active:bg-light-800 dark:bg-dark-400 dark:hover:bg-dark-300 dark:active:bg-dark-400 focus:ring-width-2 focus:ring-blurple rounded p-3 outline-none focus:ring z-10"
-					key={`${category}-${idx}`}
-					title={category}
-				>
-					{itemsByCategory[category]?.map((member, index) => (
-						<Link
-							className={`dark:border-dark-100 border-light-800 focus:ring-width-2 focus:ring-blurple ml-5 flex flex-col border-l first:mt-1 p-[5px] pl-6 outline-none focus:rounded focus:border-0 focus:ring ${
-								decodeURIComponent(pathname ?? '') === member.href
-									? 'bg-blurple text-white'
-									: 'dark:hover:bg-dark-200 dark:active:bg-dark-100 hover:bg-light-700 active:bg-light-800'
-							}`}
-							href={member.href as Route}
-							key={`${member.title}-${index}`}
-							onClick={() => setOpened(false)}
-							title={member.title}
-						>
-							<div className="flex flex-row place-items-center gap-2 lg:text-sm">
-								<span className="truncate">{member.title}</span>
-							</div>
-						</Link>
-					))}
-				</Section>
-			))}
-		</div>
-	);
-}

apps/guide/src/components/ThemeSwitcher.tsx

@@ -1,20 +0,0 @@
-'use client';
-
-import { VscColorMode } from '@react-icons/all-files/vsc/VscColorMode';
-import { Button } from 'ariakit/button';
-import { useTheme } from 'next-themes';
-
-export default function ThemeSwitcher() {
-	const { resolvedTheme, setTheme } = useTheme();
-	const toggleTheme = () => setTheme(resolvedTheme === 'light' ? 'dark' : 'light');
-
-	return (
-		<Button
-			aria-label="Toggle theme"
-			className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded rounded-full bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-			onClick={() => toggleTheme()}
-		>
-			<VscColorMode size={24} />
-		</Button>
-	);
-}

apps/guide/src/content/01-home/01-introduction.mdx

@@ -1,32 +0,0 @@
----
-title: Introduction
-category: Home
----
-
-# Introduction
-
-If you're reading this, it probably means you want to learn how to make a bot with discord.js. Awesome! You've come to the right place.
-This guide will teach you things such as:
-
-- How to get a bot [up and running](../getting-started/starting-out) from scratch;
-- In-depth explanations regarding features and concepts of the API (e.g. [intents](../topics/intents), [threads](../topics/threads), [webhooks](../topics/webhooks));
-- And much more.
-
-This guide will also cover subjects like common errors and how to solve them, keeping your code clean, setting up a proper development environment, etc.
-Sounds good? Great! Let's get started.
-
-## Before you begin...
-
-Alright, making a bot is cool and all, but there are some prerequisites to it. To create a bot with discord.js, you should have a fairly decent grasp of JavaScript itself.
-While you _can_ make a bot with very little JavaScript and programming knowledge, trying to do so without understanding the language first will only hinder you. You may get stuck on many uncomplicated issues, struggle with solutions to incredibly easy problems, and all-in-all end up frustrated. Sounds pretty annoying.
-
-If you don't know JavaScript but would like to learn about it, here are a few links to help get you started:
-
-- [Eloquent JavaScript, a free online book](http://eloquentjavascript.net)
-- [JavaScript.info, a modern javascript tutorial](https://javascript.info)
-- [Codecademy's interactive JavaScript course](https://codecademy.com/learn/introduction-to-javascript)
-- [Nodeschool, for both JavaScript and Node.js lessons](https://nodeschool.io)
-- [MDN's JavaScript guide and full documentation](https://developer.mozilla.org/docs/Web/JavaScript)
-- [Google, your best friend](https://google.com)
-
-Take your pick, learn some JavaScript, and once you feel like you're confident enough to make a bot, come back and get started!

apps/guide/src/content/01-home/02-whats-new.mdx

@@ -1,49 +0,0 @@
----
-title: What's new
-category: Home
----
-
-# What's new
-
-<DiscordMessages rounded>
-	<DiscordMessage
-		interaction={{
-			author: {
-				avatar: '/assets/old-guide.png',
-				username: 'discord.js',
-			},
-			command: '/upgrade',
-		}}
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			username: 'Guide Bot',
-			time: 'Today at 21:00',
-		}}
-	>
-		This website is new! We will no longer be updating the old guide website.
-	</DiscordMessage>
-</DiscordMessages>
-
-## Site
-
-We have moved from VuePress to [Next.js](https://nextjs.org/)! The source can be found [here](https://github.com/discordjs/discord.js/tree/main/apps/guide).
-
-## Pages
-
-- Pages have been revamped to account for our new [create-discord-bot](https://github.com/discordjs/discord.js/tree/main/packages/create-discord-bot) command-line interface.
-- Popular topic are now simply "topics" that detail usage of a particular concept of the API.
-- Focus is primarily on discord.js, so irrelevant topics have been removed. It may be better to visit the documentation of the package you are using to learn how to use them.
-
-<DiscordMessages rounded>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			username: 'Guide Bot',
-			time: 'Today at 21:00',
-		}}
-	>
-		Thank you to all of those that contributed to the development of discord.js and the guide!
-	</DiscordMessage>
-</DiscordMessages>

apps/guide/src/content/01-home/03-how-to-contribute.mdx

@@ -1,198 +0,0 @@
----
-title: How to contribute
-category: Home
----
-
-# How to contribute
-
-Since this guide is made specifically for the discord.js community, we want to be sure to provide the most relevant and up-to-date content. We will, of course, make additions to the current pages and add new ones as we see fit, but fulfilling requests is how we know we're providing content you all want the most.
-
-Requests may be as simple as "add an example to the [frequently asked questions](../topics/frequently-asked-questions) page", or as elaborate as "add a page regarding [sharding](../topics/sharding)". We'll do our best to fulfill all requests, as long as they're reasonable.
-
-To make a request, simply head over to [the repository's issue tracker](https://github.com/discordjs/discord.js/issues) and [create a new issue](https://github.com/discordjs/discord.js/issues/new)! Title it appropriately, and let us know exactly what you mean inside the issue description. Make sure that you've looked around the site before making a request; what you want to request might already exist!
-
-<Alert title="Tip" type="info">
-	Remember that you can always [fork the repository](https://github.com/discordjs/discord.js/fork) and [make a pull
-	request](https://github.com/discordjs/discord.js/pulls) if you want to add anything to the guide yourself!
-</Alert>
-
-We'll also get into some of the more advanced features this guide uses below. We recommended you have a look at the [source](https://github.com/discordjs/discord.js/blob/main/apps/guide/src/content/01-home/03-how-to-contribute.mdx) of this page to see exactly how they work.
-
-## Components
-
-Throughout the guide, you'll see some components from the _`@discordjs/ui`_ package:
-
-- _`Alert`_
-- _`Section`_
-- _`DiscordMessages`_, _`DiscordMessage`_, and _`DiscordMessageEmbed`_
-
-Check the source of this page to see them in action!
-
-### Alert
-
-This component may take a _`title`_ and a _`type`_ of _`'danger' | 'info' | 'success' | 'warning'`_.
-
-This uses _`title="Alert" type="info"`_:
-
-<Alert title="Alert" type="info">
-	Use these appropriately!
-</Alert>
-
-### Section
-
-<Section title="Expand me!" padding defaultClosed background gutter>
-Well, hello there!
-
-Whenever some text does not need to be in the main body, you can put it here.
-
-- _`title`_: The title that'll appear.
-- _`padding`_: Adds padding.
-  - _`dense`_: When _`padding`_ is specified, _`dense`_ could make it appear, well, dense.
-- _`defaultClosed`_ Whether the section is closed by default. This one was.
-- _`background`_ Adds background to the content.
-- _`gutter`_: This adds a very small appealing space between the expansion of the section and its content.
-
-</Section>
-
-### DiscordMessages, DiscordMessage, and DiscordMessageEmbed
-
-<DiscordMessages>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			time: 'Today at 21:00',
-			username: 'Guide Bot',
-		}}
-	>
-		A _`DiscordMessage`_ must be within _`DiscordMessages`_.
-	</DiscordMessage>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			time: 'Today at 21:01',
-			username: 'Guide Bot',
-		}}
-		reply={{
-			author: {
-				avatar: '/assets/discordjs.png',
-				bot: true,
-				username: 'Guide Bot',
-			},
-			content: 'A _`DiscordMessage`_ must be within _`DiscordMessages`_.',
-		}}
-		time="21:02"
-	>
-		It's much better to see the source code of this page to replicate and learn!
-	</DiscordMessage>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			time: 'Today at 21:02',
-			username: 'Guide Bot',
-		}}
-	>
-		This message depicts the use of embeds.
-		<>
-			<DiscordMessageEmbed
-				author={{
-					avatar: '/assets/discordjs.png',
-					username: 'Guide Bot',
-				}}
-				footer={{ content: 'Sometimes, titles just have to be.' }}
-				title={{ title: 'An amazing title' }}
-			>
-				This is a description. You can put a description here. It must be descriptive!
-			</DiscordMessageEmbed>
-			<DiscordMessageEmbed
-				author={{
-					avatar: '/assets/discordjs.png',
-					username: 'Guide Bot',
-				}}
-				footer={{ content: "When one amazing title just wasn't enough." }}
-				title={{ title: 'Another amazing title' }}
-			>
-				Multiple embeds!
-			</DiscordMessageEmbed>
-		</>
-	</DiscordMessage>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			time: 'Today at 21:03',
-			username: 'Guide Bot',
-		}}
-		interaction={{
-			author: {
-				avatar: '/assets/discordjs.png',
-				bot: true,
-				username: 'Guide Bot',
-			},
-			command: '/interaction',
-		}}
-	>
-		Interactions are supported! I definitely used a command.
-	</DiscordMessage>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			color: 'text-red-500',
-			time: 'Today at 21:04',
-			username: 'Guide Bot',
-		}}
-		reply={{
-			author: {
-				avatar: '/assets/snek-bot.jpeg',
-				bot: true,
-				verified: true,
-				color: 'text-blue-500',
-				username: 'Snek Bot',
-			},
-			content: 'You can also have verified bots, like me!',
-		}}
-	>
-		Display colors are supported as well!
-	</DiscordMessage>
-</DiscordMessages>
-
-## Code blocks
-
-We use [Code Hike](https://codehike.org). Here are some example code blocks, which should be easy to grasp and learn upon reading the source code of this page:
-
-<CH.Code>
-
-```ts
-const HELLO = 'hello' as const;
-console.log(HELLO);
-// "ts" is the language of the code block.
-```
-
-</CH.Code>
-
-<CH.Code>
-
-```ts fileName
-const FILE_NAME = 'fileName' as const;
-if (FILE_NAME.includes(' ')) throw new Error('Spaces cannot be used in file names.');
-```
-
-```ts anotherFileName
-const FILE_NAME_2 = 'anotherFileName' as const;
-// Putting code blocks together makes them appear in tabs, just like in your editor.
-```
-
----
-
-```ts requiredName
-const FILE_NAME_3 = 'requiredName' as const;
-if (!FILE_NAME) throw new Error('There must be a file name to use panels!');
-// The --- divider was used to create a panel.
-```
-
-</CH.Code>
-
-For more information, be sure to check out the [documentation](https://codehike.org/docs/ch-code).

apps/guide/src/content/02-getting-started/01-starting-out.mdx

@@ -1,64 +0,0 @@
----
-title: Starting out
-category: Getting started
----
-
-# Starting out
-
-Our [create-discord-bot](https://github.com/discordjs/discord.js/tree/main/packages/create-discord-bot) command-line interface sets up a basic Discord bot to help you get started on your journey.
-
-## Creating your bot
-
-To use discord.js, you'll need to install [Node.js](https://nodejs.org), [Deno](https://deno.com), or [Bun](https://bun.sh). discord.js v14 requires Node.js v16.11.0 or higher, but the long-term support (LTS) version is always recommended. For the purposes of this guide, we will be using Node.js.
-
-<Alert title="Tip" type="info">
-	To check if you already have Node.js installed, run _`node --version`_ in your terminal. If it outputs _`v16.11.0`_ or
-	higher, then you're good to go!
-</Alert>
-
-### Windows
-
-- Download from the [Node.js website](https://nodejs.org).
-- Use [fnm](https://github.com/Schniz/fnm).
-- Use [Volta](https://volta.sh).
-
-### macOS
-
-- Download from the [Node.js website](https://nodejs.org/).
-- Use [fnm](https://github.com/Schniz/fnm).
-- Use [Homebrew](https://formulae.brew.sh/formula/node).
-- Use [nvm](https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating).
-- Use [Volta](https://volta.sh).
-
-### Linux
-
-- Visit [this page](https://nodejs.org/en/download/package-manager) to determine how you should install Node.js.
-- Use [fnm](https://github.com/Schniz/fnm).
-- Use [nvm](https://github.com/nvm-sh/nvm).
-- Use [Volta](https://volta.sh).
-
-After installing Node.js, you'll be able to create a new application from your desired package manager. If you're starting out fresh, installing Node.js will also install npm, a package manager for Node.js.
-
-<CH.Code lineNumbers={false} showCopyButton={true}>
-
-```sh npm
-npm create discord-bot
-```
-
-```sh yarn
-yarn create discord-bot
-```
-
-```sh pnpm
-pnpm create discord-bot
-```
-
-```sh bun
-bun create discord-bot
-```
-
-</CH.Code>
-
-You'll be asked the directory to create the application in, as well as whether TypeScript should be used. Dependencies will automatically be installed for you. After this, you've just got your startup Discord bot template _nearly_ ready!
-
-In the next section, we will explain how to create an application to interact with Discord's API.

apps/guide/src/content/02-getting-started/02-setting-up-an-application.mdx

@@ -1,64 +0,0 @@
----
-title: Setting up an application
-category: Getting started
----
-
-# Setting up an application
-
-You'll need to create an application on Discord's developer portal so your bot has a token to interact with Discord's API.
-
-## Creating the application
-
-Follow these steps:
-
-1. Open the [Discord developer portal](https://discord.com/developers/applications). You'll need to be logged in.
-2. Click on the "New Application" button.
-3. Enter a name and confirm the pop-up window by clicking the "Create" button.
-   - You'll need to agree to the [Developer Terms of Service](https://discord.com/developers/docs/policies-and-agreements/terms-of-service) and [Developer Policy](https://discord.com/developers/docs/policies-and-agreements/developer-policy).
-
-You should see a page like this:
-
-![Successfully created application](/assets/create-app.png)
-
-You can edit your application's name, description, and avatar here. Copy the application id and paste it in the .env file after _`APPLICATION_ID=`_.
-
-Once you've saved your changes, move on by selecting the "Bot" tab in the left pane.
-
-## Your bot's token
-
-<Alert title="Important" type="danger">
-	This section is critical, so pay close attention. It explains what your bot token is, as well as the security aspects
-	of it.
-</Alert>
-
-On the bot tab, you'll see a section like this:
-
-![Bot application](/assets/bot-user.png)
-
-In this panel, you can give your bot a snazzy avatar, set its username, and make it public or private. Your bot's token will be revealed when you press the "Reset Token" button and confirm. Once you've done this, copy it and paste it in the .env file after _`DISCORD_TOKEN=`_.
-
-If you happen to lose this token at some point, you will need to come back to this page and reset it, which will reveal the new token, invalidating all old ones.
-
-### Bot token explanation
-
-A token is essentially your bot's password; it's what your bot uses to login to Discord. With that said, **it is vital that you do not ever share this token with anybody, purposely or accidentally**. If someone does manage to get a hold of your bot's token, they can use your bot as if it were theirs—this means they can perform malicious acts with it.
-
-Tokens look like this: _`NzkyNzE1NDU0MTk2MDg4ODQy.X-hvzA.Ovy4MCQywSkoMRRclStW4xAYK7I`_ (don't worry, we immediately reset this token before even posting it here!). If it's any shorter and looks more like this: _`kxbsDRU5UfAaiO7ar9GFMHSlmTwYaIYn`_, you copied your client secret instead. Make sure to copy the token if you want your bot to work!
-
-### Token leak scenario
-
-Let's imagine that you have a bot on over 1,000 servers, and it took you many, many months of coding and patience to get it on that amount. Your bot's token gets leaked somewhere, and now someone else has it. That person can:
-
-- Spam every server your bot is on;
-- DM spam as many users as possible;
-- Delete as many channels as possible;
-- Kick or ban as many server members as possible;
-- Make your bot leave all of the servers it has joined;
-
-All that and much, much more. Sounds pretty terrible, right? So make sure to keep your bot's token as safe as possible!
-
-<Alert title="Compromised tokens" type="danger">
-	If your bot token has been compromised by committing it to a public repository, posting it in discord.js support etc.
-	or otherwise see your bot's token in danger, return to this page and press "Reset Token". This will invalidate all old
-	tokens belonging to your bot. Keep in mind that you will need to update your bot's token where you used it before.
-</Alert>

apps/guide/src/content/02-getting-started/03-adding-your-bot-to-a-server.mdx

@@ -1,48 +0,0 @@
----
-title: Adding your bot to a server
-category: Getting started
----
-
-# Adding your bot to a server
-
-After you [set up an application](./setting-up-an-application), you'll notice it's not in any servers yet. So, how does that work?
-
-Before you're able to see your bot in a server, you will need to add it by using an invite link.
-
-## Bot invite links
-
-The basic version of one such link looks like this:
-
-<CH.Code lineNumbers={false}>
-
-```
-https://discord.com/api/oauth2/authorize?client_id=123456789012345678&permissions=0&scope=bot
-```
-
-</CH.Code>
-
-The structure of the URL is quite simple:
-
-- _`https://discord.com/api/oauth2/authorize`_ is Discord's standard structure for authorizing an OAuth2 application (such as your bot application) for entry to a Discord server.
-- _`client_id=...`_ is to specify _which_ application you want to authorize. You'll need to replace this part with your client's id to create a valid invite link.
-- _`permissions=...`_ describes the permissions that your bot will request to be granted by default upon joining the server you are adding it to.
-- _`scope=bot`_ specifies that you want to add this application as a Discord bot with the ability to create slash commands.
-
-<Alert title="Warning" type="warning">
-	If you get an error message saying "Bot requires a code grant", head over to your application's settings and disable
-	the "Requires OAuth2 Code Grant" option. You shouldn't enable this option unless you know why you need to.
-</Alert>
-
-## Creating and using your invite link
-
-To create an invite link, head back to the [developer portal](https://discord.com/developers/applications), click on your bot application, and open the OAuth2 page.
-
-In the sidebar, you'll find the URL generator. Select the _`bot`_ option. Once you select the _`bot`_ option, a list of permissions will appear, allowing you to configure the permissions your bot needs.
-
-Grab the link via the "Copy" button and send it in a channel in Discord. Click on the link you just sent which should reveal this:
-
-![Bot Authorization page](/assets/bot-auth-page.png)
-
-Choose the server you want to add the bot to and click "Authorize". Congratulations! You've successfully added your bot to your Discord server.
-
-At this point, you should have a Discord bot you created with [create-discord-bot](https://github.com/discordjs/discord.js/tree/main/packages/create-discord-bot) with your .env file populated and your Discord bot in a server. You are now ready to do what you like.

apps/guide/src/content/03-topics/01-frequently-asked-questions.mdx

@@ -1,496 +0,0 @@
----
-title: Frequently asked questions
-category: Topics
----
-
-# Frequently asked questions
-
-## Legend
-
-- _`client`_ is a placeholder for the <DocsLink type="class" parent="Client" /> object:  
-  _`const client = new Client({ intents: [GatewayIntentBits.Guilds] });`_.
-
-- _`interaction`_ is a placeholder for the <DocsLink type="class" parent="BaseInteraction" />:  
-  _`client.on(Events.InteractionCreate, interaction => { ... });`_.
-
-- _`guild`_ is a placeholder for the <DocsLink type="class" parent="Guild" /> object:  
-  _`interaction.guild`_ or _`client.guilds.cache.get('id')`_
-
-- _`voiceChannel`_ is a placeholder for the <DocsLink type="class" parent="VoiceChannel" />:  
-  _`interaction.member.voice.channel`_.
-
-For a more detailed explanation of the notations commonly used in this guide, the docs, and the support server, see [here](/additional-info/notation.md).
-
-## Administrative
-
-### How do I ban a user?
-
-<CH.Code>
-
-```js
-const user = interaction.options.getUser('target');
-await guild.members.ban(user);
-```
-
-</CH.Code>
-
-### How do I unban a user?
-
-<CH.Code>
-
-```js
-const user = interaction.options.getUser('target');
-await guild.members.unban(user);
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	Discord validates and resolves user ids for users not on the server in user slash command options. To retrieve and use
-	the full structure from the resulting interaction, you can use the{' '}
-	<DocsLink type="class" parent="CommandInteractionOptionResolver" symbol="getUser" brackets /> method.
-</Alert>
-
-### How do I kick a guild member?
-
-<CH.Code>
-
-```js
-const member = interaction.options.getMember('target');
-await member.kick();
-```
-
-</CH.Code>
-
-### How do I timeout a guild member?
-
-<CH.Code>
-
-```js
-const member = interaction.options.getMember('target');
-await member.timeout(60_000); // Timeout for one minute
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	Timeout durations are measured by the millisecond. The maximum timeout duration you can set is 28 days. To remove a
-	timeout set on a member, pass _`null`_ instead of a timeout duration.
-</Alert>
-
-### How do I add a role to a guild member?
-
-<CH.Code>
-
-```js
-const role = interaction.options.getRole('role');
-const member = interaction.options.getMember('target');
-await member.roles.add(role);
-```
-
-</CH.Code>
-
-### How do I check if a guild member has a specific role?
-
-<CH.Code>
-
-```js
-const role = interaction.options.getRole('role');
-const member = interaction.options.getMember('target');
-
-if (member.roles.cache.has(role.id) {
-	// ...
-}
-```
-
-</CH.Code>
-
-### How do I limit a command to a single user?
-
-<CH.Code>
-
-```js
-if (interaction.user.id === 'id') {
-	// ...
-}
-```
-
-</CH.Code>
-
-## Bot Configuration and Utility
-
-### How do I set my bot's username?
-
-<CH.Code>
-
-```js
-await client.user.setUsername('username');
-```
-
-</CH.Code>
-
-### How do I set my bot's avatar?
-
-<CH.Code>
-
-```js
-await client.user.setAvatar('URL or path');
-```
-
-</CH.Code>
-
-### How do I set my playing status?
-
-<CH.Code>
-
-```js
-client.user.setActivity('activity');
-```
-
-</CH.Code>
-
-### How do I set my status to "Watching/Listening to/Competing in ..."?
-
-<CH.Code>
-
-```js
-import { ActivityType } from 'discord.js';
-
-client.user.setActivity('activity', { type: ActivityType.Watching });
-client.user.setActivity('activity', { type: ActivityType.Listening });
-client.user.setActivity('activity', { type: ActivityType.Competing });
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you would like to set your activity upon startup, you can use the{' '}
-	<DocsLink type="typedef" parent="ClientOptions" /> object to set the appropriate
-	<DocsLink type="typedef" parent="PresenceData" />.
-</Alert>
-
-### How do I make my bot display online/idle/dnd/invisible?
-
-<CH.Code>
-
-```js
-client.user.setStatus('online');
-client.user.setStatus('idle');
-client.user.setStatus('dnd');
-client.user.setStatus('invisible');
-```
-
-</CH.Code>
-
-### How do I set both status and activity in one go?
-
-<CH.Code>
-
-```js
-client.user.setPresence({ activities: [{ name: 'activity' }], status: 'idle' });
-```
-
-</CH.Code>
-
-## Miscellaneous
-
-### How do I send a message to a specific channel?
-
-<CH.Code>
-
-```js
-const channel = client.channels.cache.get('id');
-await channel.send('content');
-```
-
-</CH.Code>
-
-### How do I create a post in a forum channel?
-
-<Alert title="Tip" type="info">
-	Currently, the only way to get tag ids is programmatically through{' '}
-	<DocsLink type="class" parent="ForumChannel" symbol="availableTags" />.
-</Alert>
-
-<CH.Code>
-
-```js
-const channel = client.channels.cache.get('id');
-
-await channel.threads.create({
-	name: 'Post name',
-	message: { content: 'Message content' },
-	appliedTags: ['tagId', 'anotherTagId'],
-});
-```
-
-</CH.Code>
-
-### How do I DM a specific user?
-
-<CH.Code>
-
-```js
-await client.users.send('id', 'content');
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you want to send a direct message to the user who sent the interaction, you can use _`interaction.user.send()`_.
-</Alert>
-
-### How do I mention a specific user in a message?
-
-<CH.Code>
-
-```js
-const user = interaction.options.getUser('target');
-await interaction.reply(`Hi, ${user}.`);
-await interaction.followUp(`Hi, <@${user.id}>.`);
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	Mentions in embeds may resolve correctly in embed titles, descriptions and field values but will never notify the
-	user. Other areas do not support mentions at all.
-</Alert>
-
-### How do I control which users and/or roles are mentioned in a message?
-
-Controlling which mentions will send a ping is done via the _`allowedMentions`_ option, which replaces _`disableMentions`_.
-
-This can be set as a default in <DocsLink type="typedef" parent="ClientOptions" />, and controlled per-message sent by your bot.
-
-<CH.Code>
-
-```js
-new Client({ allowedMentions: { parse: ['users', 'roles'] } });
-```
-
-</CH.Code>
-
-Even more control can be achieved by listing specific _`users`_ or _`roles`_ to be mentioned by id, e.g.:
-
-<CH.Code>
-
-```js
-await channel.send({
-	content: '<@123456789012345678> <@987654321098765432> <@&102938475665748392>',
-	allowedMentions: { users: ['123456789012345678'], roles: ['102938475665748392'] },
-});
-```
-
-</CH.Code>
-
-### How do I prompt the user for additional input?
-
-<CH.Code>
-
-```js
-await interaction.reply('Please enter more input.');
-const filter = (m) => interaction.user.id === m.author.id;
-
-try {
-	const messages = await interaction.channel.awaitMessages({ filter, time: 60000, max: 1, errors: ['time'] });
-	await interaction.followUp(`You've entered: ${messages.first().content}`);
-} catch {
-	await interaction.followUp('You did not enter any input!');
-}
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you want to learn more about this syntax or other types of collectors, check out [this dedicated guide page for
-	collectors](/popular-topics/collectors.md)!
-</Alert>
-
-### How do I block a user from using my bot?
-
-<CH.Code>
-
-```js
-const blockedUsers = ['id1', 'id2'];
-
-client.on(Events.InteractionCreate, (interaction) => {
-	if (blockedUsers.includes(interaction.user.id)) return;
-});
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	You do not need to have a constant local variable like _`blockedUsers`_ above. If you have a database system that you
-	use to store ids of blocked users, you can query the database instead.
-</Alert>
-
-<CH.Code>
-
-```js
-client.on(Events.InteractionCreate, async (interaction) => {
-	const blockedUsers = await database.query('SELECT user_id FROM blocked_users;');
-	if (blockedUsers.includes(interaction.user.id)) return;
-});
-```
-
-</CH.Code>
-
-Note that this is just a showcase of how you could do such a check.
-
-### How do I react to the message my bot sent?
-
-<CH.Code>
-
-```js
-const sentMessage = await interaction.channel.send('My message to react to.');
-// Unicode emoji
-await sentMessage.react('👍');
-
-// Custom emoji
-await sentMessage.react('123456789012345678');
-await sentMessage.react('<emoji:123456789012345678>');
-await sentMessage.react('<a:emoji:123456789012345678>');
-await sentMessage.react('emoji:123456789012345678');
-await sentMessage.react('a:emoji:123456789012345678');
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you want to learn more about reactions, check out [this dedicated guide on
-	reactions](/popular-topics/reactions.md)!
-</Alert>
-
-### How do I restart my bot with a command?
-
-<CH.Code>
-
-```js
-process.exit();
-```
-
-</CH.Code>
-
-<Alert title="Warning" type="warning">
-	_`process.exit()`_ will only kill your Node process, but when using [PM2](https://pm2.keymetrics.io/), it will restart
-	the process whenever it gets killed. You can read our guide on PM2 [here](/improving-dev-environment/pm2.md).
-</Alert>
-
-### What is the difference between a User and a GuildMember?
-
-A User represents a global Discord user, and a GuildMember represents a Discord user on a specific server. That means only GuildMembers can have permissions, roles, and nicknames, for example, because all of these things are server-bound information that could be different on each server that the user is in.
-
-### How do I find all online members of a guild?
-
-<CH.Code>
-
-```js
-// First use guild.members.fetch to make sure all members are cached
-const fetchedMembers = await guild.members.fetch({ withPresences: true });
-const totalOnline = fetchedMembers.filter((member) => member.presence?.status === 'online');
-// Now you have a collection with all online member objects in the totalOnline variable
-console.log(`There are currently ${totalOnline.size} members online in this guild!`);
-```
-
-</CH.Code>
-
-<Alert title="Warning" type="warning">
-	This only works correctly if you have the _`GuildPresences`_ intent enabled for your application and client. If you
-	want to learn more about intents, check out [this dedicated guide on intents](/popular-topics/intents.md)!
-</Alert>
-
-### How do I check which role was added/removed and for which member?
-
-<CH.Code>
-
-```js
-// Start by declaring a guildMemberUpdate listener
-// This code should be placed outside of any other listener callbacks to prevent listener nesting
-client.on(Events.GuildMemberUpdate, (oldMember, newMember) => {
-	// If the role(s) are present on the old member object but no longer on the new one (i.e role(s) were removed)
-	const removedRoles = oldMember.roles.cache.filter((role) => !newMember.roles.cache.has(role.id));
-
-	if (removedRoles.size > 0) {
-		console.log(`The roles ${removedRoles.map((r) => r.name)} were removed from ${oldMember.displayName}.`);
-	}
-
-	// If the role(s) are present on the new member object but are not on the old one (i.e role(s) were added)
-	const addedRoles = newMember.roles.cache.filter((role) => !oldMember.roles.cache.has(role.id));
-
-	if (addedRoles.size > 0) {
-		console.log(`The roles ${addedRoles.map((r) => r.name)} were added to ${oldMember.displayName}.`);
-	}
-});
-```
-
-</CH.Code>
-
-### How do I check the bot's ping?
-
-There are two common measurements for bot pings. The first, **websocket heartbeat**, is the average interval of a regularly sent signal indicating the healthy operation of the websocket connection the library receives events over:
-
-<CH.Code>
-
-```js
-await interaction.reply(`Websocket heartbeat: ${client.ws.ping}ms.`);
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you're using [sharding](/sharding/), a specific shard's heartbeat can be found on the WebSocketShard instance,
-	accessible at _`client.ws.shards.get(id).ping`_.
-</Alert>
-
-The second, **Roundtrip Latency**, describes the amount of time a full API roundtrip (from the creation of the command message to the creation of the response message) takes. You then edit the response to the respective value to avoid needing to send yet another message:
-
-<CH.Code>
-
-```js
-const sent = await interaction.reply({ content: 'Pinging...', fetchReply: true });
-await interaction.editReply(`Roundtrip latency: ${sent.createdTimestamp - interaction.createdTimestamp}ms`);
-```
-
-</CH.Code>
-
-### Why do some emojis behave weirdly?
-
-If you've tried using [the usual method of retrieving unicode emojis](./reactions.md#unicode-emojis), you may have noticed that some characters don't provide the expected results. Here's a short snippet that'll help with that issue. You can toss this into a file of its own and use it anywhere you need! Alternatively feel free to simply copy-paste the characters from below:
-
-<CH.Code>
-
-```js index.js
-import { emojiCharacters } from './emojiCharacters.js';
-
-console.log(emojiCharacters.a); // 🇦
-console.log(emojiCharacters[10]); // 🔟
-console.log(emojiCharacters['!']); // ❗
-```
-
-{/* prettier-ignore */}
-```js emojiCharacters.js
-export const emojiCharacters = {
-	a: '🇦', b: '🇧', c: '🇨', d: '🇩',
-	e: '🇪', f: '🇫', g: '🇬', h: '🇭',
-	i: '🇮', j: '🇯', k: '🇰', l: '🇱',
-	m: '🇲', n: '🇳', o: '🇴', p: '🇵',
-	q: '🇶', r: '🇷', s: '🇸', t: '🇹',
-	u: '🇺', v: '🇻', w: '🇼', x: '🇽',
-	y: '🇾', z: '🇿', 0: '0️⃣', 1: '1️⃣',
-	2: '2️⃣', 3: '3️⃣', 4: '4️⃣', 5: '5️⃣',
-	6: '6️⃣', 7: '7️⃣', 8: '8️⃣', 9: '9️⃣',
-	10: '🔟', '#': '#️⃣', '*': '*️⃣',
-	'!': '❗', '?': '❓',
-};
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-You can use the <kbd>⌃ Control</kbd> <kbd>⌘ Command</kbd> <kbd>Space</kbd> keyboard shortcut to open up an emoji picker that can be used for quick, easy access to all the Unicode emojis available to you.
-
-On Windows, the shortcut is <kbd>⊞</kbd> <kbd>.</kbd>.
-
-</Alert>

apps/guide/src/content/03-topics/02-audit-logs.mdx

@@ -1,165 +0,0 @@
----
-title: Audit logs
-category: Topics
----
-
-# Audit logs
-
-## A Quick Background
-
-Audit logs are an excellent moderation tool offered by Discord to know what happened in a server and usually by whom. Making use of audit logs requires the _`ViewAuditLog`_ permission. Audit logs may be fetched on a server, or they may be received via the gateway event <DocsLink type="class" parent="Client" symbol="e-guildAuditLogEntryCreate"/> which requires the _`GuildModeration`_ intent.
-
-There are quite a few cases where you may use audit logs. This guide will limit itself to the most common use cases. Feel free to consult the [relevant Discord API page](https://discord.com/developers/docs/resources/audit-log) for more information.
-
-Keep in mind that these examples explore a straightforward case and are by no means exhaustive. Their purpose is to teach you how audit logs work, and expansion of these examples is likely needed to suit your specific use case.
-
-## Fetching Audit Logs
-
-Let's start by glancing at the <DocsLink type="class" parent="Guild" symbol="fetchAuditLogs" brackets /> method and how to work with it. Like many discord.js methods, it returns a [Promise](../additional-info/understanding-async-await) containing the <DocsLink type="class" parent="GuildAuditLogs"/> object. This object has one property, _`entries`_, which holds a [Collection](../additional-info/collections) of <DocsLink type="class" parent="GuildAuditLogsEntry"/> objects, and consequently, the information you want to retrieve.
-
-Here is the most basic fetch to look at some entries.
-
-<CH.Code>
-
-```js
-const fetchedLogs = await guild.fetchAuditLogs();
-const firstEntry = fetchedLogs.entries.first();
-```
-
-</CH.Code>
-
-Simple, right? Now, let's look at utilizing its options:
-
-<CH.Code>
-
-```js
-import { AuditLogEvent } from 'discord.js';
-
-const fetchedLogs = await guild.fetchAuditLogs({
-	type: AuditLogEvent.InviteCreate,
-	limit: 1,
-});
-
-const firstEntry = fetchedLogs.entries.first();
-```
-
-</CH.Code>
-
-This will return the first entry where an invite was created. You used _`limit: 1`_ here to specify only one entry.
-
-## Receiving Audit Logs
-
-Audit logs may be received via the gateway event <DocsLink type="class" parent="Client" symbol="e-guildAuditLogEntryCreate"/>.
-This is the best way to receive audit logs if you want to monitor them. As soon as an audit log entry is created,
-your application will receive an instance of this event. A common use case is to find out _who_ did the action that
-caused the audit log event to happen.
-
-### Who deleted a message?
-
-One of the most common use cases for audit logs is understanding who deleted a message in a Discord server. If a user deleted another user's message, you can find out who did that as soon as you receive the corresponding audit log event.
-
-<Alert title="Tip" type="info">
-	Messages deleted by their author or bots (excluding bulk deletes) do not generate audit log entries.
-</Alert>
-
-<CH.Code>
-
-```js JavaScript
-import { AuditLogEvent, Events } from 'discord.js';
-
-client.on(Events.GuildAuditLogEntryCreate, async (auditLog) => {
-	// Define your variables.
-	// The extra information here will be the channel.
-	const { action, extra: channel, executorId, targetId } = auditLog;
-
-	// Check only for deleted messages.
-	if (action !== AuditLogEvent.MessageDelete) return;
-
-	// Ensure the executor is cached.
-	const executor = await client.users.fetch(executorId);
-
-	// Ensure the author whose message was deleted is cached.
-	const target = await client.users.fetch(targetId);
-
-	// Log the output.
-	console.log(`A message by ${target.tag} was deleted by ${executor.tag} in ${channel}.`);
-});
-```
-
-```ts TypeScript
-import { AuditLogEvent, Events } from 'discord.js';
-
-client.on(Events.GuildAuditLogEntryCreate, async (auditLog) => {
-	// Define your variables.
-	// The extra information here will be the channel.
-	const { action, extra: channel, executorId, targetId } = auditLog;
-
-	// Check only for deleted messages.
-	if (action !== AuditLogEvent.MessageDelete) return;
-
-	// Ensure the executor is cached. The id definitely exists.
-	const executor = await client.users.fetch(executorId!);
-
-	// Ensure the author whose message was deleted is cached. The id definitely exists.
-	const target = await client.users.fetch(targetId!);
-
-	// Log the output.
-	console.log(`A message by ${target.tag} was deleted by ${executor.tag} in ${channel}.`);
-});
-```
-
-</CH.Code>
-
-With this, you now have a very simple logger telling you who deleted a message authored by another person.
-
-### Who kicked a user?
-
-This is very similar to the example above.
-
-<CH.Code>
-
-```js JavaScript
-import { AuditLogEvent, Events } from 'discord.js';
-
-client.on(Events.GuildAuditLogEntryCreate, async (auditLog) => {
-	// Define your variables.
-	const { action, executorId, targetId } = auditLog;
-
-	// Check only for kicked users.
-	if (action !== AuditLogEvent.MemberKick) return;
-
-	// Ensure the executor is cached.
-	const executor = await client.users.fetch(executorId);
-
-	// Ensure the kicked guild member is cached.
-	const kickedUser = await client.users.fetch(targetId);
-
-	// Now you can log the output!
-	console.log(`${kickedUser.tag} was kicked by ${executor.tag}.`);
-});
-```
-
-```ts TypeScript
-import { AuditLogEvent, Events } from 'discord.js';
-
-client.on(Events.GuildAuditLogEntryCreate, async (auditLog) => {
-	// Define your variables.
-	const { action, executorId, targetId } = auditLog;
-
-	// Check only for kicked users.
-	if (action !== AuditLogEvent.MemberKick) return;
-
-	// Ensure the executor is cached. The id definitely exists.
-	const executor = await client.users.fetch(executorId!);
-
-	// Ensure the kicked guild member is cached. The id definitely exists.
-	const kickedUser = await client.users.fetch(targetId!);
-
-	// Now you can log the output!
-	console.log(`${kickedUser.tag} was kicked by ${executor.tag}.`);
-});
-```
-
-</CH.Code>
-
-If you want to check who banned a user, it's the same example as above except the _`action`_ should be <DiscordAPITypesLink type="enum" parent="AuditLogEvent" symbol="MemberBanAdd" />. You can check the rest of the possible actions on this page.

apps/guide/src/content/03-topics/03-collectors.mdx

@@ -1,223 +0,0 @@
----
-title: Collectors
-category: Topics
----
-
-# Collectors
-
-## Message collectors
-
-{/* prettier-ignore */}
-<DocsLink type="class" parent="Collector">Collectors</DocsLink> are useful to enable your bot to obtain _additional_ input after the first command was sent. An example would be initiating a quiz, where the bot will "await" a correct response from somebody.
-
-### Basic message collector
-
-Let's take a look at a basic message collector:
-
-<CH.Code>
-
-```js
-const collectorFilter = (message) => message.content.includes('discord');
-const collector = interaction.channel.createMessageCollector({ filter: collectorFilter, time: 15_000 });
-
-collector.on('collect', (message) => {
-	console.log(`Collected ${message.content}`);
-});
-
-collector.on('end', (collected) => {
-	console.log(`Collected ${collected.size} messages`);
-});
-```
-
-</CH.Code>
-
-You can provide a _`filter`_ key to the object parameter of <DocsLink type="class" parent="TextChannel" symbol="createMessageCollector" brackets />. The value to this key should be a function that returns a boolean value to indicate if this message should be collected or not. To check for multiple conditions in your filter you can connect them using [logical operators](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Expressions_and_Operators#logical_operators). If you don't provide a filter all messages in the channel the collector was started on will be collected.
-
-Note that the above example uses [implicit return](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Arrow_functions#function_body) for the filter function and passes it to the options object using the [object property shorthand](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Object_initializer#property_definitions) notation.
-
-If a message passes through the filter, it will trigger the <DocsLink type="class" parent="Collector" symbol="e-collect" /> event for the _`collector`_ you've created. This message is then passed into the event listener as _`collected`_ and the provided function is executed. In the above example, you simply log the message. Once the collector finishes collecting based on the provided end conditions the <DocsLink type="class" parent="Collector" symbol="e-end" /> event emits.
-
-You can control when a collector ends by supplying additional option keys when creating a collector:
-
-- _`time`_: Amount of time in milliseconds the collector should run for
-- _`max`_: Number of messages to successfully pass the filter
-- _`maxProcessed`_: Number of messages encountered (no matter the filter result)
-
-The benefit of using an event-based collector over _`awaitMessages()`_ (its promise-based counterpart) is that you can do something directly after each message is collected, rather than just after the collector ended. You can also stop the collector manually by calling <DocsLink type="class" parent="Collector" symbol="stop" brackets />.
-
-### Await messages
-
-Using <DocsLink type="class" parent="TextChannel" symbol="awaitMessages" brackets /> can be easier if you understand [Promises](../additional-info/understanding-async-await), and it allows you to have cleaner code overall. It is essentially identical to <DocsLink type="class" parent="TextChannel" symbol="createMessageCollector" brackets />, except promisified. However, the drawback of using this method is that you cannot do things before the Promise is resolved or rejected, either by an error or completion. However, it should do for most purposes, such as awaiting the correct response in a quiz. Instead of taking their example, let's set up a basic quiz command using the _`.awaitMessages()`_ feature.
-
-First, you'll need some questions and answers to choose from, so here's a basic set:
-
-<CH.Code>
-
-```json
-[
-	{
-		"question": "What color is the sky?",
-		"answers": ["blue"]
-	},
-	{
-		"question": "How many letters are there in the alphabet?",
-		"answers": ["26", "twenty-six", "twenty six", "twentysix"]
-	}
-]
-```
-
-</CH.Code>
-
-The provided set allows for responder error with an array of answers permitted. Ideally, it would be best to place this in a JSON file, which you can call _`quiz.json`_ for simplicity.
-
-<CH.Code>
-
-```js
-import quiz from './quiz.json' assert { type: 'json' };
-
-// ...
-
-const item = quiz[Math.floor(Math.random() * quiz.length)];
-
-const collectorFilter = (response) => {
-	return item.answers.some((answer) => answer.toLowerCase() === response.content.toLowerCase());
-};
-
-await interaction.reply({ content: item.question });
-
-try {
-	const collected = await interaction.channel.awaitMessages({
-		filter: collectorFilter,
-		max: 1,
-		time: 30_000,
-		errors: ['time'],
-	});
-
-	await interaction.followUp(`${collected.first().author} got the correct answer!`);
-} catch {
-	await interaction.followUp('Looks like nobody got the answer this time.');
-}
-```
-
-</CH.Code>
-
-<Alert title="Tip" type="info">
-	If you don't understand how _`.some()`_ works, you can read about it in more detail
-	[here](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/some).
-</Alert>
-
-In this filter, you iterate through the answers to find what you want. You would like to ignore the case because simple typos can happen, so you convert each answer to its lowercase form and check if it's equal to the response in lowercase form as well. In the options section, you only want to allow one answer to pass through, hence the _`max: 1`_ setting.
-
-The filter looks for messages that match one of the answers in the array of possible answers to pass through the collector. The _`max`_ option (the second parameter) specifies that only a maximum of one message can go through the filter successfully before the Promise successfully resolves. The _`errors`_ section specifies that time will cause it to error out, which will cause the Promise to reject if one correct answer is not received within the time limit of one minute. As you can see, there is no _`collect`_ event, so you are limited in that regard.
-
-## Reaction collectors
-
-### Basic reaction collector
-
-These work quite similarly to message collectors, except that you apply them on a message rather than a channel. This example uses the <DocsLink type="class" parent="Message" symbol="createReactionCollector" brackets /> method. The filter will check for the 👍 emoji–in the default skin tone specifically, so be wary of that. It will also check that the person who reacted shares the same id as the author of the original message that the collector was assigned to.
-
-```js
-const collectorFilter = (reaction, user) => {
-	return reaction.emoji.name === '👍' && user.id === message.author.id;
-};
-
-const collector = message.createReactionCollector({ filter: collectorFilter, time: 15_000 });
-
-collector.on('collect', (reaction, user) => {
-	console.log(`Collected ${reaction.emoji.name} from ${user.tag}`);
-});
-
-collector.on('end', (collected) => {
-	console.log(`Collected ${collected.size} items`);
-});
-```
-
-### Await reactions
-
-<DocsLink type="class" parent="Message" symbol="awaitReactions" brackets /> works almost the same as a reaction collector,
-except it is Promise-based. The same differences apply as with channel collectors.
-
-```js
-const collectorFilter = (reaction, user) => {
-	return reaction.emoji.name === '👍' && user.id === message.author.id;
-};
-
-try {
-	const collected = await message.awaitReactions({ filter: collectorFilter, max: 1, time: 60_000, errors: ['time'] });
-	console.log(collected.size);
-} catch (collected) {
-	console.log(`After a minute, the user did not react.`);
-}
-```
-
-## Interaction collectors
-
-The third type of collector allows you to collect interactions; such as when users activate a slash command or click on a button in a message.
-
-### Basic message component collector
-
-Collecting interactions from message components works similarly to reaction collectors. In the following example, you will check that the interaction came from a button, and that the user clicking the button is the same user that initiated the command.
-
-One important difference to note with interaction collectors is that Discord expects a response to _all_ interactions within 3 seconds - even ones that you don't want to collect. For this reason, you may wish to _`.deferUpdate()`_ all interactions in your filter, or not use a filter at all and handle this behavior in the _`collect`_ event.
-
-```js
-import { ComponentType } from 'discord.js';
-
-const collector = message.createMessageComponentCollector({ componentType: ComponentType.Button, time: 15_000 });
-
-collector.on('collect', (i) => {
-	if (i.user.id === interaction.user.id) {
-		await i.reply(`${i.user.id} clicked on the ${i.customId} button.`);
-	} else {
-		await i.reply({ content: `These buttons aren't for you!`, ephemeral: true });
-	}
-});
-
-collector.on('end', (collected) => {
-	console.log(`Collected ${collected.size} interactions.`);
-});
-```
-
-### Await message component
-
-As before, this works similarly to the message component collector, except it is Promise-based.
-
-Unlike other Promise-based collectors, this method will only ever collect one interaction that passes the filter. If no interactions are collected before the time runs out, the Promise will reject. This behavior aligns with Discord's requirement that actions should immediately receive a response. In this example, you will use _`.deferUpdate()`_ on all interactions in the filter.
-
-```js
-import { ComponentType } from 'discord.js';
-
-const collectorFilter = (i) => {
-	i.deferUpdate();
-	return i.user.id === interaction.user.id;
-};
-
-try {
-	const interaction = await message.awaitMessageComponent({
-		filter: collectorFilter,
-		componentType: ComponentType.StringSelect,
-		time: 60_000,
-	});
-
-	await interaction.editReply(`You selected ${interaction.values.join(', ')}!`);
-} catch (error) {
-	console.log('No interactions were collected.');
-}
-```
-
-### Await modal submit
-
-If you want to wait for the submission of a modal within the context of another command or button execution, you may find the promisified collector <DocsLink type="class" parent="CommandInteraction" symbol="awaitModalSubmit" brackets /> useful.
-
-As Discord does not inform you if the user dismisses the modal, supplying a maximum _`time`_ to wait for is crucial:
-
-```js
-try {
-	const interaction = await initialInteraction.awaitModalSubmit({ time: 60_000, filter });
-	await interaction.editReply('Thank you for your submission!');
-} catch (error) {
-	console.log('No modal submit interaction was collected');
-}
-```
-
-For more information on working with modals, see the [modals section of this guide](../interactions/modals).

apps/guide/src/content/03-topics/04-formatters.mdx

@@ -1,95 +0,0 @@
----
-title: Formatters
-category: Topics
----
-
-# Formatters
-
-discord.js provides the <DocsLink package="formatters" /> package which contains a variety of utilities you can use when writing your Discord bot.
-
-## Basic Markdown
-
-These functions format strings into all the different markdown styles supported by Discord.
-
-<CH.Code>
-
-```js
-import { bold, italic, strikethrough, underscore, spoiler, quote, blockQuote } from 'discord.js';
-
-const string = 'Hello!';
-const boldString = bold(string);
-const italicString = italic(string);
-const strikethroughString = strikethrough(string);
-const underscoreString = underscore(string);
-const spoilerString = spoiler(string);
-const quoteString = quote(string);
-const blockquoteString = blockQuote(string);
-```
-
-</CH.Code>
-
-## Links
-
-There are also two functions to format hyperlinks. _`hyperlink()`_ will format the URL into a masked markdown link, and _`hideLinkEmbed()`_ will wrap the URL in _`<>`_, preventing it from embedding.
-
-<CH.Code>
-
-```js
-import { hyperlink, hideLinkEmbed } from 'discord.js';
-
-const url = 'https://discord.js.org/';
-const link = hyperlink('discord.js', url);
-const hiddenEmbed = hideLinkEmbed(url);
-```
-
-</CH.Code>
-
-## Code blocks
-
-You can use _`inlineCode()`_ and _`codeBlock()`_ to turn a string into an inline code block or a regular code block with or without syntax highlighting.
-
-<CH.Code>
-
-```js
-import { inlineCode, codeBlock } from 'discord.js';
-
-const jsString = 'const value = true;';
-const inline = inlineCode(jsString);
-const codeblock = codeBlock(jsString);
-const highlighted = codeBlock('js', jsString);
-```
-
-</CH.Code>
-
-## Timestamps
-
-With _`time()`_, you can format Unix timestamps and dates into a Discord time string.
-
-<CH.Code>
-
-```js
-import { time, TimestampStyles } from 'discord.js';
-
-const date = new Date();
-const timeString = time(date);
-const relative = time(date, TimestampStyles.RelativeTime);
-```
-
-</CH.Code>
-
-## Mentions
-
-_`userMention()`_, _`channelMention()`_, and _`roleMention()`_ all exist to format Snowflakes into mentions.
-
-<CH.Code>
-
-```js
-import { channelMention, roleMention, userMention } from 'discord.js';
-
-const id = '123456789012345678';
-const channel = channelMention(id);
-const role = roleMention(id);
-const user = userMention(id);
-```
-
-</CH.Code>

apps/guide/src/content/03-topics/05-intents.mdx

@@ -1,68 +0,0 @@
----
-title: Intents
-category: Topics
----
-
-# Intents
-
-Intents are an important part of establishing a WebSocket connection, as they define behavior regarding gateway events and impact received data via the REST API.
-
-## Usage
-
-```js
-import { Client, GatewayIntentBits } from 'discord.js';
-
-const client = new Client({
-	intents: [GatewayIntentBits.Guilds],
-});
-```
-
-This is the most basic usage of intents for discord.js. By specifying _`GatewayIntentBits.Guilds`_, your bot will receive gateway events regarding guilds. This includes receiving initial information about guilds it is in at startup, such as role data.
-
-You can find the full list of _`GatewayIntentBits`_ <DiscordAPITypesLink type="enum" parent="GatewayIntentBits">on the documentation</DiscordAPITypesLink> and an explanation of what each intent does [on Discord's API documentation](https://discord.com/developers/docs/topics/gateway#list-of-intents).
-
-## Considerations
-
-In discord.js, some intents require an extra bit of consideration.
-
-### _`GatewayIntentBits.Guilds`_
-
-discord.js relies heavily on caching in the library. We recommend you set at least the _`GatewayIntentBits.Guilds`_ intent to avoid these pitfalls.
-
-### _`GatewayIntentBits.GuildMembers`_
-
-Fetching members in a guild via <DocsLink type="class" parent="GuildMemberManager" symbol="fetch" brackets /> requests them over the gateway. As such, this intent is required and you may receive a timeout error if this intent is not specified.
-
-<Alert title="Info" type="info">
-	This is a privileged intent. Read on for more information.
-</Alert>
-
-### _`GatewayIntentBits.DirectMessages`_
-
-This intent is required to receive direct messages. In discord.js however, you **must** specify partials as well. See the partials topic on how this is done.
-
-### _`GatewayIntentBits.MessageContent`_
-
-Unlike other intents, this only populates user-generated fields. See [Discord's documentation](https://discord.com/developers/docs/topics/gateway#message-content-intent) on what exactly this intent unveils.
-
-It is a common mistake to not see the message content in a message—this is usually because this intent is not specified.
-
-<Alert title="Info" type="info">
-	This is a privileged intent. Read on for more information.
-</Alert>
-
-## Privileged intents
-
-Some gateway events are considered privileged. Currently, these are:
-
-- _`GatewayIntentBits.GuildPresences`_
-- _`GatewayIntentBits.GuildMembers`_
-- _`GatewayIntentBits.MessageContent`_
-
-To use these intents, you will need to enable them in the developer portal. If your bot is in over 75 guilds, you will need to verify it and request usage of your desired intents.
-
-Carefully think if you need these intents. They are opt-in so users across the platform can enjoy a higher level of privacy. Presences can expose some personal information, such as the games being played and overall online time. You might find that it isn't necessary for your bot to have this level of information about all guild members at all times.
-
-### Disallowed intents
-
-Should you receive an error stating you are using disallowed intents, please review your developer dashboard settings for all privileged intents you use. Check the Discord API documentation for up-to-date information.

apps/guide/src/content/03-topics/06-threads.mdx

@@ -1,202 +0,0 @@
----
-title: Threads
-category: Topics
----
-
-# Threads
-
-Threads can be thought of as temporary sub-channels inside an existing channel to help better organize conversations in a busy channel.
-
-## Thread related gateway events
-
-<Alert title="Tip" type="info">
-	You can use the <DocsLink type="class" parent="BaseChannel" symbol="isThread" brackets /> type guard to make sure a
-	channel is a <DocsLink type="class" parent="ThreadChannel" />!
-</Alert>
-
-Threads introduce a number of new gateway events, which are listed below:
-
-- <DocsLink type="class" parent="Client" symbol="e-threadCreate" />: Emitted whenever a thread is created or when the
-  client user is added to a thread.
-- <DocsLink type="class" parent="Client" symbol="e-threadDelete" />: Emitted whenever a thread is deleted.
-- <DocsLink type="class" parent="Client" symbol="e-threadUpdate" />: Emitted whenever a thread is updated (e.g. name
-  change, archive state change, locked state change).
-- <DocsLink type="class" parent="Client" symbol="e-threadListSync" />: Emitted whenever the client user gains access to
-  a text or announcement channel that contains threads.
-- <DocsLink type="class" parent="Client" symbol="e-threadMembersUpdate" />: Emitted whenever members are added or
-  removed from a thread. Requires <code>GuildMembers</code> privileged intent.
-- <DocsLink type="class" parent="Client" symbol="e-threadMemberUpdate" />: Emitted whenever the client user's thread
-  member is updated.
-
-## Creating and deleting threads
-
-Threads are created and deleted using the <DocsLink type="class" parent="GuildTextThreadManager" /> of a text or announcement channel.
-To create a thread, you call the <DocsLink type="class" parent="GuildTextThreadManager" symbol="create" brackets /> method:
-
-<CH.Code>
-
-```js
-import { ThreadAutoArchiveDuration } from 'discord.js';
-
-const thread = await channel.threads.create({
-	name: 'food-talk',
-	autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
-	reason: 'Needed a separate thread for food',
-});
-
-console.log(`Created thread: ${thread.name}`);
-```
-
-</CH.Code>
-
-They can also be created from an existing message with the <DocsLink type="class" parent="Message" symbol="startThread" brackets /> method, but will be "orphaned" if that message is deleted.
-
-<CH.Code>
-
-```js focus=3[22:42]
-import { ThreadAutoArchiveDuration } from 'discord.js';
-
-const thread = await message.startThread({
-	name: 'food-talk',
-	autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
-	reason: 'Needed a separate thread for food',
-});
-
-console.log(`Created thread: ${thread.name}`);
-```
-
-</CH.Code>
-
-The created thread and the message it originated from will share the same id. The type of thread created matches the parent channel's type.
-
-To delete a thread, use the <DocsLink type="class" parent="ThreadChannel" symbol="delete" brackets /> method:
-
-<CH.Code>
-
-```js focus=2
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-if (thread.manageable) await thread.delete();
-```
-
-</CH.Code>
-
-## Joining and leaving threads
-
-To subscribe your client to a thread, use the <DocsLink type="class" parent="ThreadChannel" symbol="join" brackets /> method:
-
-<CH.Code>
-
-```js focus=2
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-if (thread.joinable) await thread.join();
-```
-
-</CH.Code>
-
-And to leave one, use the <DocsLink type="class" parent="ThreadChannel" symbol="leave" brackets /> method:
-
-<CH.Code>
-
-```js focus=2
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-await thread.leave();
-```
-
-</CH.Code>
-
-## Archiving, unarchiving, and locking threads
-
-A thread can be either active or archived. Changing a thread from archived to active is referred to as unarchiving the thread. Threads that have _`locked`_ set to _`true`_ can only be unarchived by a member with the _`ManageThreads`_ permission.
-
-Threads are automatically archived after inactivity. "Activity" is defined as sending a message, unarchiving a thread, or changing the auto-archive time.
-
-To archive or unarchive a thread, use the <DocsLink type="class" parent="ThreadChannel" symbol="setArchived" brackets /> method and pass in a boolean parameter:
-
-<CH.Code>
-
-```js focus=2,3
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-await thread.setArchived(true); // Archived.
-await thread.setArchived(false); // Unarchived.
-```
-
-</CH.Code>
-
-This same principle applies to locking and unlocking a thread via the <DocsLink type="class" parent="ThreadChannel" symbol="setLocked" brackets /> method:
-
-<CH.Code>
-
-```js focus=2,3
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-await thread.setLocked(true); // Locked.
-await thread.setLocked(false); // Unlocked.
-```
-
-</CH.Code>
-
-## Private threads
-
-Public threads are viewable by everyone who can view the parent channel of the thread. Private threads, however, are only viewable to those who are invited or have the _`ManageThreads`_ permission. Private threads can only be created on text channels.
-
-To create a private thread, use the <DocsLink type="class" parent="GuildTextThreadManager" symbol="create" brackets /> method and pass in _`ChannelType.PrivateThread`_ as the _`type`_:
-
-<CH.Code>
-
-```js focus=1[10:21],6
-import { ChannelType, ThreadAutoArchiveDuration } from 'discord.js';
-
-const thread = await channel.threads.create({
-	name: 'mod-talk',
-	autoArchiveDuration: ThreadAutoArchiveDuration.OneHour,
-	type: ChannelType.PrivateThread,
-	reason: 'Needed a separate thread for moderation',
-});
-
-console.log(`Created thread: ${thread.name}`);
-```
-
-</CH.Code>
-
-## Adding and removing members
-
-You can add members to a thread with the <DocsLink type="class" parent="ThreadMemberManager" symbol="add" brackets /> method. The thread must be unarchived and you must be able to send messages in it.
-
-<CH.Code>
-
-```js focus=2
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-await thread.members.add('12345678901234567');
-```
-
-</CH.Code>
-
-You can remove members from a thread with the <DocsLink type="class" parent="ThreadMemberManager" symbol="remove" brackets /> method. The thread must be unarchived and you must have the _`ManageThreads`_ permission unless the thread is private and you are the owner of it.
-
-<CH.Code>
-
-```js focus=2
-const thread = channel.threads.cache.find((x) => x.name === 'food-talk');
-await thread.members.remove('12345678901234567');
-```
-
-</CH.Code>
-
-## Sending messages to threads with webhooks
-
-It is possible for a webhook built on the parent channel to send messages to the channel's threads. For the purpose of this example, it is assumed a single webhook already exists for that channel. If you wish to learn more about webhooks, see our [webhook guide](./webhooks).
-
-<CH.Code>
-
-```js focus=4:7
-const webhooks = await channel.fetchWebhooks();
-const webhook = webhooks.first();
-
-await webhook.send({
-	content: "Look ma! I'm in a thread!",
-	threadId: '123456789012345678',
-});
-```
-
-</CH.Code>
-
-And that's it! Now you know all there is to know on working with threads using discord.js!