Skip to content

docs(ui-kit/react): Customization Architecture guide (DataSource decorator chain)#394

Open
swapnil-cometchat wants to merge 1 commit into
mainfrom
docs/uikit-customization-architecture
Open

docs(ui-kit/react): Customization Architecture guide (DataSource decorator chain)#394
swapnil-cometchat wants to merge 1 commit into
mainfrom
docs/uikit-customization-architecture

Conversation

@swapnil-cometchat

Copy link
Copy Markdown
Contributor

What

Adds a new advanced-customization guide to the React UI Kit > Guides section: Customization Architecture: the DataSource Decorator Chain.

It explains the mental model behind UI Kit customization:

  • The DataSource decorator chain (MessagesDataSourceDataSourceDecoratorChatConfigurator) and why you append, not replace.
  • The category_type template map that renders each message into a bubble (the custom-message contract).
  • The event bus (cc* UI-Kit-emitted vs on* SDK pass-through) that decouples the components.
  • The four 'stitch layers' that turn discrete components into a working chat surface.
  • A cross-platform table mapping the same concept to React Native / Angular / Flutter / Android / iOS.

Why

The decorator chain is the single most load-bearing concept for advanced customization, and the #1 source of 'my defaults disappeared' confusion (replacing instead of merging). This page gives developers the model in one place.

Notes

  • Detail is grounded in the React v6 UI Kit (file paths/symbol names verified against the cometchat-uikit-react source).
  • Added to the React > Guides group in docs.json; docs.json re-validated as JSON.
  • Uses standard Mintlify components (<Note>/<Warning>/<Tip>); all code-ish <>/{} are inside code fences/spans.

🤖 Generated with Claude Code

…decorator chain)

New advanced-customization explainer for the React UI Kit: the DataSource decorator
chain (why append-not-replace), the category_type template map, and the event bus that
stitches components together — the four 'stitch layers' of a working chat surface, plus
a cross-platform mechanism table. Added to the React > Guides nav group.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 13, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cometchat 🟢 Ready View Preview Jun 13, 2026, 1:07 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant