From f357eb4da6eb2be3a8e3ac4a01a5949ec7ab02dd 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 ++++++++++++-------
 2 files changed, 22 insertions(+), 13 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>
               )}
             />