@aparte/react

The React AI chat component of aparté — an ergonomic <AparteChat> (React 18/19) plus hooks (useAparteChat, useAparteClient, useConversationManager) over the framework-agnostic web components in @aparte/core.

Tested in CI with React 19, and in a Next 15 App Router page rendered on the server and hydrated with no mismatch. <AparteToolUI name="…"> draws a tool call with your own component, with your app's context.

npm install @aparte/react @aparte/core react react-dom

import { AparteChat, useAparteChat } from '@aparte/react';
import '@aparte/core/styles.css';

function Chat() {
  const chat = useAparteChat();
  return (
    <AparteChat
      ref={chat.ref}
      messages={chat.messages}
      onMessagesChange={chat.setMessages}
    />
  );
}

The user's message is appended automatically on send — don't add it yourself. onMessageSent is optional and only for side-effects (scroll, analytics).

@aparte/core, react and react-dom are peer dependencies.

Every <aparte-*> tag is a typed JSX intrinsic — real attributes, checked by the compiler, no registration. <AparteUi name="my-widget" /> remains for an element aparté does not define.

ESM-only. See the docs for the full API. Part of the aparté monorepo.