Some tweaks in tool docs (#847)

* Some tweaks in tool docs

* adding to exclusion list

* simplifying  action

* Renamed workflow to "Toolkit docs coverage" and updated file names.

* Update excluded-toolkits.txt

* only warning when link broken

* fixing workflow

* fixing again

* fix: replace broken PagerDuty OAuth 2.0 guide URL

The previous URL (build-sophisticated-apps-for-your-pagerduty-environment-using-oauth-2-0-and-api-scopes) returns 404. Replaced with updating-your-tools-for-api-scopes which covers the same topic: OAuth 2.0, API scopes, app setup, and token management.

Made-with: Cursor

* deleting when not found in api call

* Rename middleware.ts to proxy.ts for Next.js 16 compatibility

Next.js 16 deprecated the middleware file convention in favour of proxy.
Rename the file and its export accordingly. The API surface (NextRequest,
NextResponse, config matcher) is identical, no behaviour changes.

Fixes Vercel build warning:
  ⚠ The "middleware" file convention is deprecated. Please use "proxy" instead.

Made-with: Cursor

* Revert "Rename middleware.ts to proxy.ts for Next.js 16 compatibility"

This reverts commit 752a7b5.

* some minor fixes and adding a test case to be remove in gh

* chore: remove DemoRemoveMe test toolkit

Made-with: Cursor

Author: jottakka

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

@@ -0,0 +1,35 @@
+name: External URL check
+
+on:
+  workflow_dispatch:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: External URL check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Check external URLs
+        run: pnpm vitest run --config vitest.external-urls.config.ts

app/en/resources/integrations/create-category-meta.ts

@@ -0,0 +1,48 @@
+import type { MetaRecord } from "nextra";
+
+type ToolkitType =
+  | "arcade"
+  | "arcade_starter"
+  | "community"
+  | "verified"
+  | "auth";
+
+export type CategoryEntry = {
+  slug: string;
+  title: string;
+  href: string;
+  type: ToolkitType;
+};
+
+/**
+ * Builds a Nextra MetaRecord for an integration category, automatically
+ * inserting "Optimized" and "Starter" separator headings based on toolkit type.
+ *
+ * - "Optimized" group: any entry whose type is not "arcade_starter"
+ * - "Starter" group: entries with type "arcade_starter"
+ *
+ * A separator is only emitted when its group is non-empty, so categories
+ * with a single type do not show an unnecessary heading.
+ */
+export function createCategoryMeta(entries: CategoryEntry[]): MetaRecord {
+  const optimized = entries.filter((e) => e.type !== "arcade_starter");
+  const starter = entries.filter((e) => e.type === "arcade_starter");
+
+  const result: MetaRecord = {};
+
+  if (optimized.length > 0) {
+    result["-- Optimized"] = { type: "separator", title: "Optimized" };
+    for (const entry of optimized) {
+      result[entry.slug] = { title: entry.title, href: entry.href };
+    }
+  }
+
+  if (starter.length > 0) {
+    result["-- Starter"] = { type: "separator", title: "Starter" };
+    for (const entry of starter) {
+      result[entry.slug] = { title: entry.title, href: entry.href };
+    }
+  }
+
+  return result;
+}

app/en/resources/integrations/customer-support/_meta.tsx

@@ -1,38 +1,40 @@
-import type { MetaRecord } from "nextra";
+import { createCategoryMeta } from "../create-category-meta";
 
-const meta: MetaRecord = {
-  "-- Optimized": {
-    type: "separator",
-    title: "Optimized",
-  },
-  zendesk: {
+export default createCategoryMeta([
+  {
+    slug: "zendesk",
     title: "Zendesk",
     href: "/en/resources/integrations/customer-support/zendesk",
+    type: "arcade",
   },
-  "-- Starter": {
-    type: "separator",
-    title: "Starter",
-  },
-  "customerio-api": {
+  {
+    slug: "customerio-api",
     title: "Customer.io API",
     href: "/en/resources/integrations/customer-support/customerio-api",
+    type: "arcade_starter",
   },
-  "customerio-pipelines-api": {
+  {
+    slug: "customerio-pipelines-api",
     title: "Customer.io Pipelines API",
     href: "/en/resources/integrations/customer-support/customerio-pipelines-api",
+    type: "arcade_starter",
   },
-  "customerio-track-api": {
+  {
+    slug: "customerio-track-api",
     title: "Customer.io Track API",
     href: "/en/resources/integrations/customer-support/customerio-track-api",
+    type: "arcade_starter",
   },
-  "freshservice-api": {
+  {
+    slug: "freshservice-api",
     title: "Freshservice API",
     href: "/en/resources/integrations/customer-support/freshservice-api",
+    type: "arcade_starter",
   },
-  "intercom-api": {
+  {
+    slug: "intercom-api",
     title: "Intercom API",
     href: "/en/resources/integrations/customer-support/intercom-api",
+    type: "arcade_starter",
   },
-};
-
-export default meta;
+]);

app/en/resources/integrations/databases/_meta.tsx

@@ -1,34 +1,34 @@
-import type { MetaRecord } from "nextra";
+import { createCategoryMeta } from "../create-category-meta";
 
-const meta: MetaRecord = {
-  "-- Optimized": {
-    type: "separator",
-    title: "Optimized",
-  },
-  clickhouse: {
+export default createCategoryMeta([
+  {
+    slug: "clickhouse",
     title: "Clickhouse",
     href: "/en/resources/integrations/databases/clickhouse",
+    type: "community",
   },
-  mongodb: {
+  {
+    slug: "mongodb",
     title: "MongoDB",
     href: "/en/resources/integrations/databases/mongodb",
+    type: "community",
   },
-  postgres: {
+  {
+    slug: "postgres",
     title: "Postgres",
     href: "/en/resources/integrations/databases/postgres",
+    type: "community",
   },
-  "-- Starter": {
-    type: "separator",
-    title: "Starter",
-  },
-  "weaviate-api": {
+  {
+    slug: "weaviate-api",
     title: "Weaviate API",
     href: "/en/resources/integrations/databases/weaviate-api",
+    type: "arcade_starter",
   },
-  yugabytedb: {
+  {
+    slug: "yugabytedb",
     title: "YugabyteDB",
     href: "/en/resources/integrations/databases/yugabytedb",
+    type: "arcade_starter",
   },
-};
-
-export default meta;
+]);

app/en/resources/integrations/development/_meta.tsx

@@ -1,102 +1,118 @@
-import type { MetaRecord } from "nextra";
+import { createCategoryMeta } from "../create-category-meta";
 
-const meta: MetaRecord = {
-  "-- Optimized": {
-    type: "separator",
-    title: "Optimized",
-  },
-  brightdata: {
+export default createCategoryMeta([
+  {
+    slug: "brightdata",
     title: "Bright Data",
     href: "/en/resources/integrations/development/brightdata",
+    type: "community",
   },
-  complextools: {
-    title: "ComplexTools",
-    href: "/en/resources/integrations/development/complextools",
-  },
-  daytona: {
+  {
+    slug: "daytona",
     title: "Daytona",
     href: "/en/resources/integrations/development/daytona",
+    type: "arcade",
   },
-  deepwiki: {
-    title: "Deepwiki",
-    href: "/en/resources/integrations/development/deepwiki",
-  },
-  e2b: {
+  {
+    slug: "e2b",
     title: "E2B",
     href: "/en/resources/integrations/development/e2b",
+    type: "arcade",
   },
-  figma: {
+  {
+    slug: "figma",
     title: "Figma",
     href: "/en/resources/integrations/development/figma",
+    type: "arcade",
   },
-  firecrawl: {
+  {
+    slug: "firecrawl",
     title: "Firecrawl",
     href: "/en/resources/integrations/development/firecrawl",
+    type: "arcade",
   },
-  github: {
+  {
+    slug: "github",
     title: "GitHub",
     href: "/en/resources/integrations/development/github",
+    type: "arcade",
   },
-  math: {
+  {
+    slug: "math",
     title: "Math",
     href: "/en/resources/integrations/development/math",
+    type: "arcade",
   },
-  pagerduty: {
+  {
+    slug: "pagerduty",
     title: "Pagerduty",
     href: "/en/resources/integrations/development/pagerduty",
+    type: "arcade",
   },
-  pylon: {
+  {
+    slug: "pylon",
     title: "Pylon",
     href: "/en/resources/integrations/development/pylon",
+    type: "arcade",
   },
-  search: {
+  {
+    slug: "search",
     title: "Search",
     href: "/en/resources/integrations/development/search",
+    type: "arcade",
   },
-  test2: {
-    title: "Test2",
-    href: "/en/resources/integrations/development/test2",
-  },
-  web: {
+  {
+    slug: "web",
     title: "Web",
     href: "/en/resources/integrations/development/web",
+    type: "arcade",
   },
-  "-- Starter": {
-    type: "separator",
-    title: "Starter",
-  },
-  "arcade-engine-api": {
+  {
+    slug: "arcade-engine-api",
     title: "Arcade Engine API",
     href: "/en/resources/integrations/development/arcade-engine-api",
+    type: "arcade_starter",
   },
-  "cursor-agents-api": {
+  {
+    slug: "cursor-agents-api",
     title: "Cursor Agents API",
     href: "/en/resources/integrations/development/cursor-agents-api",
+    type: "arcade_starter",
   },
-  "datadog-api": {
+  {
+    slug: "datadog-api",
     title: "Datadog API",
     href: "/en/resources/integrations/development/datadog-api",
+    type: "arcade_starter",
   },
-  "github-api": {
+  {
+    slug: "github-api",
     title: "GitHub API",
     href: "/en/resources/integrations/development/github-api",
+    type: "arcade_starter",
   },
-  "pagerduty-api": {
+  {
+    slug: "pagerduty-api",
     title: "PagerDuty API",
     href: "/en/resources/integrations/development/pagerduty-api",
+    type: "arcade_starter",
   },
-  "posthog-api": {
+  {
+    slug: "posthog-api",
     title: "PostHog API",
     href: "/en/resources/integrations/development/posthog-api",
+    type: "arcade_starter",
   },
-  pylonapi: {
+  {
+    slug: "pylonapi",
     title: "PylonApi",
     href: "/en/resources/integrations/development/pylonapi",
+    type: "arcade_starter",
   },
-  "vercel-api": {
+  {
+    slug: "vercel-api",
     title: "Vercel API",
     href: "/en/resources/integrations/development/vercel-api",
+    type: "arcade_starter",
   },
-};
-
-export default meta;
+]);

app/en/resources/integrations/entertainment/_meta.tsx

@@ -1,14 +1,16 @@
-import type { MetaRecord } from "nextra";
+import { createCategoryMeta } from "../create-category-meta";
 
-const meta: MetaRecord = {
-  imgflip: {
+export default createCategoryMeta([
+  {
+    slug: "imgflip",
     title: "Imgflip",
     href: "/en/resources/integrations/entertainment/imgflip",
+    type: "arcade",
   },
-  spotify: {
+  {
+    slug: "spotify",
     title: "Spotify",
     href: "/en/resources/integrations/entertainment/spotify",
+    type: "arcade",
   },
-};
-
-export default meta;
+]);