gentiq 0.7.31 → 0.8.0

package/README.md

@@ -214,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