Skip to content

feat: render /integrations gallery from datasources catalog#123

Open
Debanitrkl wants to merge 1 commit intomainfrom
add-datasources-integration
Open

feat: render /integrations gallery from datasources catalog#123
Debanitrkl wants to merge 1 commit intomainfrom
add-datasources-integration

Conversation

@Debanitrkl
Copy link
Copy Markdown
Contributor

Summary

  • Adds parseablehq/datasources as a git submodule at vendor/datasources/.
  • Introduces IntegrationGallery — a React Server Component that reads vendor/datasources/dist/integrations.json at build time, groups by resource, and renders Fumadocs <Cards> with per-integration logos.
  • Adds scripts/sync-catalog.mjs (wired to predev + prebuild) which copies logos from the submodule into public/integrations/logos/. Script soft-fails when the submodule is absent so fresh clones without --recurse-submodules still build.
  • Rewrites content/docs/integrations/index.mdx to use <IntegrationGallery /> for ingest-data sections. Visualization, Incident management, Authentication, and Storage targets remain hand-maintained MDX (they live outside the catalog today).
  • Adds /public/integrations/logos/ to .gitignore (generated artifact).

Why

The /integrations page was hand-maintained and drifting from the Parseable product UI (Prism), which already consumes this catalog. This PR makes the docs a second consumer so both surfaces stay in sync.

Depends on

Test plan

  • pnpm sync-catalog copies 51 logos into public/integrations/logos/
  • pnpm build succeeds end-to-end (359 static pages)
  • /docs/integrations renders catalog-driven sections above the hand-maintained ones
  • tsc --noEmit clean on the new files
  • pnpm check-links — no new broken links introduced (pre-existing issues in other files unchanged)
  • Post-merge: git submodule update --remote vendor/datasources && pnpm sync-catalog lifts gallery to 60 entries once datasources#6 lands

Clone instructions for reviewers

git clone --recurse-submodules git@github.com:parseablehq/developer-hub.git
# or for existing clones:
git submodule update --init --recursive

🤖 Generated with Claude Code

Adds the parseablehq/datasources repo as a git submodule at
vendor/datasources and introduces an IntegrationGallery server
component that reads dist/integrations.json at build time, groups
entries by resource, and renders them as Fumadocs Cards. A prebuild
step copies logos into public/integrations/logos/ so Next serves
them as static assets.

content/docs/integrations/index.mdx now uses <IntegrationGallery />
for the ingest-data sections; Visualization, Incident management,
Authentication, and Storage targets stay as hand-maintained MDX
because they live outside the catalog today.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 22, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 22, 2026 5:12am

Request Review

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.

1 participant