Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cometchat-22654f5b-react-uikit-v7.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

FieldValue
Override scope.cometchat (global) or .cometchat-{component} (per-component)
Key token--cometchat-primary-color — brand/accent color
Light themeDefined in :root, [data-theme='light']
Dark themeDefined in [data-theme='dark']
Importimport "@cometchat/chat-uikit-react/styles";

Overview

All colors in the UI Kit are defined as CSS custom properties. Override them to match your brand. Variables cascade — set on .cometchat to affect everything, or on a specific component class to scope the change.
src/cometchat-overrides.css
.cometchat {
  --cometchat-primary-color: #e91e63;
}

Primary Colors

The primary color and its extended scale (50 = lightest, 900 = darkest).
TokenLightDark
--cometchat-primary-color#6852d6#6852d6
--cometchat-extended-primary-color-50#f5f2ff#15102b
--cometchat-extended-primary-color-100#ebe5ff#1d173c
--cometchat-extended-primary-color-200#d6ccff#251e4d
--cometchat-extended-primary-color-300#c2b2ff#2e245e
--cometchat-extended-primary-color-400#ad99ff#362b6f
--cometchat-extended-primary-color-500#997fff#3e3180
--cometchat-extended-primary-color-600#8566ff#473892
--cometchat-extended-primary-color-700#704cff#4f3ea3
--cometchat-extended-primary-color-800#5c33ff#5745b4
--cometchat-extended-primary-color-900#4719ff#7460d9

Neutral Colors

Gray scale used for backgrounds, borders, and text.
TokenLightDark
--cometchat-neutral-color-50#ffffff#141414
--cometchat-neutral-color-100#fafafa#1a1a1a
--cometchat-neutral-color-200#f5f5f5#272727
--cometchat-neutral-color-300#e8e8e8#383838
--cometchat-neutral-color-400#c4c4c4#4c4c4c
--cometchat-neutral-color-500#a1a1a1#858585
--cometchat-neutral-color-600#727272#989898
--cometchat-neutral-color-700#565656#a8a8a8
--cometchat-neutral-color-800#333333#c8c8c8
--cometchat-neutral-color-900#141414#ffffff

Alert Colors

TokenLightDarkPurpose
--cometchat-info-color#0f73d6#0d66bfInformational
--cometchat-warning-color#ffab00#d08d04Warning / mentions
--cometchat-success-color#09b26b#0b9f5dSuccess
--cometchat-error-color#f44649#c73c3eError / danger
--cometchat-message-seen-color#56e8a7#56e8a7Read receipts

Semantic Colors

These reference the neutral/primary scales and change automatically with the theme.

Backgrounds

TokenMaps to
--cometchat-background-color-01neutral-color-50 (base)
--cometchat-background-color-02neutral-color-100 (surface)
--cometchat-background-color-03neutral-color-200 (elevated)
--cometchat-background-color-04neutral-color-300 (highest)

Borders

TokenMaps to
--cometchat-border-color-lightneutral-color-200
--cometchat-border-color-defaultneutral-color-300
--cometchat-border-color-darkneutral-color-400
--cometchat-border-color-highlightprimary-color

Text

TokenMaps to
--cometchat-text-color-primaryneutral-color-900
--cometchat-text-color-secondaryneutral-color-600
--cometchat-text-color-tertiaryneutral-color-500
--cometchat-text-color-disabledneutral-color-400
--cometchat-text-color-whiteneutral-color-50
--cometchat-text-color-highlightprimary-color

Icons

TokenMaps to
--cometchat-icon-color-primaryneutral-color-900
--cometchat-icon-color-secondaryneutral-color-500
--cometchat-icon-color-tertiaryneutral-color-400
--cometchat-icon-color-whiteneutral-color-50
--cometchat-icon-color-highlightprimary-color

Buttons

TokenLightDark
--cometchat-primary-button-backgroundprimary-colorprimary-color
--cometchat-primary-button-textstatic-whitestatic-white
--cometchat-primary-button-iconstatic-whitestatic-white
--cometchat-secondary-button-backgroundneutral-color-900neutral-color-900
--cometchat-secondary-button-textneutral-color-900neutral-color-900
--cometchat-fab-button-backgroundprimary-colorprimary-color
--cometchat-link-buttoninfo-colorinfo-color

Example: Brand Color Override

src/cometchat-overrides.css
/* Change the primary brand color globally — target .cometchat (the root wrapper) */
.cometchat {
  --cometchat-primary-color: #e91e63;
  --cometchat-extended-primary-color-500: #e91e63;
  --cometchat-extended-primary-color-600: #d81b60;
  --cometchat-extended-primary-color-700: #c2185b;
}

Example: Dark Mode Override

[data-theme="dark"] {
  --cometchat-primary-color: #bb86fc;
  --cometchat-background-color-01: #121212;
  --cometchat-background-color-02: #1e1e1e;
}
Always target .cometchat or [data-theme="..."] for global overrides. For per-component overrides, use the component’s BEM class name directly (e.g., .cometchat-conversations). See Theming for details.