Getting Started
react-actions-chat gives you a chat UI plus structured message parts for building guided support flows.
Install
bash
npm install react-actions-chatOptional companion packages:
react-actions-chat-recommended-actionsfor query-driven and vector-search-backed next-step suggestionsreact-actions-chat-supportfor reusable customer/admin support-desk flowsreact-actions-chat-llmsfor backend-routed text generation helpers
Import the bundled styles anywhere you mount the chat:
tsx
import 'react-actions-chat/styles';First Chat
tsx
import { Chat, createTextPart } from 'react-actions-chat';
import 'react-actions-chat/styles';
export function App() {
return (
<Chat
theme='dark'
allowFreeTextInput
initialMessages={[
{
type: 'other',
parts: [createTextPart('Hello! How can I help you today?')],
},
]}
/>
);
}initialMessages seeds the conversation when the component first mounts. Each message uses structured parts, and each message belongs to either the local user (self) or the assistant side (other).
Chat disables the shared input by default so guided request-input flows can take control when needed. Set allowFreeTextInput for open-ended bots, or attach input-request buttons when you want the assistant to decide when typing is allowed.