Files
supabase/apps/studio/components/interfaces/Integrations/Landing/useIntegrationDetail.ts
dc986674d9 chore(studio): integrations Marketplace layout (#45856)
Introducing a new Integrations Marketplace layout
- behind feature flag
- behind opt-out feature preview (default to true) to easily toggle
before and after

Doesn't introduce new functionality, only layout change behind ff.

## What changed

Nothing if `marketplaceIntegrations` flag is off.

### With flag

- New Marketplace index layout
  - filter via text or by `category`, `integration type` and `source`
- Featured Partners Integrations hero (hidden when any filter is active)
  - toggle between `grid` and `list` view
- new integration detail page layout
  - with top action bar
  - more consistent fullWidth or narrow content layouts
- can access Feature Preview toggle under Account Dropdown > Feature
Previews > Marketplace

## How to review and what to test

I recommend reviewing file changes from bottom to top in
https://github.com/supabase/supabase/pull/45856/changes because it makes
more sense from a pr-logic perspective.

- [ ] Visit
https://studio-staging-git-chore-integrations-ui-refine-fs-supabase.vercel.app/dashboard/project/_/integrations
- [ ] Check if new layout doesn't have big layout issues like weird
paddings or margins mostly. (We can iterate in upcoming PRs for
additional features/fixes)
- [ ] Toggle "Marketplace" feature preview to `FALSE` and check that the
Integrations layout looks like in prod
https://supabase.com/dashboard/project/_/integrations
- [ ] Also check individual integration pages and toggle the feature
preview on and off to see before and after and check if everything looks
good

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Full Marketplace experience: explorer with featured hero,
filters/search, list & grid views, cards, sidebar, detailed integration
pages, install flows, badges, and a preview toggle.

* **Bug Fixes**
  * Prevented stale markdown from showing when switching integrations.

* **Style**
* Improved responsive layouts, loading placeholders, and header/nav
full-width behavior.

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/supabase/supabase/pull/45856)

<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Saxon Fletcher <saxonafletcher@gmail.com>
Co-authored-by: Raminder Singh <romi_ssk@yahoo.co.in>
2026-05-20 11:01:32 +02:00

123 lines
3.7 KiB
TypeScript

import { useParams } from 'common'
import { useRouter } from 'next/router'
import { useEffect, useMemo } from 'react'
import { useAvailableIntegrations } from './useAvailableIntegrations'
import { useInstalledIntegrations } from './useInstalledIntegrations'
import { useDatabaseExtensionsQuery } from '@/data/database-extensions/database-extensions-query'
import { useIsFeatureEnabled } from '@/hooks/misc/useIsFeatureEnabled'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
export type IntegrationTab = {
label: string
href: string
active: boolean
}
export const useIntegrationDetail = () => {
const router = useRouter()
const { ref, id, pageId, childId } = useParams()
const { integrationsWrappers } = useIsFeatureEnabled(['integrations:wrappers'])
const { data: project } = useSelectedProjectQuery()
const { data: extensions } = useDatabaseExtensionsQuery({
projectRef: project?.ref,
connectionString: project?.connectionString,
})
const { data: allIntegrations, isPending: isAvailableLoading } = useAvailableIntegrations()
const { installedIntegrations, isLoading: isInstalledLoading } = useInstalledIntegrations()
// wrapped in useMemo to avoid UI resets when installing additional extensions like pg_net
const integration = useMemo(() => allIntegrations.find((i) => i.id === id), [allIntegrations, id])
const installation = useMemo(
() => installedIntegrations.find((i) => i.id === id),
[installedIntegrations, id]
)
const installableExtensions = (extensions ?? []).filter((ext) =>
(integration?.requiredExtensions ?? []).includes(ext.name)
)
const extensionsInstalled = installableExtensions.every((x) => x.installed_version)
// installedIntegrations doesn't return wrappers unless there's a wrapper created
const isInstalled =
!!integration && (!!installation || (integration.type === 'wrapper' && extensionsInstalled))
const navItems = useMemo(() => {
if (!integration?.navigation) return []
return isInstalled
? integration.navigation
: integration.navigation.filter((nav) => nav.route === 'overview')
}, [integration, isInstalled])
const activeRoute = pageId ?? 'overview'
const activeNav = useMemo(
() => navItems.find((nav) => nav.route === activeRoute),
[navItems, activeRoute]
)
const isKnownRoute = !!activeNav
const layout = (activeNav?.layout ?? 'full') as 'full' | 'constrained'
const tabs: IntegrationTab[] = useMemo(
() =>
navItems.map((nav) => ({
label: nav.label,
href: `/project/${ref}/integrations/${id}/${nav.route}`,
active: nav.route === activeRoute,
})),
[navItems, ref, id, activeRoute]
)
const Component = useMemo(
() => integration?.navigate({ id, pageId, childId }),
[integration, id, pageId, childId]
)
const isReady = !!router?.isReady
const isWrapperBlocked = !integrationsWrappers && !!id?.endsWith('_wrapper')
const pageTitle = integration?.name ?? 'Integration not found'
const pageSubTitle =
integration?.description ?? 'If you think this is an error, please contact support'
useEffect(() => {
if (
router?.isReady &&
!isAvailableLoading &&
!isInstalledLoading &&
!!integration &&
pageId &&
!isKnownRoute
) {
router.replace(`/project/${ref}/integrations/${id}/overview`)
}
}, [router, pageId, ref, id, integration, isKnownRoute, isAvailableLoading, isInstalledLoading])
return {
ref,
id,
pageId,
childId,
activeRoute,
activeNav,
isKnownRoute,
layout,
tabs,
isReady,
isWrapperBlocked,
pageTitle,
pageSubTitle,
integrationsWrappers,
integration,
installation,
isInstalled,
isAvailableLoading,
isInstalledLoading,
Component,
}
}