Skip to content

Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active

✨ feat: Surface Model Spec Branding on Landing and Selector (#13662)

Danny Avila470be2395fb8
diff --git a/client/src/components/Chat/Landing.tsx b/client/src/components/Chat/Landing.tsx
index 7707fe7066..d3a3d3c8b1 100644
--- a/client/src/components/Chat/Landing.tsx
+++ b/client/src/components/Chat/Landing.tsx
@@ -2,11 +2,18 @@ import { useMemo, useCallback, useState, useEffect, useRef } from 'react';
import { easings } from '@react-spring/web';
import { EModelEndpoint } from 'librechat-data-provider';
import { BirthdayIcon, TooltipAnchor, SplitText } from '@librechat/client';
+import {
+ getIconEndpoint,
+ getEntity,
+ getModelSpec,
+ createConfigHtmlSanitizer,
+ CONFIG_HTML_MEDIA_TAGS,
+ CONFIG_HTML_MEDIA_ATTR,
+} from '~/utils';
import { useChatContext, useAgentsMapContext, useAssistantsMapContext } from '~/Providers';
import { useGetEndpointsQuery, useGetStartupConfig } from '~/data-provider';
import ConvoIcon from '~/components/Endpoints/ConvoIcon';
import { useLocalize, useAuthContext } from '~/hooks';
-import { getIconEndpoint, getEntity } from '~/utils';
const containerClassName =
'shadow-stroke relative flex h-full items-center justify-center rounded-full bg-white dark:bg-presentation dark:text-white text-black dark:after:shadow-none ';
@@ -61,8 +68,26 @@ export default function Landing({ centerFormOnLanding }: { centerFormOnLanding:
assistant_id: conversation?.assistant_id,
});
- const name = entity?.name ?? '';
- const description = (entity?.description || conversation?.greeting) ?? '';
+ const modelSpec = useMemo(
+ () => getModelSpec({ specName: conversation?.spec, startupConfig }),
+ [conversation?.spec, startupConfig],
+ );
+
+ const brandedSpecLabel = modelSpec?.showOnLanding ? modelSpec.label : '';
+ const brandedSpecDescription = (modelSpec?.showOnLanding && modelSpec.description) || '';
+ const name = entity?.name ?? brandedSpecLabel;
+ const description =
+ (entity?.description || brandedSpecDescription || conversation?.greeting) ?? '';
+ const descriptionIsHTML = description.trim().startsWith('<');
+
+ const sanitizeDescription = useMemo(
+ () =>
+ createConfigHtmlSanitizer({
+ allowedTags: CONFIG_HTML_MEDIA_TAGS,
+ allowedAttr: CONFIG_HTML_MEDIA_ATTR,
+ }),
+ [],
+ );
const getGreeting = useCallback(() => {
if (typeof startupConfig?.interface?.customWelcome === 'string') {
@@ -198,11 +223,17 @@ export default function Landing({ centerFormOnLanding }: { centerFormOnLanding:
/>
)}
</div>
- {description && (
- <div className="animate-fadeIn mt-4 max-w-md text-center text-sm font-normal text-text-primary">
- {description}
- </div>
- )}
+ {description &&
+ (descriptionIsHTML ? (
+ <div
+ className="animate-fadeIn mt-4 flex max-w-md items-center justify-center gap-2 text-center text-sm font-normal text-text-primary [&_img]:inline-block [&_img]:h-4 [&_img]:w-4"
+ dangerouslySetInnerHTML={{ __html: sanitizeDescription(description) }}
+ />
+ ) : (
+ <div className="animate-fadeIn mt-4 max-w-md text-center text-sm font-normal text-text-primary">
+ {description}
+ </div>
+ ))}
</div>
</div>
);
diff --git a/client/src/components/Chat/Menus/Endpoints/components/ModelSpecItem.tsx b/client/src/components/Chat/Menus/Endpoints/components/ModelSpecItem.tsx
index a73d1d8e47..10662fa55b 100644
--- a/client/src/components/Chat/Menus/Endpoints/components/ModelSpecItem.tsx
+++ b/client/src/components/Chat/Menus/Endpoints/components/ModelSpecItem.tsx
@@ -5,6 +5,7 @@ import type { TModelSpec } from 'librechat-data-provider';
import { useFavorites, useLocalize, useIsActiveItem } from '~/hooks';
import { useModelSelectorContext } from '../ModelSelectorContext';
import { CustomMenuItem as MenuItem } from '../CustomMenu';
+import SpecDescription from './SpecDescription';
import SpecIcon from './SpecIcon';
import { cn } from '~/utils';
@@ -48,9 +49,7 @@ export function ModelSpecItem({ spec, isSelected }: ModelSpecItemProps) {
)}
<div className="flex min-w-0 flex-col gap-1">
<span className="truncate text-left">{spec.label}</span>
- {spec.description && (
- <span className="break-words text-xs font-normal">{spec.description}</span>
- )}
+ <SpecDescription description={spec.description} />
</div>
</div>
<button
diff --git a/client/src/components/Chat/Menus/Endpoints/components/SearchResults.tsx b/client/src/components/Chat/Menus/Endpoints/components/SearchResults.tsx
index 990ee8542c..a64907ff26 100644
--- a/client/src/components/Chat/Menus/Endpoints/components/SearchResults.tsx
+++ b/client/src/components/Chat/Menus/Endpoints/components/SearchResults.tsx
@@ -8,6 +8,7 @@ import MarketplaceItem, { marketplaceSearchMatches } from './Marketplace';
import { useModelSelectorContext } from '../ModelSelectorContext';
import { CustomMenuItem as MenuItem } from '../CustomMenu';
import { shouldRenderEndpointOption } from '../utils';
+import SpecDescription from './SpecDescription';
import SpecIcon from './SpecIcon';
import { cn } from '~/utils';
@@ -82,9 +83,7 @@ export function SearchResults({ results, localize, searchValue }: SearchResultsP
)}
<div className="flex min-w-0 flex-col gap-1">
<span className="truncate text-left">{spec.label}</span>
- {spec.description && (
- <span className="break-words text-xs font-normal">{spec.description}</span>
- )}
+ <SpecDescription description={spec.description} />
</div>
</div>
{selectedSpec === spec.name && (
diff --git a/client/src/components/Chat/Menus/Endpoints/components/SpecDescription.tsx b/client/src/components/Chat/Menus/Endpoints/components/SpecDescription.tsx
new file mode 100644
index 0000000000..b67395380a
--- /dev/null
+++ b/client/src/components/Chat/Menus/Endpoints/components/SpecDescription.tsx
@@ -0,0 +1,32 @@
+import { useMemo } from 'react';
+import { createConfigHtmlSanitizer, CONFIG_HTML_MEDIA_TAGS, CONFIG_HTML_MEDIA_ATTR } from '~/utils';
+
+interface SpecDescriptionProps {
+ description?: string;
+}
+
+export default function SpecDescription({ description }: SpecDescriptionProps) {
+ const sanitize = useMemo(
+ () =>
+ createConfigHtmlSanitizer({
+ allowedTags: CONFIG_HTML_MEDIA_TAGS,
+ allowedAttr: CONFIG_HTML_MEDIA_ATTR,
+ }),
+ [],
+ );
+
+ if (!description) {
+ return null;
+ }
+
+ if (!description.trim().startsWith('<')) {
+ return <span className="break-words text-xs font-normal">{description}</span>;
+ }
+
+ return (
+ <span
+ className="inline-flex items-center gap-1 break-words text-xs font-normal [&_img]:inline-block [&_img]:h-3.5 [&_img]:w-3.5"
+ dangerouslySetInnerHTML={{ __html: sanitize(description) }}
+ />
+ );
+}
diff --git a/client/src/components/Chat/Menus/Endpoints/components/__tests__/SpecDescription.spec.tsx b/client/src/components/Chat/Menus/Endpoints/components/__tests__/SpecDescription.spec.tsx
new file mode 100644
index 0000000000..524e1ff583
--- /dev/null
+++ b/client/src/components/Chat/Menus/Endpoints/components/__tests__/SpecDescription.spec.tsx
@@ -0,0 +1,39 @@
+import { render, screen } from '@testing-library/react';
+import SpecDescription from '../SpecDescription';
+
+describe('SpecDescription', () => {
+ it('renders nothing without a description', () => {
+ const { container } = render(<SpecDescription />);
+
+ expect(container).toBeEmptyDOMElement();
+ });
+
+ it('renders plain text descriptions without interpreting markup', () => {
+ render(<SpecDescription description="Fast & accurate < 1s responses" />);
+
+ expect(screen.getByText('Fast & accurate < 1s responses')).toBeInTheDocument();
+ });
+
+ it('renders HTML descriptions with inline images', () => {
+ const { container } = render(
+ <SpecDescription description='<span>Powered by <img src="/assets/claude.png" alt="Claude" /> Claude</span>' />,
+ );
+
+ const image = container.querySelector('img');
+ expect(image).toHaveAttribute('src', '/assets/claude.png');
+ expect(image).toHaveAttribute('alt', 'Claude');
+ expect(container).toHaveTextContent('Powered by Claude');
+ });
+
+ it('strips scripts, event handlers, and unsafe URLs from HTML descriptions', () => {
+ const { container } = render(
+ <SpecDescription description='<span onclick="alert(1)">Safe<script>alert(1)</script><img src="javascript:alert(1)" onerror="alert(1)"></span>' />,
+ );
+
+ expect(container).toHaveTextContent('Safe');
+ expect(container.querySelector('script')).toBeNull();
+ expect(container.querySelector('[onclick]')).toBeNull();
+ expect(container.querySelector('[onerror]')).toBeNull();
+ expect(container.querySelector('img')?.getAttribute('src') ?? '').not.toContain('javascript');
+ });
+});
diff --git a/client/src/utils/__tests__/configHtml.test.ts b/client/src/utils/__tests__/configHtml.test.ts
index 66ee2969e1..70dd242785 100644
--- a/client/src/utils/__tests__/configHtml.test.ts
+++ b/client/src/utils/__tests__/configHtml.test.ts
@@ -2,6 +2,8 @@ import {
CONFIG_HTML_BLOCK_TAGS,
CONFIG_HTML_CLASS_ATTR,
CONFIG_HTML_INLINE_TAGS,
+ CONFIG_HTML_MEDIA_ATTR,
+ CONFIG_HTML_MEDIA_TAGS,
createConfigHtmlSanitizer,
sanitizeConfigHtml,
} from '../configHtml';
@@ -43,4 +45,18 @@ describe('configHtml', () => {
'<a href="/docs" target="_blank" rel="noopener noreferrer">Docs</a> <a target="_blank" rel="noopener noreferrer">Remote</a>',
);
});
+
+ it('keeps inline images with safe sources under media tags', () => {
+ const sanitize = createConfigHtmlSanitizer({
+ allowedTags: CONFIG_HTML_MEDIA_TAGS,
+ allowedAttr: CONFIG_HTML_MEDIA_ATTR,
+ });
+ const sanitized = sanitize(
+ '<span>Powered by <img src="/assets/brand.svg" alt="Brand" onerror="alert(1)"> AI</span><img src="javascript:alert(1)">',
+ );
+
+ expect(sanitized).toBe(
+ '<span>Powered by <img src="/assets/brand.svg" alt="Brand"> AI</span><img>',
+ );
+ });
});
diff --git a/client/src/utils/configHtml.ts b/client/src/utils/configHtml.ts
index 171b8ce629..8c0cbddcd7 100644
--- a/client/src/utils/configHtml.ts
+++ b/client/src/utils/configHtml.ts
@@ -3,8 +3,10 @@ import DOMPurify from 'dompurify';
export const CONFIG_HTML_INLINE_TAGS = ['a', 'strong', 'b', 'em', 'i', 'br', 'code'] as const;
export const CONFIG_HTML_TEXT_TAGS = [...CONFIG_HTML_INLINE_TAGS, 'span'] as const;
export const CONFIG_HTML_BLOCK_TAGS = [...CONFIG_HTML_TEXT_TAGS, 'p'] as const;
+export const CONFIG_HTML_MEDIA_TAGS = [...CONFIG_HTML_TEXT_TAGS, 'img'] as const;
export const CONFIG_HTML_LINK_ATTR = ['href', 'target', 'rel'] as const;
export const CONFIG_HTML_CLASS_ATTR = [...CONFIG_HTML_LINK_ATTR, 'class'] as const;
+export const CONFIG_HTML_MEDIA_ATTR = [...CONFIG_HTML_CLASS_ATTR, 'src', 'alt'] as const;
const CONFIG_HTML_SAFE_URI =
/^(?:(?:https?|mailto|tel):|(?!(?:\s*[a-z][a-z0-9+.-]*:|\s*\/\/))[\s\S])/i;
diff --git a/e2e/config/librechat.e2e.yaml b/e2e/config/librechat.e2e.yaml
index 82f42782d2..34eeb8b074 100644
--- a/e2e/config/librechat.e2e.yaml
+++ b/e2e/config/librechat.e2e.yaml
@@ -96,3 +96,11 @@ modelSpecs:
preset:
endpoint: 'Mock Provider A'
model: 'mock-model-a'
+
+ - name: 'e2e-branded'
+ label: 'E2E Branded'
+ description: '<strong>Branded</strong> answers <img src="/assets/openai.svg" alt="brand icon">'
+ showOnLanding: true
+ preset:
+ endpoint: 'Mock Provider A'
+ model: 'mock-model-a'
diff --git a/e2e/specs/mock/model-spec-branding.spec.ts b/e2e/specs/mock/model-spec-branding.spec.ts
new file mode 100644
index 0000000000..493572cfd5
--- /dev/null
+++ b/e2e/specs/mock/model-spec-branding.spec.ts
@@ -0,0 +1,47 @@
+import { expect, test } from '@playwright/test';
+import { getPrimaryE2EUser } from '../../setup/users.mock';
+import { NEW_CHAT_PATH, selectModelSpec } from './helpers';
+
+/** Spec with `showOnLanding: true` and an HTML `description` in e2e/config/librechat.e2e.yaml. */
+const BRANDED_SPEC = {
+ label: 'E2E Branded',
+ descriptionText: 'Branded answers',
+ descriptionIcon: '/assets/openai.svg',
+};
+
+/** The `softDefault: true` spec does not set `showOnLanding`, so it is unbranded. */
+const UNBRANDED_SPEC_LABEL = 'E2E Soft Default';
+
+test.describe('model spec branding on landing', () => {
+ test('branded spec replaces the greeting with its label and rendered description', async ({
+ page,
+ }) => {
+ await page.goto(NEW_CHAT_PATH, { timeout: 10000 });
+ await selectModelSpec(page, BRANDED_SPEC.label);
+
+ const main = page.getByRole('main');
+ await expect(main).toContainText(BRANDED_SPEC.label);
+ await expect(main).toContainText(BRANDED_SPEC.descriptionText);
+ await expect(main.locator(`img[src$="${BRANDED_SPEC.descriptionIcon}"]`)).toBeVisible();
+
+ const user = getPrimaryE2EUser();
+ await expect(main).not.toContainText(user.name);
+ });
+
+ test('unbranded spec keeps the personalized greeting', async ({ page }) => {
+ await page.goto(NEW_CHAT_PATH, { timeout: 10000 });
+ await selectModelSpec(page, UNBRANDED_SPEC_LABEL);
+
+ const user = getPrimaryE2EUser();
+ await expect(page.getByRole('main')).toContainText(user.name);
+ });
+
+ test('branded spec renders its description in the model selector', async ({ page }) => {
+ await page.goto(NEW_CHAT_PATH, { timeout: 10000 });
+
+ await page.getByRole('button', { name: 'Select a model' }).first().click();
+ const option = page.getByRole('option', { name: new RegExp(BRANDED_SPEC.label) });
+ await expect(option).toContainText(BRANDED_SPEC.descriptionText);
+ await expect(option.locator(`img[src$="${BRANDED_SPEC.descriptionIcon}"]`)).toBeVisible();
+ });
+});
diff --git a/eslint.config.mjs b/eslint.config.mjs
index 636e62a6f5..800e71f69d 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -219,7 +219,10 @@ export default [
})),
{
files: ['**/*.ts', '**/*.tsx'],
- ignores: ['packages/**/*', 'client/vite.config.ts'],
+ // e2e specs are not part of `client/tsconfig.json`'s program, so typed
+ // linting them errors with "file not found in project"; they still get
+ // the non-type-checked recommended rules from the block above.
+ ignores: ['packages/**/*', 'client/vite.config.ts', 'e2e/**/*'],
plugins: {
'@typescript-eslint': typescriptEslintEslintPlugin,
jest: fixupPluginRules(jest),
diff --git a/packages/data-provider/src/models.ts b/packages/data-provider/src/models.ts
index 0bfc68e067..30c89899d2 100644
--- a/packages/data-provider/src/models.ts
+++ b/packages/data-provider/src/models.ts
@@ -33,6 +33,8 @@ export type TModelSpec = {
groupIcon?: string | EModelEndpoint;
showIconInMenu?: boolean;
showIconInHeader?: boolean;
+ /** Show this spec's label and description on the chat landing in place of the greeting. */
+ showOnLanding?: boolean;
iconURL?: string | EModelEndpoint; // Allow using project-included icons
authType?: AuthType;
/** Hide the chat input tool badge row while this model spec is active. */
@@ -64,6 +66,7 @@ export const tModelSpecSchema = z.object({
groupIcon: z.union([z.string(), eModelEndpointSchema]).optional(),
showIconInMenu: z.boolean().optional(),
showIconInHeader: z.boolean().optional(),
+ showOnLanding: z.boolean().optional(),
iconURL: z.union([z.string(), eModelEndpointSchema]).optional(),
authType: authTypeSchema.optional(),
hideBadgeRow: z.boolean().optional(),