@assemble-inc/chat-widget 0.1.4 → 0.1.6

package/README.md

@@ -48,14 +48,13 @@ The widget renders as a fixed floating button in the bottom-right corner (config
 
 ### 2. Add the server-side handler
 
+The simplest setup is to mount the handler **on your existing app server** so that the widget's default `endpoint: '/api/chat'` resolves correctly:
+
 ```ts
-// server.ts
-import express from "express";
+// your existing Express/Next/etc. server
 import { createChatHandler } from "@assemble-inc/chat-widget/server";
 
-const app = express();
 app.use(express.json());
-
 app.post(
   "/api/chat",
   createChatHandler({
@@ -64,8 +63,24 @@ app.post(
     mcpBearerToken: process.env.MCP_BEARER_TOKEN,
   }),
 );
+```
+
+If you prefer to run a **separate API server** (e.g. on port 3006), you must tell the widget where to find it — otherwise it will POST to your frontend server and get a 404:
+
+```tsx
+// Pass the full URL when the API server is on a different port
+<Widget config={{ endpoint: "http://localhost:3006/api/chat" }} />
+```
+
+Or proxy `/api` to the API server in your frontend dev config (Vite example):
 
-app.listen(3006);
+```ts
+// vite.config.ts
+server: {
+  proxy: {
+    "/api": "http://localhost:3006",
+  },
+},
 ```
 
 ### 3. Environment variables