Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Python agentagentic-aiagentic-frameworkagentic-workflowaiautomationclaudedeepseekgenaigptllmlow-codemcpnextjsno-codeopenaipythonskillsworkflow
'use client'
import type {
AppPagination,
AppPartial,
GetAppsData,
} from '@dify/contracts/api/console/apps/types.gen'
import type { RecommendedAppResponse } from '@dify/contracts/api/console/explore/types.gen'
import type { GetSystemFeaturesResponse } from '@dify/contracts/api/console/system-features/types.gen'
import type { RefObject } from 'react'
import {
AlertDialog,
AlertDialogContent,
createAlertDialogHandle,
} from '@langgenius/dify-ui/alert-dialog'
import { Button } from '@langgenius/dify-ui/button'
import { cn } from '@langgenius/dify-ui/cn'
import {
keepPreviousData,
useInfiniteQuery,
useMutation,
useQuery,
useSuspenseQuery,
} from '@tanstack/react-query'
import { useCallback, useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
import { DeleteAppForm } from '@/app/components/app/delete-app-form'
import { InfiniteScrollSentinel } from '@/app/components/base/infinite-scroll-sentinel'
import { STEP_BY_STEP_TOUR_TARGETS } from '@/app/components/step-by-step-tour/target-registry'
import { systemFeaturesQueryOptions } from '@/features/system-features/client'
import { consoleQuery } from '@/service/console'
import { getAdjacentFocusTargets } from '@/utils/get-adjacent-focus-targets'
import { AppCard } from './app-card'
import { AppCardSkeleton } from './app-card-skeleton'
import { APP_LIST_GRID_CLASS_NAME } from './constants'
import Empty from './empty'
import FirstEmptyState from './first-empty-state'
import { useAppListTour } from './hooks/use-app-list-tour'
import { useWorkflowOnlineUsers } from './hooks/use-workflow-online-users'
import { ALL_APPS_HEADING_ID, AppListSectionHeading, StarredAppList } from './starred-app-list'
const STARRED_APP_LIMIT = 100
const STEP_BY_STEP_TOUR_APP_ROW_CARD_COUNT = 4
const emptyStarredApps: AppPartial[] = []
const getPreloadDistance = (scrollContainer: Element) =>
Math.max(160, Math.min(scrollContainer.clientHeight * 0.25, 320))
type AppListQuery = NonNullable<GetAppsData['query']>
type DeleteAppDialogPayload = Pick<AppPartial, 'id' | 'name'> & {
fallbackFocus: RefObject<HTMLElement | null>
adjacentFocusTargets: HTMLElement[]
}
type AppListCatalogProps = Readonly<{
appListQuery: AppListQuery
canCreateApp: boolean
dragging: boolean
hasActiveFilters: boolean
onCreateBlank: () => void
onCreateLearnDify?: (app: RecommendedAppResponse) => void
onCreateTemplate: () => void
onImportDSL: () => void
onOpenTagManagement: () => void
onTryLearnDify?: (app: RecommendedAppResponse) => void
scrollViewportRef: RefObject<HTMLDivElement | null>
}>
type AppListCatalogContentProps = Omit<AppListCatalogProps, 'appListQuery'> &
Readonly<{
appListPages: AppPagination[]
hasNextPage: boolean
isFetchNextPageError: boolean
isError: boolean
isFetching: boolean
isFetchingNextPage: boolean
isPlaceholderData: boolean
onFetchNextPage: () => Promise<unknown>
starredApps: AppPartial[]
systemFeatures: GetSystemFeaturesResponse
isCollaborationEnabled: boolean
}>
function CatalogSkeleton() {
const { t } = useTranslation(['common'])
return (
<div className="relative grow" role="status" aria-label={t(($) => $.loading, { ns: 'common' })}>
<ul aria-hidden className={APP_LIST_GRID_CLASS_NAME}>
<AppCardSkeleton count={6} />
</ul>
</div>
)
}
function AppListCatalogContent({
appListPages,
canCreateApp,
dragging,
hasActiveFilters,
hasNextPage,
isFetchNextPageError,
isError,
isFetching,
isFetchingNextPage,
isPlaceholderData,
isCollaborationEnabled,
onCreateBlank,
onCreateLearnDify,
onCreateTemplate,
onFetchNextPage,
onImportDSL,
onOpenTagManagement,
onTryLearnDify,
starredApps,
scrollViewportRef,
systemFeatures,
}: AppListCatalogContentProps) {
const { t } = useTranslation(['app', 'common'])
const [deleteDialog] = useState(() => createAlertDialogHandle<DeleteAppDialogPayload>())
const deletion = useMutation(
consoleQuery.apps.byAppId.delete.mutationOptions({ context: { silent: true } }),
)
const openDeleteDialog = useCallback(
(app: Pick<AppPartial, 'id' | 'name'>, item: HTMLLIElement | null) =>
deleteDialog.openWithPayload({
...app,
adjacentFocusTargets: getAdjacentFocusTargets(item, (sibling) =>
sibling.querySelector<HTMLElement>(':scope > a[href], :scope > button'),
),
fallbackFocus: { current: null },
}),
[deleteDialog],
)
const apps = useMemo(() => appListPages.flatMap(({ data: pageApps }) => pageApps), [appListPages])
const workflowOnlineUserAppIds = useMemo(() => {
const appIds = new Set<string>()
apps.forEach((app) => {
if (app.mode === 'workflow' || app.mode === 'advanced-chat') appIds.add(app.id)
})
return Array.from(appIds)
}, [apps])
const { onlineUsersMap: workflowOnlineUsersMap } = useWorkflowOnlineUsers({
appIds: workflowOnlineUserAppIds,
enabled: isCollaborationEnabled,
})
const hasResolvedFirstPage = appListPages.length > 0
const hasAnyApp = (appListPages[0]?.total ?? 0) > 0
const emptyMessage = t(($) => $['filterEmpty.noApps'], { ns: 'app' })
const resultStatusMessage =
!isError && !isPlaceholderData && hasResolvedFirstPage && !hasAnyApp ? emptyMessage : ''
const showFirstEmptyState =
!isPlaceholderData && !hasAnyApp && canCreateApp && hasResolvedFirstPage && !hasActiveFilters
const showNoCreateEmptyState =
!isPlaceholderData && !hasAnyApp && !canCreateApp && hasResolvedFirstPage && !hasActiveFilters
const { shouldHighlightAllAppsRow, shouldHighlightStarredAppRow, shouldOpenFirstAppActionMenu } =
useAppListTour({
canCreateApp,
hasAnyApp,
hasResolvedFirstPage,
hasStarredApps: starredApps.length > 0,
showFirstEmptyState,
showNoCreateEmptyState,
})
return (
<>
<span className="sr-only" role="status">
{resultStatusMessage}
</span>
{showFirstEmptyState ? (
<FirstEmptyState
onCreateBlank={onCreateBlank}
onCreateLearnDify={onCreateLearnDify}
onCreateTemplate={onCreateTemplate}
onImportDSL={onImportDSL}
onTryLearnDify={onTryLearnDify}
showLearnDify={systemFeatures.enable_learn_app}
/>
) : (
<>
{starredApps.length > 0 && (
<StarredAppList
apps={starredApps}
onDelete={openDeleteDialog}
stepByStepTourCardTarget={
shouldHighlightStarredAppRow
? STEP_BY_STEP_TOUR_TARGETS.studioNoCreateFirstAppCard
: undefined
}
stepByStepTourCardHighlightPart={
shouldHighlightStarredAppRow
? STEP_BY_STEP_TOUR_TARGETS.studioNoCreateFirstAppRowCard
: undefined
}
stepByStepTourHighlightedCardCount={
shouldHighlightStarredAppRow ? STEP_BY_STEP_TOUR_APP_ROW_CARD_COUNT : 0
}
/>
)}
{starredApps.length > 0 && (
<AppListSectionHeading
id={ALL_APPS_HEADING_ID}
label={t(($) => $['studio.allApps'], { ns: 'app' })}
/>
)}
<div
aria-busy={isFetching}
className={cn('relative grow', !hasAnyApp && 'overflow-hidden')}
>
{hasAnyApp ? (
<ul
// Safari list semantics: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/list-style#accessibility
// oxlint-disable-next-line jsx-a11y/no-redundant-roles -- Dify's preflight removes list markers.
role="list"
aria-label={
starredApps.length === 0
? t(($) => $['studio.allApps'], { ns: 'app' })
: undefined
}
aria-labelledby={starredApps.length > 0 ? ALL_APPS_HEADING_ID : undefined}
className={APP_LIST_GRID_CLASS_NAME}
>
{apps.map((app, index) => (
<AppCard
key={app.id}
app={app}
onDelete={(item) => openDeleteDialog(app, item)}
onlineUsers={workflowOnlineUsersMap[app.id]}
onOpenTagManagement={onOpenTagManagement}
stepByStepTourActionMenuOpen={
index === 0 ? shouldOpenFirstAppActionMenu : undefined
}
stepByStepTourCardTarget={
index === 0
? shouldHighlightAllAppsRow
? STEP_BY_STEP_TOUR_TARGETS.studioNoCreateFirstAppCard
: canCreateApp
? STEP_BY_STEP_TOUR_TARGETS.studioWithAppsFirstAppCard
: undefined
: undefined
}
stepByStepTourCardHighlightPart={
index < STEP_BY_STEP_TOUR_APP_ROW_CARD_COUNT && shouldHighlightAllAppsRow
? STEP_BY_STEP_TOUR_TARGETS.studioNoCreateFirstAppRowCard
: undefined
}
stepByStepTourActionMenuHighlightPart={
index === 0 && shouldOpenFirstAppActionMenu
? STEP_BY_STEP_TOUR_TARGETS.studioWithAppsFirstAppCardActionsMenu
: undefined
}
/>
))}
{hasNextPage && <AppCardSkeleton count={3} />}
</ul>
) : (
<div className={`content-start ${APP_LIST_GRID_CLASS_NAME}`}>
<Empty
message={emptyMessage}
stepByStepTourTarget={
showNoCreateEmptyState
? STEP_BY_STEP_TOUR_TARGETS.studioNoCreateEmpty
: undefined
}
/>
</div>
)}
{hasNextPage && (
<>
{isFetchNextPageError && (
<div
className="absolute inset-x-0 bottom-0 flex h-40 items-center justify-center gap-2 bg-background-body system-xs-regular text-text-tertiary"
role="alert"
>
<span>{t(($) => $['errorBoundary.title'], { ns: 'common' })}</span>
<Button
loading={isFetchingNextPage}
size="small"
variant="secondary"
onClick={() => void onFetchNextPage()}
>
{t(($) => $['operation.retry'], { ns: 'common' })}
</Button>
</div>
)}
<InfiniteScrollSentinel
canLoadMore={!isFetching && !isFetchNextPageError}
className="absolute inset-x-0 bottom-0"
onLoadMore={() => {
void onFetchNextPage()
}}
preloadDistance={getPreloadDistance}
scrollContainerRef={scrollViewportRef}
/>
</>
)}
</div>
</>
)}
{canCreateApp && !showFirstEmptyState && (
<div
className={`flex items-center justify-center gap-2 py-4 ${dragging ? 'text-text-accent' : 'text-text-quaternary'}`}
>
<span className="i-ri-drag-drop-line size-4" />
<span className="system-xs-regular">
{t(($) => $['newApp.dropDSLToCreateApp'], { ns: 'app' })}
</span>
</div>
)}
<AlertDialog
handle={deleteDialog}
onOpenChange={(open, details) => {
if (!open && deletion.isPending && details.reason !== 'imperative-action')
details.cancel()
}}
onOpenChangeComplete={(open) => {
if (!open) deletion.reset()
}}
>
{({ payload }) => (
<AlertDialogContent
finalFocus={() => {
const fallback = payload?.fallbackFocus.current
if (!fallback) return true
const target =
payload.adjacentFocusTargets.find((element) => element.isConnected) ?? fallback
target.focus({ preventScroll: true })
return false
}}
>
{payload && (
<DeleteAppForm
appName={payload.name}
isPending={deletion.isPending}
error={
deletion.isError
? `${t(($) => $.appDeleteFailed, { ns: 'app' })}: ${deletion.error.message}`
: undefined
}
onSubmit={() => {
if (deletion.isPending) return
deletion.mutate(
{ params: { app_id: payload.id } },
{
onSuccess: () => {
payload.fallbackFocus.current = scrollViewportRef.current
deleteDialog.close()
},
},
)
}}
/>
)}
</AlertDialogContent>
)}
</AlertDialog>
</>
)
}
export function AppListCatalog(props: AppListCatalogProps) {
const {
appListQuery,
canCreateApp,
dragging,
hasActiveFilters,
onCreateBlank,
onCreateLearnDify,
onCreateTemplate,
onImportDSL,
onOpenTagManagement,
onTryLearnDify,
scrollViewportRef,
} = props
const { data: systemFeatures } = useSuspenseQuery(systemFeaturesQueryOptions())
const { data: isCollaborationEnabled = false } = useQuery(
consoleQuery.features.get.queryOptions({
retry: false,
select: (features) => features.workflow_collaboration_enabled,
}),
)
const appList = useInfiniteQuery(
consoleQuery.apps.get.infiniteOptions({
input: (pageParam) => ({
query: {
...appListQuery,
page: Number(pageParam),
},
}),
getNextPageParam: (lastPage) => (lastPage.has_more ? lastPage.page + 1 : undefined),
initialPageParam: 1,
placeholderData: keepPreviousData,
refetchInterval: isCollaborationEnabled ? 10000 : false,
}),
)
const starredAppList = useQuery(
consoleQuery.apps.starred.get.queryOptions({
input: {
query: {
...appListQuery,
page: 1,
limit: STARRED_APP_LIMIT,
},
},
placeholderData: keepPreviousData,
}),
)
if (appList.data === undefined && appList.error) throw appList.error
if (appList.data === undefined || (starredAppList.data === undefined && !starredAppList.error))
return <CatalogSkeleton />
return (
<AppListCatalogContent
appListPages={appList.data.pages}
canCreateApp={canCreateApp}
dragging={dragging}
hasActiveFilters={hasActiveFilters}
hasNextPage={appList.hasNextPage}
isFetchNextPageError={appList.isFetchNextPageError}
isError={appList.isError}
isFetching={appList.isFetching}
isFetchingNextPage={appList.isFetchingNextPage}
isPlaceholderData={appList.isPlaceholderData}
isCollaborationEnabled={isCollaborationEnabled}
onCreateBlank={onCreateBlank}
onCreateLearnDify={onCreateLearnDify}
onCreateTemplate={onCreateTemplate}
onFetchNextPage={() => appList.fetchNextPage({ cancelRefetch: false })}
onImportDSL={onImportDSL}
onOpenTagManagement={onOpenTagManagement}
onTryLearnDify={onTryLearnDify}
scrollViewportRef={scrollViewportRef}
starredApps={starredAppList.data?.data ?? emptyStarredApps}
systemFeatures={systemFeatures}
/>
)
}