Integriert CometChat in verschiedene Angular-Projektarchitekturen, einschließlich Nx Monorepos, NgModules und SSR-Umgebungen.
- GitHub Stars
- 171
- Dateien
- 1
- Letzter Commit
- 15. Okt. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der cometchat-angular-v5-patterns Skill?
Integriert CometChat in verschiedene Angular-Projektarchitekturen, einschließlich Nx Monorepos, NgModules und SSR-Umgebungen.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den cometchat-angular-v5-patterns skill
Entwickler, die Chat-Interfaces in Angular bauen, können diesen Skill nutzen, um Architektur-Probleme bei der Integration zu lösen, die durch spezifische Projektstrukturen entstehen. Er bietet Anleitung zur Konfiguration von CometChat innerhalb von Nx Monorepos, traditionellen Angular CLI Projekten, NgModule-basierten Anwendungen sowie SSR- oder Angular Universal-Umgebungen. Anstatt sich auf die Chat-API selbst zu konzentrieren, behandelt dieses Tool, wie man Environment-Dateien anbindet, Stylesheets in Nx registriert und Component-Imports verwaltet, um gängige Angular-Fehler zu vermeiden.
Wenn ein Agent diesen Skill lädt, kann er bei der Fehlerbehebung von Fehlern wie "window is not defined" helfen, indem er Browser-only-Guards mittels isPlatformBrowser implementiert. Er liefert zudem Patterns für das State Management mit RxJS oder Signals, um UI-Drift zu verhindern. Der Skill ist speziell für Projekte konzipiert, die @cometchat/chat-uikit-angular in den Versionen 5.1.0 bis 5.2.0 und Angular in den Versionen 17 bis 21 nutzen. Er stellt sicher, dass die Initialisierung korrekt während des Bootstrappings erfolgt und nicht innerhalb von lazy-loaded Chunks, was redundante Ausführungen verhindert.
Was ein agent damit machen kann
- 1Integration mit NgModulesErklärt, wie du CometChat-Komponenten zu einer Anwendung hinzufügst, die keine Standalone-Komponenten verwendet.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den cometchat-angular-v5-patterns Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den cometchat-angular-v5-patterns Skill in Plugin installieren
/plugin marketplace add cometchat/cometchat-skills /plugin install cometchat-skills@cometchat
Den cometchat-angular-v5-patterns Skill in Claude Code installieren
~/.claude/skills/cometchat-angular-v5-patterns/SKILL.md
$ npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns ~/.claude/skills/cometchat-angular-v5-patternsDen cometchat-angular-v5-patterns Skill in Claude Code (project) installieren
.claude/skills/cometchat-angular-v5-patterns/SKILL.md
$ npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns .claude/skills/cometchat-angular-v5-patternsDen cometchat-angular-v5-patterns Skill in Codex installieren
~/.agents/skills/cometchat-angular-v5-patterns/SKILL.md
$ npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns ~/.agents/skills/cometchat-angular-v5-patternsDen cometchat-angular-v5-patterns Skill in Gemini CLI installieren
~/.gemini/skills/cometchat-angular-v5-patterns/SKILL.md
$ npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns ~/.gemini/skills/cometchat-angular-v5-patternsDen cometchat-angular-v5-patterns Skill in Claude.ai installieren
npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns cometchat-angular-v5-patterns && zip -r cometchat-angular-v5-patterns.zip cometchat-angular-v5-patterns # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cometchat-angular-v5-patterns.zip
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarcometchat/cometchat-skills/skills/cometchat-angular-v5-patterns is public and reachablegithub.com/cometchat/cometchat-skills/tree/HEAD/skills/comet ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-10-15github.com/cometchat/cometchat-skills/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cometchat/cometchat-skills/blob/HEAD/skills/comet ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/cometchat/cometchat-skills/blob/HEAD/skills/comet ↗Bestanden
- SKILL.md folgt dem Agent-Skills-Formatthe description does not say when to use the skillgithub.com/cometchat/cometchat-skills/blob/HEAD/skills/comet ↗Befund
SKILL.md
Auf GitHub ansehenGround truth: this skill is Angular PROJECT-SHAPE glue — CLI vs Nx, standalone vs NgModule,
environment.ts, SSR, lazy routes. CometChat API surface belongs tocometchat-angular-v5-core; fetch any symbol viacometchat-angular-v5-core/references/docs-map.md. Where the Angular UI Kit docs genuinely do not cover a shape (SSR / Angular Universal), this file says so explicitly and marks the guidance as the pack's own — absence from the guide is never silently presented as documented.
Companion skills (read first)
cometchat-angular-v5-core— install, credentials,init→login→render. Assumed.cometchat-angular-v5-placement— routing a chat page.
Use this skill when
The blocker is the project shape, not CometChat: a monorepo, NgModules, SSR, or where config lives.
Detect the shape first
| Signal | Shape | Deltas |
|---|---|---|
nx.json present |
Nx workspace | env files, project-level styles, path aliases |
angular.json + src/main.ts |
Angular CLI | the default; core's recipe applies as-is |
app.module.ts present |
NgModule app | components go in imports: of the module |
server.ts / @angular/ssr |
SSR / Universal | browser-only guards, see below |
NgModule instead of standalone
The kit's components are standalone, which means an NgModule app imports them into the module's imports array — the same array, a different file:
// app.module.ts
import { NgModule } from '@angular/core';
import { CometChatConversationsComponent, CometChatMessageListComponent } from '@cometchat/chat-uikit-angular';
import { ChatComponent } from './chat/chat.component'; // YOUR (non-standalone) component
@NgModule({
declarations: [ChatComponent],
imports: [CometChatConversationsComponent, CometChatMessageListComponent],
})
export class AppModule {}
Do not add them to declarations — they are not yours to declare, and Angular will error. Init moves from main.ts into an APP_INITIALIZER provider on the module.
Nx workspaces
Three things move:
- Environment files live under the app project, e.g.
apps/<app>/src/environments/environment.ts.fileReplacementsgo in that project'sproject.json, not a rootangular.json. - The kit stylesheet is registered in the app project's build
stylesarray with a workspace-root-relative path:node_modules/@cometchat/chat-uikit-angular/styles/css-variables.css. - Shared wrapper libs may re-export the kit's components; a lib that re-exports must also list them in its own
imports, or consumers get the silent no-render.
Nx does not change the CometChat API at all — only where config lives.
SSR / Angular Universal
The kit is a browser client. The SDK touches window, localStorage and WebSockets, none of which exist on the server.
import { Component, inject, PLATFORM_ID } from '@angular/core';
import { isPlatformBrowser } from '@angular/common';
import { CometChatUIKit } from '@cometchat/chat-uikit-angular';
import { environment } from '../environments/environment';
@Component({ selector: 'app-root', standalone: true, template: '<router-outlet />' })
export class AppComponent {
constructor() {
if (isPlatformBrowser(inject(PLATFORM_ID))) {
const { appId, region, authKey } = environment.cometchat;
// init only in the browser — on the server this throws "window is not defined"
CometChatUIKit.initFromSettings({
appId, region,
credentials: { authKey },
chatSDK: { presenceSubscription: { type: 'ALL_USERS' } },
});
}
}
}
Rules:
- Guard every init/login call with
isPlatformBrowser. - Render chat components client-side only (
@deferon hydration, or an*ngIfon a browser flag). Server-rendering them produces markup that immediately mismatches. ThemeServiceis already SSR-safe — it writesdata-themethrough theDOCUMENTtoken rather than touchingdocumentdirectly.- Do not attempt to prerender a chat route; there is nothing meaningful to prerender.
Not in the docs. The Angular UI Kit docs do not cover SSR / Angular Universal. The guards above are derived from what the SDK touches (
window,localStorage, WebSockets) and are the pack's own guidance — absence from the guide is not a signal that they are unnecessary.
Lazy-loading the chat route
{ path: 'chat', loadComponent: () => import('./chat/chat.component').then(m => m.ChatComponent) }
Lazy loading the route is fine and recommended — the kit is large. Init still happens once at bootstrap, not in the lazy chunk, or the first navigation pays for it and a second navigation re-runs it.
State — signals or RxJS, one of them
ChatStateService exposes both (activeUser signal, activeUser$ observable). Pick one style per component and stay in it; mixing produces two update paths for the same value.
- Signals in templates: no subscription, no teardown, no
asyncpipe. - Observables when composing with other streams: always
takeUntil(destroy$)inngOnDestroy.
Never mirror either into your own field — see placement's "two sources of truth" pitfall.
Common pitfalls
- Kit components in
declarations→ Angular error; they belong inimports. - Unguarded init under SSR →
window is not definedat build or first request. - Init inside a lazy chunk → runs late, or twice.
- Nx: env/styles edited at the workspace root → silently no effect; they belong to the app project.
- Signals and observables for the same value → two update paths, drifting UI.
Verify it works
ng build (and ng build --ssr where applicable) passes · chat renders in the browser · no window is not defined on the server · navigating to the lazy route once initialises once · config resolves in every configuration you build.
Dateien in diesem Skill
1cometchat-angular-v5-patterns Skill-Fragen
Wie installiere ich den cometchat-angular-v5-patterns Skill in Claude Code?
Führe npx degit cometchat/cometchat-skills/skills/cometchat-angular-v5-patterns ~/.claude/skills/cometchat-angular-v5-patterns aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den cometchat-angular-v5-patterns Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wie verwende ich CometChat-Komponenten in einer NgModule-basierten Angular-App?
Importiere die Standalone-Kit-Komponenten direkt in das imports-Array deines NgModules. Füge sie nicht zum declarations-Array hinzu.
Wie kann ich 'window is not defined'-Fehler bei der Verwendung von Angular SSR verhindern?
Du musst jeden Initialisierungs- und Login-Aufruf mit isPlatformBrowser absichern, um sicherzustellen, dass sie nur auf der Client-Seite ausgeführt werden.
Wo sollte ich Environment-Dateien und Styles in einem Nx-Workspace konfigurieren?
Environment-Dateien sollten unter dem spezifischen App-Projekt liegen, und das Kit-Stylesheet muss im Build-Styles-Array des jeweiligen App-Projekts unter Verwendung eines workspace-root-relativen Pfads registriert werden.
Sollte ich für das State Management mit CometChat Signals oder RxJS verwenden?
Du kannst beides verwenden, aber du solltest pro Komponente einen Stil wählen und sie nicht mischen, um zu verhindern, dass es zwei verschiedene Update-Pfade für denselben Wert gibt.