From 1a2126e3b416ce75654014c6065c5314cf3a9144 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 17:56:25 +0000 Subject: [PATCH 1/6] feat(website): make Router gallery cards clickable, move video higher Link each Comfy Router landing page gallery card that has a live Models page to it, using the same {provider}/{model} id the Router API and content pipeline already key model pages by (id.replace('/', '--')). MiniMax H3 has no Models page yet (incomplete input schema), so it stays a plain, non-clickable card. Move RouterVideoSection (and RouterCapabilitiesSection, which reuses its stills) up to right below the hero, ahead of the migration banner, proof strip, gallery and code sample. Since the video is no longer far down the page, drop `lazy-autoplay` and swap its island directive from `client:visible` to `client:idle` so it loads eagerly instead of waiting on a scroll trigger that may already be satisfied at load. --- apps/website/src/pages/platform/router.astro | 4 ++-- .../src/pages/zh-CN/platform/router.astro | 4 ++-- .../platform/ModelsApiGallery.test.ts | 20 +++++++++++++++++++ .../templates/platform/ModelsApiGallery.vue | 17 ++++++++++++---- .../platform/RouterVideoSection.test.ts | 4 +++- .../templates/platform/RouterVideoSection.vue | 1 - .../templates/platform/modelsGalleryCards.ts | 19 ++++++++++++++++++ 7 files changed, 59 insertions(+), 10 deletions(-) diff --git a/apps/website/src/pages/platform/router.astro b/apps/website/src/pages/platform/router.astro index 72d65c84a51..45ba9040c18 100644 --- a/apps/website/src/pages/platform/router.astro +++ b/apps/website/src/pages/platform/router.astro @@ -22,12 +22,12 @@ import { routerFaq, routerT } from '../../templates/platform/routerCopy' description={t('platform.products.models.description', 'en')} > + + - - + + - - { await nextTick() expect(seedanceClip()).not.toBe(firstClip) }) + + it('links a card with a model id to its Models page', () => { + render(ModelsApiGallery, { props: { locale: 'en' } }) + + expect( + screen.getByRole('link', { + name: new RegExp(t('cloud.aiModels.card.seedance25', 'en')) + }) + ).toHaveAttribute('href', '/models/byteplus--dreamina-seedance-2-5-260628/') + }) + + it('leaves a card with no Models page as a non-link', () => { + render(ModelsApiGallery, { props: { locale: 'en' } }) + + expect( + screen.queryByRole('link', { + name: t('cloud.aiModels.card.minimaxH3', 'en') + }) + ).toBeNull() + }) }) diff --git a/apps/website/src/templates/platform/ModelsApiGallery.vue b/apps/website/src/templates/platform/ModelsApiGallery.vue index 3a1ebb77cea..06a7e35db3f 100644 --- a/apps/website/src/templates/platform/ModelsApiGallery.vue +++ b/apps/website/src/templates/platform/ModelsApiGallery.vue @@ -2,10 +2,12 @@ import { useIntervalFn } from '@vueuse/core' import { ref } from 'vue' +import { cn } from '@comfyorg/tailwind-utils' + import type { Locale } from '../../i18n/translations' import { t } from '../../i18n/translations' import type { GalleryMedia, ModelsGalleryCard } from './modelsGalleryCards' -import { modelsGalleryCards } from './modelsGalleryCards' +import { modelGalleryHref, modelsGalleryCards } from './modelsGalleryCards' const { locale = 'en', cards = modelsGalleryCards } = defineProps<{ locale?: Locale @@ -30,10 +32,17 @@ const isVideo = (media: GalleryMedia) => media.src.endsWith('.webm') :aria-label="t('platform.modelsGallery.ariaLabel', locale)" >
-
media.src.endsWith('.webm') > {{ t(card.titleKey, locale) }}

-
+
diff --git a/apps/website/src/templates/platform/RouterVideoSection.test.ts b/apps/website/src/templates/platform/RouterVideoSection.test.ts index 4351054db1d..2fba6da5bdd 100644 --- a/apps/website/src/templates/platform/RouterVideoSection.test.ts +++ b/apps/website/src/templates/platform/RouterVideoSection.test.ts @@ -14,6 +14,8 @@ describe('RouterVideoSection', () => { expect(video).toBeTruthy() expect(video.hasAttribute('muted')).toBe(true) - expect(video.hasAttribute('autoplay')).toBe(false) + // The section now sits right below the hero, so it loads eagerly + // (native `autoplay`) instead of waiting on `lazy-autoplay` + scroll. + expect(video.hasAttribute('autoplay')).toBe(true) }) }) diff --git a/apps/website/src/templates/platform/RouterVideoSection.vue b/apps/website/src/templates/platform/RouterVideoSection.vue index 2d76a6140f6..e40665c0419 100644 --- a/apps/website/src/templates/platform/RouterVideoSection.vue +++ b/apps/website/src/templates/platform/RouterVideoSection.vue @@ -14,7 +14,6 @@ const { locale = 'en' } = defineProps<{ locale?: Locale }>() src="https://media.comfy.org/website/router/router-animatic-v019.mp4" poster="https://media.comfy.org/website/router/router-animatic-v019-poster.webp" autoplay - lazy-autoplay /> diff --git a/apps/website/src/templates/platform/modelsGalleryCards.ts b/apps/website/src/templates/platform/modelsGalleryCards.ts index 65cd62370c3..c0b3779aab2 100644 --- a/apps/website/src/templates/platform/modelsGalleryCards.ts +++ b/apps/website/src/templates/platform/modelsGalleryCards.ts @@ -10,6 +10,20 @@ export interface ModelsGalleryCard { titleKey: TranslationKey badgeIcon: string media: GalleryMedia[] + /** + * The Router API's `{provider}/{model}` id (the same id + * `router-providers.ts` sends to `POST /v2/models/{provider}/{model}`). + * When set, the card links to that model's `/models/[slug]` page; the + * route resolves it through the same `id.replace('/', '--')` alias the + * Router content pipeline already builds (see `workshop-browse-content.ts`). + * Omitted for a model with no Models page of its own. + */ + modelId?: string +} + +/** Builds a `/models/[slug]` href from a Router API `{provider}/{model}` id. */ +export function modelGalleryHref(modelId: string): string { + return `/models/${modelId.replace('/', '--')}/` } const SEEDANCE_BASE = 'https://media.comfy.org/website/seedance-2.5' @@ -20,6 +34,7 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ { titleKey: 'cloud.aiModels.card.seedance25', badgeIcon: '/icons/ai-models/bytedance.svg', + modelId: 'byteplus/dreamina-seedance-2-5-260628', media: [ { src: `${SEEDANCE_BASE}/city.webm`, @@ -55,11 +70,13 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ { titleKey: 'cloud.aiModels.card.nanoBananaPro', badgeIcon: '/icons/ai-models/gemini.svg', + modelId: 'vertexai/gemini-3-pro-image', media: [{ src: `${AI_MODELS_BASE}/nano-banana-pro.webp` }] }, { titleKey: 'cloud.aiModels.card.chatgptImages25', badgeIcon: '/icons/ai-models/openai.svg', + modelId: 'openai/gpt-image-2.5-flare', media: [ { src: `${AI_MODELS_BASE}/gpt-image-2.webm`, @@ -70,6 +87,7 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ { titleKey: 'cloud.aiModels.card.klingAi30', badgeIcon: '/icons/ai-models/kling.svg', + modelId: 'kling/kling-3.0-turbo', media: [ { src: 'https://media.comfy.org/website/router/kling-3-video.webp' @@ -79,6 +97,7 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ { titleKey: 'cloud.aiModels.card.flux3', badgeIcon: '/icons/ai-models/bfl.svg', + modelId: 'bfl/flux-3-video', media: [ { src: 'https://media.comfy.org/website/router/flux-3-t2v.webp' From 3ee917ebb37327160cf062cfc8bc7584dfa979cd Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 18:49:51 +0000 Subject: [PATCH 2/6] fix(website): remove unsupported MiniMax H3 card from Router gallery Router has no Models page for minimax/minimax-h3 (incompleteReason: missing-input-schema in the content pipeline), so the card is removed entirely rather than left unlinked. --- .../platform/ModelsApiGallery.test.ts | 11 ----------- .../templates/platform/modelsGalleryCards.ts | 18 ------------------ 2 files changed, 29 deletions(-) diff --git a/apps/website/src/templates/platform/ModelsApiGallery.test.ts b/apps/website/src/templates/platform/ModelsApiGallery.test.ts index 6f64d4207fc..85606de53fa 100644 --- a/apps/website/src/templates/platform/ModelsApiGallery.test.ts +++ b/apps/website/src/templates/platform/ModelsApiGallery.test.ts @@ -15,7 +15,6 @@ describe('ModelsApiGallery', () => { for (const titleKey of [ 'cloud.aiModels.card.seedance25', - 'cloud.aiModels.card.minimaxH3', 'cloud.aiModels.card.nanoBananaPro', 'cloud.aiModels.card.chatgptImages25', 'cloud.aiModels.card.klingAi30', @@ -43,14 +42,4 @@ describe('ModelsApiGallery', () => { }) ).toHaveAttribute('href', '/models/byteplus--dreamina-seedance-2-5-260628/') }) - - it('leaves a card with no Models page as a non-link', () => { - render(ModelsApiGallery, { props: { locale: 'en' } }) - - expect( - screen.queryByRole('link', { - name: t('cloud.aiModels.card.minimaxH3', 'en') - }) - ).toBeNull() - }) }) diff --git a/apps/website/src/templates/platform/modelsGalleryCards.ts b/apps/website/src/templates/platform/modelsGalleryCards.ts index c0b3779aab2..6a9989fe877 100644 --- a/apps/website/src/templates/platform/modelsGalleryCards.ts +++ b/apps/website/src/templates/platform/modelsGalleryCards.ts @@ -27,7 +27,6 @@ export function modelGalleryHref(modelId: string): string { } const SEEDANCE_BASE = 'https://media.comfy.org/website/seedance-2.5' -const MINIMAX_BASE = 'https://media.comfy.org/website/minimax' const AI_MODELS_BASE = 'https://media.comfy.org/website/cloud/ai-models' export const modelsGalleryCards: ModelsGalleryCard[] = [ @@ -50,23 +49,6 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ } ] }, - { - titleKey: 'cloud.aiModels.card.minimaxH3', - badgeIcon: '/icons/ai-models/minimax.svg', - media: [ - { - src: 'https://media.comfy.org/website/minimax-h3/hero-dragon-960.webm' - }, - { - src: `${MINIMAX_BASE}/ice-rider.webm`, - posterSrc: `${MINIMAX_BASE}/ice-rider-poster.webp` - }, - { - src: `${MINIMAX_BASE}/superhero.webm`, - posterSrc: `${MINIMAX_BASE}/superhero-poster.webp` - } - ] - }, { titleKey: 'cloud.aiModels.card.nanoBananaPro', badgeIcon: '/icons/ai-models/gemini.svg', From 622ab8770832ad2d301b62a6f64914d3ed3e1a1e Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 19:10:52 +0000 Subject: [PATCH 3/6] test(website): cover non-linked card branch in ModelsApiGallery Restores coverage for the div-vs-anchor branch in ModelsApiGallery.vue now that the MiniMax H3 card (the only real card without a modelId) has been removed from modelsGalleryCards.ts. Injects a synthetic card via the cards prop instead of relying on real gallery data. --- .../platform/ModelsApiGallery.test.ts | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/apps/website/src/templates/platform/ModelsApiGallery.test.ts b/apps/website/src/templates/platform/ModelsApiGallery.test.ts index 85606de53fa..1662219d83c 100644 --- a/apps/website/src/templates/platform/ModelsApiGallery.test.ts +++ b/apps/website/src/templates/platform/ModelsApiGallery.test.ts @@ -4,6 +4,7 @@ import { nextTick } from 'vue' import { t } from '../../i18n/translations' import ModelsApiGallery from './ModelsApiGallery.vue' +import type { ModelsGalleryCard } from './modelsGalleryCards' describe('ModelsApiGallery', () => { beforeEach(() => { @@ -42,4 +43,25 @@ describe('ModelsApiGallery', () => { }) ).toHaveAttribute('href', '/models/byteplus--dreamina-seedance-2-5-260628/') }) + + it('renders a card without a model id as a plain, non-linked div', () => { + const cards: ModelsGalleryCard[] = [ + { + titleKey: 'cloud.aiModels.card.seedance25', + badgeIcon: '/icons/ai-models/bytedance.svg', + media: [{ src: 'https://media.comfy.org/website/test.webp' }] + } + ] + + render(ModelsApiGallery, { props: { locale: 'en', cards } }) + + expect( + screen.queryByRole('link', { + name: new RegExp(t('cloud.aiModels.card.seedance25', 'en')) + }) + ).not.toBeInTheDocument() + expect( + screen.getByText(t('cloud.aiModels.card.seedance25', 'en')) + ).toBeTruthy() + }) }) From 91f961637bc7410dd5c66a1131cbf325e1698c8c Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 21:06:39 +0000 Subject: [PATCH 4/6] feat(website): add Gemini Omni 1.1 Flash card to Router gallery Adds a 6th card to the Comfy Router landing page gallery, linking to gemini/omni-1.1-flash (the animate-images use case, matching the live /models/gemini--omni-1.1-flash--animate-images/ page). Reuses the existing geminiOmniFlash title key, the gemini badge icon already used for other Google models, and the card-1 webm/webp assets already serving this model's clip on the /cli page. --- .../src/templates/platform/modelsGalleryCards.ts | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/apps/website/src/templates/platform/modelsGalleryCards.ts b/apps/website/src/templates/platform/modelsGalleryCards.ts index 6a9989fe877..4934f761a8d 100644 --- a/apps/website/src/templates/platform/modelsGalleryCards.ts +++ b/apps/website/src/templates/platform/modelsGalleryCards.ts @@ -85,5 +85,16 @@ export const modelsGalleryCards: ModelsGalleryCard[] = [ src: 'https://media.comfy.org/website/router/flux-3-t2v.webp' } ] + }, + { + titleKey: 'cloud.aiModels.card.geminiOmniFlash', + badgeIcon: '/icons/ai-models/gemini.svg', + modelId: 'gemini/omni-1.1-flash', + media: [ + { + src: 'https://media.comfy.org/website/gemini-omni/card-1.webm', + posterSrc: 'https://media.comfy.org/website/gemini-omni/card-1.webp' + } + ] } ] From b75ef24aa164da4d6f39c40bbc086e451131b4f5 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 23 Sep 2026 22:04:03 +0000 Subject: [PATCH 5/6] fix(website): link Router gallery cards to canonical model pages modelGalleryHref() built a short {provider}--{model} slug, which /models/[slug].astro resolves via a client-side redirect since this site builds statically and can't emit a real 301. Some Router model ids also have a Models page per use case (Gemini Omni 1.1 Flash has three), so the id alone can't say which one a card means. Add getRouterModelHref(modelId, useCase) to resolve a card's model id and use case directly to its canonical href, and require both fields together on ModelsGalleryCard so a linked card always names the page it points to. --- .../src/config/workshop-router-content.ts | 21 +++++++++ .../platform/ModelsApiGallery.test.ts | 17 ++++++- .../templates/platform/ModelsApiGallery.vue | 5 +- .../templates/platform/modelsGalleryCards.ts | 46 +++++++++++++------ 4 files changed, 73 insertions(+), 16 deletions(-) diff --git a/apps/website/src/config/workshop-router-content.ts b/apps/website/src/config/workshop-router-content.ts index e87f69dadf1..e1d7ef1e737 100644 --- a/apps/website/src/config/workshop-router-content.ts +++ b/apps/website/src/config/workshop-router-content.ts @@ -1,9 +1,11 @@ import type { WorkshopDisplayEntry } from '../content/workshop-display.schema' import type { GeneratedExample, + UseCase, WorkshopModel, WorkshopModelDetail } from './models-catalogue' +import { useCasesFor } from './models-catalogue' import { formForContract } from './workshop-contract' import { workshopContract } from './workshop-contract-catalog' import { workshopPromptDefaults } from './workshop-prompt-defaults' @@ -140,3 +142,22 @@ export function getRouterWorkshopModelDetail( ): WorkshopModelDetail | undefined { return detailBySlug.get(routerModelSlugAliases.get(slug) ?? slug) } + +/** + * Resolves a Router API `{provider}/{model}` id (or the legacy catalog id + * some content is filed under, when the two differ) plus its use case to + * that model's canonical `/models/[slug]` href, one hop, without going + * through the redirect a bare `{provider}/{model}` id needs when the same + * id maps to more than one use case's page. + */ +export function getRouterModelHref( + modelId: string, + useCase: UseCase +): string | undefined { + return workshopModels.find( + (model) => + useCasesFor(model).includes(useCase) && + (model.routerId === modelId || + routerContentBySlug.get(model.slug)?.entry.id === modelId) + )?.href +} diff --git a/apps/website/src/templates/platform/ModelsApiGallery.test.ts b/apps/website/src/templates/platform/ModelsApiGallery.test.ts index 1662219d83c..8e99f29ed40 100644 --- a/apps/website/src/templates/platform/ModelsApiGallery.test.ts +++ b/apps/website/src/templates/platform/ModelsApiGallery.test.ts @@ -34,14 +34,27 @@ describe('ModelsApiGallery', () => { expect(seedanceClip()).not.toBe(firstClip) }) - it('links a card with a model id to its Models page', () => { + it('links a card with a model id to its canonical Models page, not a redirecting short slug', () => { render(ModelsApiGallery, { props: { locale: 'en' } }) expect( screen.getByRole('link', { name: new RegExp(t('cloud.aiModels.card.seedance25', 'en')) }) - ).toHaveAttribute('href', '/models/byteplus--dreamina-seedance-2-5-260628/') + ).toHaveAttribute( + 'href', + '/models/byteplus--seedance-2-5-text-to-video--generate-videos/' + ) + }) + + it('links a model id shared by several use cases to the specific page the card names', () => { + render(ModelsApiGallery, { props: { locale: 'en' } }) + + expect( + screen.getByRole('link', { + name: new RegExp(t('cloud.aiModels.card.geminiOmniFlash', 'en')) + }) + ).toHaveAttribute('href', '/models/gemini--omni-1.1-flash--animate-images/') }) it('renders a card without a model id as a plain, non-linked div', () => { diff --git a/apps/website/src/templates/platform/ModelsApiGallery.vue b/apps/website/src/templates/platform/ModelsApiGallery.vue index 06a7e35db3f..d12f55f926d 100644 --- a/apps/website/src/templates/platform/ModelsApiGallery.vue +++ b/apps/website/src/templates/platform/ModelsApiGallery.vue @@ -24,6 +24,9 @@ const activeMedia = (card: ModelsGalleryCard): GalleryMedia => card.media[rotationIndex.value % card.media.length] const isVideo = (media: GalleryMedia) => media.src.endsWith('.webm') + +const hrefFor = (card: ModelsGalleryCard): string | undefined => + card.modelId ? modelGalleryHref(card.modelId, card.useCase) : undefined