From eaa7fd8bc320bc23a0939f23b94caa9f38e428e8 Mon Sep 17 00:00:00 2001
From: ajnart <thomas@ajnart.fr>
Date: Mon, 3 Aug 2026 17:25:14 +0200
Subject: [PATCH] clarify future Homarr provider

---
 apps/docs/docs/management/assistant.mdx       |  6 ++--
 .../_components/assistant-configuration.tsx   | 29 ++++++++++++-------
 packages/translation/src/lang/en.json         |  2 +-
 3 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/apps/docs/docs/management/assistant.mdx b/apps/docs/docs/management/assistant.mdx
index d880bca8d..ca1918232 100644
--- a/apps/docs/docs/management/assistant.mdx
+++ b/apps/docs/docs/management/assistant.mdx
@@ -41,9 +41,9 @@ Homarr includes presets for OpenRouter, OpenAI, Anthropic Claude, Google Gemini,
 DeepSeek, Together AI, Ollama, and LM Studio. Provider icons make the presets easy to identify. A custom
 preset connects any other service that implements the OpenAI Chat Completions API.
 
-The provider list also shows **Homarr — Coming soon** as a disabled option. It reserves a clear place for
-Homarr's future managed assistant service without making an unavailable backend selectable or changing
-the server-side provider configuration today.
+The provider list also shows **Homarr — Coming soon** as a disabled option. The future service will be a
+Homarr-hosted OpenRouter proxy with the same model discovery, tool-calling, and server-tool features. Keeping
+it visible reserves a clear place for that service without making an unavailable backend selectable today.
 
 The management page presents setup as three compact sections: provider and endpoint, credentials, then
 model and availability. A status summary at the top shows whether the connection is ready, whether a key
diff --git a/apps/nextjs/src/app/[locale]/manage/assistant/_components/assistant-configuration.tsx b/apps/nextjs/src/app/[locale]/manage/assistant/_components/assistant-configuration.tsx
index e9fe5a983..8f8c538b4 100644
--- a/apps/nextjs/src/app/[locale]/manage/assistant/_components/assistant-configuration.tsx
+++ b/apps/nextjs/src/app/[locale]/manage/assistant/_components/assistant-configuration.tsx
@@ -473,16 +473,25 @@ export const AssistantConfiguration = () => {
               allowDeselect={false}
               leftSection={<ProviderIcon providerId={provider} />}
               renderOption={({ option }) => (
-                <Group gap="sm" wrap="nowrap" justify="space-between" w="100%">
-                  <Group gap="sm" wrap="nowrap">
-                    <ProviderIcon providerId={option.value as AssistantProviderOption} />
-                    <Text size="sm">{option.label}</Text>
-                  </Group>
-                  {option.value === "homarr" && (
-                    <Badge size="xs" variant="light" color="gray">
-                      {t("provider.comingSoon")}
-                    </Badge>
-                  )}
+                <Group gap="sm" wrap="nowrap" align={option.value === "homarr" ? "flex-start" : "center"} w="100%">
+                  <ProviderIcon providerId={option.value as AssistantProviderOption} />
+                  <Box flex={1} miw={0}>
+                    <Group gap="xs" wrap="nowrap" justify="space-between">
+                      <Text size="sm" truncate>
+                        {option.label}
+                      </Text>
+                      {option.value === "homarr" && (
+                        <Badge size="xs" variant="light" color="gray" flex="0 0 auto">
+                          {t("provider.comingSoon")}
+                        </Badge>
+                      )}
+                    </Group>
+                    {option.value === "homarr" && (
+                      <Text size="xs" c="dimmed" lineClamp={2} maw="46ch">
+                        {t("provider.options.homarr.description")}
+                      </Text>
+                    )}
+                  </Box>
                 </Group>
               )}
             />
diff --git a/packages/translation/src/lang/en.json b/packages/translation/src/lang/en.json
index 3375862cb..3fd8b8859 100644
--- a/packages/translation/src/lang/en.json
+++ b/packages/translation/src/lang/en.json
@@ -5203,7 +5203,7 @@
               "options": {
                 "homarr": {
                   "label": "Homarr",
-                  "description": "Homarr's managed assistant provider. Backend availability will be added in a future release."
+                  "description": "A Homarr-hosted OpenRouter proxy with the same model discovery, tool, and web search features. Available in a future release."
                 },
                 "openrouter": {
                   "label": "OpenRouter",