feat(ui): page title & favicon customization (#767)

Author: dazy-ds

examples/chat/chat.py

@@ -29,7 +29,7 @@
 from ragbits.chat.interface import ChatInterface
 from ragbits.chat.interface.forms import FeedbackConfig, UserSettings
 from ragbits.chat.interface.types import ChatContext, ChatResponse, LiveUpdateType, Message
-from ragbits.chat.interface.ui_customization import HeaderCustomization, UICustomization
+from ragbits.chat.interface.ui_customization import HeaderCustomization, PageMetaCustomization, UICustomization
 from ragbits.core.llms import LiteLLM
 
 
@@ -84,6 +84,7 @@ class MyChat(ChatInterface):
             "You can ask me **anything**! "
             "I can provide information, answer questions, and assist you with various tasks."
         ),
+        meta=PageMetaCustomization(favicon="🔨", page_title="Change me!"),
     )
 
     conversation_history = True

packages/ragbits-chat/CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Unreleased
 
 - Autogenerate typescript types based on backend typing (#727)
+- Add ability to customize favicon and page title (#766)
 
 ## 1.2.1 (2025-08-04)
 

packages/ragbits-chat/src/ragbits/chat/interface/ui_customization.py

@@ -19,6 +19,29 @@ class HeaderCustomization(BaseModel):
     """Custom logo URL or content. The logo can also be served from 'static' directory inside 'ui-buid"""
 
 
+class PageMetaCustomization(BaseModel):
+    """
+    Customization for the meta properites of the UI
+    """
+
+    favicon: str | None = Field(
+        default=None,
+        description=(
+            "Custom favicon URL or content. If `None` logo is used."
+            "The favicon can also be serverd from 'static' directory inside 'ui-build'"
+        ),
+    )
+    (
+        "Custom favicon URL or content. If `None` logo is used."
+        "The favicon can also be serverd from 'static' directory inside 'ui-build'"
+    )
+    page_title: str | None = Field(
+        default=None,
+        description="Custom title for the page displayed in the browser's bar. If `None` header title is used.",
+    )
+    "Custom title for the page displayed in the browser's bar. If `None` header title is used."
+
+
 class UICustomization(BaseModel):
     """
     Customization for the UI.
@@ -30,3 +53,4 @@ class UICustomization(BaseModel):
         default=None, description="Custom welcome message to be displayed on the UI. It supports Markdown."
     )
     """Custom welcome message to be displayed on the UI. It supports Markdown."""
+    meta: PageMetaCustomization | None = Field(default=None, description="Custom meta properties customization")

packages/ragbits-chat/src/ragbits/chat/providers/model_provider.py

@@ -57,7 +57,11 @@ def get_models(self) -> dict[str, type[BaseModel | Enum]]:
                 Reference,
                 StateUpdate,
             )
-            from ragbits.chat.interface.ui_customization import HeaderCustomization, UICustomization
+            from ragbits.chat.interface.ui_customization import (
+                HeaderCustomization,
+                PageMetaCustomization,
+                UICustomization,
+            )
 
             self._models_cache = {
                 # Enums
@@ -77,6 +81,7 @@ def get_models(self) -> dict[str, type[BaseModel | Enum]]:
                 # Configuration models
                 "HeaderCustomization": HeaderCustomization,
                 "UICustomization": UICustomization,
+                "PageMetaCustomization": PageMetaCustomization,
                 "UserSettings": UserSettings,
                 "FeedbackConfig": FeedbackConfig,  # Current from types.py (not deprecated forms.py)
                 # API response models