Developer Guides
How to Add an In-App AI Assistant to a React App
A source-backed React integration guide using the current Aven Web SDK’s explicit registration model.
Published Aug 17, 2026 · Aven Team
The practical problem
Install the Web SDK, initialize it with your own app credentials, and keep credentials out of source control. Teams should begin with a narrow and observable task, describe the user goal and product state, then test the supported next step with real permissions, loading states, and interruptions. This keeps guidance useful without making unsupported assumptions about the interface.
How to approach it
Register pages, elements, and workflows deliberately; the alpha SDK does not discover routes or DOM targets automatically. Teams should begin with a narrow and observable task, describe the user goal and product state, then test the supported next step with real permissions, loading states, and interruptions. This keeps guidance useful without making unsupported assumptions about the interface.
Implementation considerations
Use the host router in the navigation callback and update the current page as routes change. Teams should begin with a narrow and observable task, describe the user goal and product state, then test the supported next step with real permissions, loading states, and interruptions. This keeps guidance useful without making unsupported assumptions about the interface.
Tradeoffs to keep in view
Install the Web SDK, initialize it with your own app credentials, and keep credentials out of source control. Teams should begin with a narrow and observable task, describe the user goal and product state, then test the supported next step with real permissions, loading states, and interruptions. This keeps guidance useful without making unsupported assumptions about the interface.
Where Aven fits
Register pages, elements, and workflows deliberately; the alpha SDK does not discover routes or DOM targets automatically. Teams should begin with a narrow and observable task, describe the user goal and product state, then test the supported next step with real permissions, loading states, and interruptions. This keeps guidance useful without making unsupported assumptions about the interface.
Build this with Aven
Aven uses developer-registered pages, elements, and workflows. The host application owns navigation, target readiness, and completion.