Move the docs from Nextra to Fumadocs

.claude/skills/curate-toolkit-docs/SKILL.md

@@ -19,7 +19,7 @@ procedure.
 Curation is for prose bound to one toolkit or one tool: auth setup, enum value
 tables, parameter caveats, per-tool warnings. If the content is a standalone
 guide or concept explanation — anything a reader would reach from the sidebar
-on its own — it belongs in `app/en/` as a normal MDX page instead. Stop and
+on its own — it belongs in `content/docs/` as a normal MDX page instead. Stop and
 write that page.
 
 ## Step 2: read the neighbors
@@ -116,7 +116,7 @@ cd toolkit-docs-generator
 ../node_modules/.bin/tsx src/cli/index.ts validate-curation --toolkit <ToolkitId>
 ```
 
-Errors name the exact file and reason. Then `pnpm vale:check` from the repo
+Errors name the exact file and reason. Then `bun run vale:check` from the repo
 root.
 
 If you used `tool:`, confirm the value against the generated JSON, where

.cursorignore

@@ -12,7 +12,6 @@ out/
 toolkit-docs-generator/dist/
 toolkit-docs-generator/output/
 toolkit-docs-generator/test-output/
-.i18n-cache/
 .pytest_cache/
 *.log
 *.sqlite

.github/scripts/update-example-dates.js

@@ -16,21 +16,21 @@ function parseRepositoriesFromMDX(content) {
 
   let match = sampleAppCardRegex.exec(content);
   while (match !== null) {
-    const propsString = match[1];
+    const [, propsString] = match;
 
     // Extract title and href from props
     const titleMatch = propsString.match(TITLE_PATTERN);
     const hrefMatch = propsString.match(HREF_PATTERN);
 
     if (titleMatch && hrefMatch) {
-      const title = titleMatch[1];
-      const href = hrefMatch[1];
+      const [, title] = titleMatch;
+      const [, href] = hrefMatch;
 
       // Check if it's a GitHub URL and extract repo name
       const githubMatch = href.match(GITHUB_PATTERN);
 
       if (githubMatch) {
-        const repoName = githubMatch[1];
+        const [, repoName] = githubMatch;
         repositories.push({
           title,
           repo: repoName,
@@ -95,11 +95,18 @@ function formatDate(date) {
 async function updateExampleDates() {
   console.log("Parsing repositories from MDX file...");
 
-  // Read the current MDX file
-  const mdxPath = path.join(
-    import.meta.dirname,
-    "../../app/en/resources/examples/page.mdx"
-  );
+  // Read the current MDX file. The examples page is content/docs/resources/
+  // examples.mdx, or examples/index.mdx once it gains child pages.
+  const contentDir = path.join(import.meta.dirname, "../../content/docs");
+  const mdxPath = [
+    path.join(contentDir, "resources/examples.mdx"),
+    path.join(contentDir, "resources/examples/index.mdx"),
+  ].find((candidate) => fs.existsSync(candidate));
+  if (!mdxPath) {
+    throw new Error(
+      "Could not find the examples page under content/docs/resources/"
+    );
+  }
   let content = fs.readFileSync(mdxPath, "utf8");
 
   // Parse repositories from the MDX file

.github/workflows/algolia-reindex.yml

@@ -46,7 +46,7 @@ jobs:
         id: changed
         run: |
           files=$(git diff-tree --no-commit-id --name-only -r HEAD)
-          if echo "$files" | grep -qE '^app/en/|^toolkit-docs-generator/data/toolkits/|^app/_components/toolkit-docs/|^app/_lib/toolkit-|^algolia/crawler-config\.js$|^scripts/sync-crawler-config\.ts$'; then
+          if echo "$files" | grep -qE '^content/docs/|^toolkit-docs-generator/data/toolkits/|^components/toolkit-docs/|^lib/toolkit-|^algolia/crawler-config\.js$|^scripts/sync-crawler-config\.ts$'; then
             echo "docs=true" >> "$GITHUB_OUTPUT"
             echo "Docs content changed — will reindex."
           else

.github/workflows/check-external-urls.yml

@@ -19,17 +19,13 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: "22"
-          cache: pnpm
+          bun-version-file: package.json
 
       - name: Install dependencies
-        run: pnpm install
+        run: bun install --frozen-lockfile
 
       - name: Check external URLs
-        run: pnpm vitest run --config vitest.external-urls.config.ts
+        run: bun run test:external-urls

.github/workflows/check-redirects.yml

@@ -4,8 +4,8 @@ on:
   pull_request:
     types: [opened, synchronize, reopened]
     paths:
-      - "app/**/*.md"
-      - "app/**/*.mdx"
+      - "content/docs/**/*.md"
+      - "content/docs/**/*.mdx"
       - "redirects.ts"
 
 permissions:
@@ -26,19 +26,19 @@ jobs:
       - name: Fetch base branch
         run: git fetch origin ${{ github.base_ref }}:${{ github.base_ref }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: "20"
+          bun-version-file: package.json
 
       - name: Install dependencies
-        run: npm install -g pnpm && pnpm install
+        run: bun install --frozen-lockfile
 
       - name: Check for missing redirects
         id: check
         run: |
           set -o pipefail
-          pnpm check-redirects ${{ github.base_ref }} 2>&1 | tee redirect-check-output.txt
+          bun run check-redirects ${{ github.base_ref }} 2>&1 | tee redirect-check-output.txt
         continue-on-error: true
 
       - name: Comment on PR if redirects are missing
@@ -52,7 +52,7 @@ jobs:
             // Extract the missing redirects and suggestions from output
             const body = `## 🔗 Missing Redirects Detected
 
-            This PR deletes markdown files that don't have corresponding redirects in \`redirects.ts\`.
+            This PR deletes content pages that don't have corresponding redirects in \`redirects.ts\`.
 
             When you delete a page, you must add a redirect to prevent broken links for users who have bookmarked the old URL.
 

.github/workflows/generate-toolkit-docs.yml

@@ -2,7 +2,7 @@ name: Generate toolkit docs
 # Description: Generate toolkit JSON from the public tool catalog, then sync sidebar navigation.
 # Flow:
 # 1) Generate toolkit JSON into toolkit-docs-generator/data/toolkits
-# 2) Sync integrations sidebar _meta.tsx from toolkit-docs-generator/data/toolkits
+# 2) Sync integrations sidebar meta.json files from toolkit-docs-generator/data/toolkits
 # 3) Regenerate public/llms.txt so the automation PR is self-contained
 # 4) Create or update a PR if changes were produced
 #
@@ -52,22 +52,25 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version-file: package.json
 
+      # The generator runs on Node through tsx: Bun resolves the design system's
+      # `bun` export condition, which points at sources the package does not ship.
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
-          cache: pnpm
+          node-version-file: .nvmrc
 
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile
+        run: bun install --frozen-lockfile
 
       - name: Generate toolkit docs
         id: generate-docs
-        # Invoked by path rather than through `pnpm exec`, which would reset the
-        # working directory to the repo root and break the relative paths below.
+        # Invoked by path from the generator directory so the relative paths
+        # below resolve against it.
         run: |
           ../node_modules/.bin/tsx src/cli/index.ts generate \
             --all \
@@ -99,12 +102,12 @@ jobs:
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 
       - name: Sync toolkit sidebar navigation
-        run: pnpm exec tsx toolkit-docs-generator/scripts/sync-toolkit-sidebar.ts --remove-empty-sections=false --verbose
+        run: bun run sync-toolkit-sidebar --remove-empty-sections=false --verbose
 
       # GITHUB_TOKEN PRs do not start llmstxt.yml, so generate the file here.
       # The toolkit generator CLI still does not write llms.txt.
       - name: Generate llms.txt
-        run: pnpm llmstxt
+        run: bun run llmstxt
         env:
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 

.github/workflows/llmstxt.yml

@@ -6,15 +6,15 @@ on:
     branches:
       - main
     paths:
-      - "app/en/**/*.mdx"
-      - "app/en/**/_meta.tsx"
+      - "content/docs/**/*.mdx"
+      - "content/docs/**/meta.json"
       - "scripts/generate-llmstxt.ts"
       - "toolkit-docs-generator/data/toolkits/**"
   pull_request:
     types: [opened, synchronize, reopened]
     paths:
-      - "app/en/**/*.mdx"
-      - "app/en/**/_meta.tsx"
+      - "content/docs/**/*.mdx"
+      - "content/docs/**/meta.json"
       - "scripts/generate-llmstxt.ts"
       - "toolkit-docs-generator/data/toolkits/**"
 
@@ -28,24 +28,28 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22.x"
-
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.ref || github.ref }}
 
-      - name: Install dependencies
-        run: npm install -g pnpm
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version-file: package.json
 
-      - name: Install pnpm
-        run: pnpm install
+      # The script runs on Node through tsx: Bun resolves the design system's
+      # `bun` export condition, which points at sources the package does not ship.
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
 
       - name: generate LLMs.txt
-        run: pnpm llmstxt
+        run: bun run llmstxt
         env:
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 

.github/workflows/style-review.yml

@@ -10,8 +10,8 @@ on:
   pull_request:
     types: [opened, synchronize, reopened]
     paths:
-      - "app/en/**/*.md"
-      - "app/en/**/*.mdx"
+      - "content/docs/**/*.md"
+      - "content/docs/**/*.mdx"
 
 permissions:
   contents: read
@@ -37,16 +37,13 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Use Node.js
-        uses: actions/setup-node@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: "22.x"
-
-      - name: Install pnpm
-        run: npm install -g pnpm
+          bun-version-file: package.json
 
       - name: Install dependencies
-        run: pnpm install
+        run: bun install --frozen-lockfile
 
       - name: Install Vale
         run: |
@@ -56,7 +53,7 @@ jobs:
         run: vale sync
 
       - name: Run style review
-        run: pnpm vale:review --pr ${{ github.event.pull_request.number || inputs.pr_number }}
+        run: bun run vale:review --pr ${{ github.event.pull_request.number || inputs.pr_number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

.github/workflows/style-structural-review.yml

@@ -10,8 +10,8 @@ on:
   pull_request:
     types: [closed]
     paths:
-      - "app/en/**/*.md"
-      - "app/en/**/*.mdx"
+      - "content/docs/**/*.md"
+      - "content/docs/**/*.mdx"
 
 permissions:
   contents: write
@@ -30,16 +30,13 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Use Node.js
-        uses: actions/setup-node@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version: "22.x"
-
-      - name: Install pnpm
-        run: npm install -g pnpm
+          bun-version-file: package.json
 
       - name: Install dependencies
-        run: pnpm install
+        run: bun install --frozen-lockfile
 
       - name: Install Vale
         run: |
@@ -49,7 +46,7 @@ jobs:
         run: vale sync
 
       - name: Run editorial review
-        run: pnpm vale:editorial --pr ${{ github.event.pull_request.number || inputs.pr_number }}
+        run: bun run vale:editorial --pr ${{ github.event.pull_request.number || inputs.pr_number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

.github/workflows/sync-crawler-config.yml

@@ -36,10 +36,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
         with:
-          node-version-file: .nvmrc
+          bun-version-file: package.json
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
       - name: Sync config and trigger reindex
         env:
           ALGOLIA_CRAWLER_ID: ${{ vars.ALGOLIA_CRAWLER_ID }}
@@ -50,4 +53,4 @@ jobs:
           # Vercel production deploy so pages are live before the crawl starts.
           # On workflow_dispatch there is no pending deploy, so reindex immediately.
           SKIP_REINDEX: ${{ github.event_name == 'push' }}
-        run: pnpm sync-crawler-config
+        run: bun run sync-crawler-config