Skip to content

feat: add filterable integrations grid component#4676

Draft
lennessyy wants to merge 12 commits into
mainfrom
worktree-feat+integrations-grid
Draft

feat: add filterable integrations grid component#4676
lennessyy wants to merge 12 commits into
mainfrom
worktree-feat+integrations-grid

Conversation

@lennessyy

@lennessyy lennessyy commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new IntegrationsGrid React component with search bar, SDK filter pills, and category tag filters
  • Replaces markdown tables on all SDK integration index pages (Java, Python, Ruby, TypeScript) and the main /develop/integrations page with the interactive grid
  • Cards link to integration guides, with an external link icon and target="_blank" for links outside the docs site
  • SDK-specific pages pre-select their SDK filter via defaultSdks prop
  • Sidebar children under integration categories are hidden unless the reader is on that specific child page (CSS :has() selector)

Test plan

  • Verify /develop/integrations shows all 13 integrations with working search and filters
  • Verify SDK-specific pages (/develop/python/integrations, etc.) pre-filter to the correct SDK
  • Verify external link icons appear on cards linking outside the docs (Google ADK, Mastra, OpenAI Agents SDK, Pydantic AI, Tenuo)
  • Verify sidebar hides child pages on the index and shows only the current page on child pages
  • Verify light and dark mode rendering

🤖 Generated with Claude Code

┆Attachments: EDU-6494 Add filterable integrations grid component

Replace markdown tables on integration index pages with an interactive
card grid that supports search and filtering by SDK and category tag.
The same component is reused across the main integrations page and each
SDK-specific page (with the SDK pre-selected). Sidebar children under
integration categories are hidden unless the reader is on that page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy lennessyy requested a review from a team as a code owner June 8, 2026 17:49
@vercel

vercel Bot commented Jun 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jun 10, 2026 12:28am

Request Review

@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Switch accent colors to the homepage purple gradient for active pills,
search focus, and card hover glow. Use inset box-shadow instead of
border on pills, cards, and search input to prevent right-edge clipping.
Move Plugin system text above the grid on Python and Java pages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Shorten variable names to --ig-* prefix, deduplicate shared theme
values, scope variables to .container, consolidate focus colors into
one variable. Extract FILTER_GROUPS config to remove duplicate filter
JSX. Remove unused barrel export.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy lennessyy changed the title Add filterable integrations grid component feat: add filterable integrations grid component Jun 8, 2026
@Duncanma

Duncanma commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

I find it a little odd that I can go to the Java integration and then view python ones... should the "SDK specific" view not have the language filter? https://temporal-documentation-9czotgo4q.preview.thundergun.io/develop/java/integrations/

Replace PNG icons with the design team's colored block SVG components
(SdkSvg). Split Braintrust into separate Python and TypeScript entries
with SDK-specific guide links. Remove SDK text badges from cards.
Disable hover effect on SDK icons within cards.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Hide Copy for LLM and View as Markdown buttons on pages that render
the interactive grid component. Point LLMs to the integrations-data.ts
source file for machine-readable integration metadata.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy

lennessyy commented Jun 8, 2026

Copy link
Copy Markdown
Contributor Author

I find it a little odd that I can go to the Java integration and then view python ones... should the "SDK specific" view not have the language filter? https://temporal-documentation-9czotgo4q.preview.thundergun.io/develop/java/integrations/

Hmm, I am inclined to say that preselecting a language filter for them is sufficient here. Some languages have much fewer integrations than others. If a user never saw the main integrations page, not seeing the filter option could lead them to conclude that we have far fewer integrations than we actually do?

On the other hand I don't really see a downside for users to be able to explore integrations in other languages if they wish, even if they are on a specific language page, but I'm open to changes here.

I am also going to show this to the PMs and our product marketing contact before final reviews, so there could be other changes in the meantime.

Move integrations page from /develop/integrations to /integrations with
redirect. Add to sidebar after Encyclopedia. Add Cloud metrics
integrations (ClickStack, Datadog, Grafana Cloud, New Relic,
Prometheus + Grafana) with no SDK association. Simplify data model
from sdks: SDK[] to sdk?: SDK. Link metrics integrations to partner
docs where available.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
lennessyy and others added 2 commits June 8, 2026 16:47
Darken active pill gradient end for AA text contrast (5.2:1+).
Increase border opacity on cards, pills, and search input in both
themes for 3:1 UI component contrast. Brighten pill and badge text
in dark mode from #94a3b8 to #cbd5e1. Increase external link icon
opacity from 0.45 to 0.6.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Use border-image with the homepage purple gradient on card hover,
combined with the existing purple glow box-shadow. Switch cards from
inset box-shadow borders to regular borders for border-image compat.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Switch category from single string to tags array to support
multi-tag integrations. Cloud metrics integrations now carry
both Observability and Temporal Cloud tags. Add Language agnostic
option in the SDK filter row to surface integrations without a
specific SDK.
Resolve merge conflicts keeping the grid component on Python
integrations page. Add OpenBox as a Python integration with
Governance and Observability tags.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants