gentiq 0.7.30 → 0.7.32

package/README.md

@@ -150,6 +150,7 @@ Support multiple languages (including RTL) and customize your brand's unique loo
 ```tsx
 <GentiqProvider
   theme={{
+    defaultTheme: 'system',
     accent: '#6366f1',
     radius: 20,
     typography: {
@@ -170,6 +171,11 @@ Support multiple languages (including RTL) and customize your brand's unique loo
 </GentiqProvider>
 ```
 
+`defaultTheme` accepts `system`, `light`, or `dark`. Appearance preferences are
+resolved in this order: the user's saved preference, the defaults configured in
+the admin settings page, the `theme` values passed to `GentiqProvider`, and
+finally Gentiq's built-in defaults.
+
 ---
 
 ## 👥 Custom User Metadata Fields
@@ -208,6 +214,51 @@ Easily extend user profiles and signup forms with your own fields. Gentiq handle
 </GentiqProvider>
 ```
 
+## Personalized Greetings
+
+Use a functional greeting to personalize the built-in welcome screen. Gentiq
+loads and caches the authenticated profile for you:
+
+```tsx
+<GentiqProvider
+  welcome={{
+    greeting: ({ firstName, t }) =>
+      t(firstName ? 'chat:welcome.named' : 'chat:welcome.default', {
+        firstName,
+      }),
+  }}
+  i18n={{
+    resources: {
+      en: {
+        chat: {
+          welcome: {
+            default: 'How can I help you today?',
+            named: 'Hi {{firstName}}, how can I help you today?',
+          },
+        },
+      },
+    },
+  }}
+>
+  <ChatUI />
+</GentiqProvider>
+```
+
+For custom screens or other components, use the same profile data directly:
+
+```tsx
+import { useGentiqUser } from 'gentiq';
+
+function MyWelcomeScreen() {
+  const { user, firstName, isLoading, error } = useGentiqUser();
+
+  if (isLoading) return null;
+  if (error) return <h1>Welcome!</h1>;
+
+  return <h1>Welcome, {firstName || user?.phone}!</h1>;
+}
+```
+
 ---
 
 ## 📄 License