@cometchat/skills 3.0.0 → 4.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CometChat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,8 @@
 # cometchat-skills
 
-**Add CometChat to any React project through your AI coding agent.** Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/vercel-labs/skills).
+**Add CometChat to any React, React Native, Angular, Android, Flutter, or iOS project through your AI coding agent.** Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/vercel-labs/skills).
 
-v3 takes an AI-first approach: your agent has a short conversation with you to understand your project and chat requirements, then writes production-grade integration code tailored to the files you already have.
+v4 takes an AI-first approach: your agent has a short conversation with you to understand your project and chat requirements, then writes production-grade integration code tailored to the files you already have. One slash — `/cometchat` — works for every supported framework, on web, mobile, and native.
 
 ## Install
 
@@ -10,7 +10,23 @@ v3 takes an AI-first approach: your agent has a short conversation with you to u
 npx @cometchat/skills add
 ```
 
-Supported IDEs: Claude Code (default), Cursor, Kiro, VS Code Copilot. Use `--ide <name>` to target a specific one, or `--ide all`.
+That's it — one command for every supported framework. The installer detects what you're working with (React, Next.js, React Router, Astro, Expo, bare React Native, Angular, native Android, Flutter, or native iOS) from your project and installs the right skills.
+
+Override detection if needed:
+
+```bash
+npx @cometchat/skills add --family web      # React / Next.js / React Router / Astro
+npx @cometchat/skills add --family native   # Expo / bare RN
+npx @cometchat/skills add --family angular  # Angular 12-15
+npx @cometchat/skills add --family android  # Native Android (V5 stable + V6 beta)
+npx @cometchat/skills add --family flutter  # Flutter (V5 stable + V6 beta)
+npx @cometchat/skills add --family ios      # Native iOS (V5 stable)
+npx @cometchat/skills add --family all      # install every published skill
+```
+
+Supported IDEs: Claude Code (default), Cursor, Kiro, VS Code Copilot, Replit Agent. Use `--ide <name>` to target a specific one, or `--ide all`. Replit users: skills land in `.agents/skills/` automatically when you pass `--ide replit`.
+
+> **Migrating from v3?** `npx @cometchat/skills-native add` still works (with a deprecation notice). New projects should use the unified command.
 
 Then in your IDE:
 
@@ -20,12 +36,12 @@ Then in your IDE:
 
 ## What happens
 
-1. **Detects** your framework (React / Next.js / React Router / Astro), router, env prefix, existing auth system
+1. **Detects** your framework (React / Next.js / React Router / Astro / Expo / bare React Native / Angular / Android / Flutter / iOS), router, env prefix, existing auth system
 2. **Onboards** you to CometChat in the terminal — no browser round-trip. Signup, login, app creation all via the CLI.
-3. **Asks** what you're building (marketplace, SaaS, messaging, support, social, or just exploring) and **where** chat should live in your project — it reads your routes, nav, and components before proposing a placement
+3. **Asks** what you're building (marketplace, SaaS, messaging, support, social, or just exploring) and **where** chat should live in your project — it reads your routes/screens, nav, and components before proposing a placement that fits (route+drawer for web, stack/tab/modal/bottom-sheet for RN, route/modal for Angular, Activity/Fragment for Android, navigation controller for iOS, route/modal sheet for Flutter)
 4. **Shows the plan** — exactly which files it will create, which it will modify, and which it will not touch — and waits for your approval
-5. **Writes** the provider, integration components, and route/trigger wiring
-6. **Saves** `.env` with the correct framework prefix (`VITE_` / `NEXT_PUBLIC_` / `PUBLIC_`) and records your choices in `.cometchat/config.json`
+5. **Writes** the provider, integration components, and route/screen/trigger wiring
+6. **Saves** credentials with the correct convention for your framework (`.env` with `VITE_` / `NEXT_PUBLIC_` / `PUBLIC_` / `EXPO_PUBLIC_` prefix on web/RN; `src/environments/environment.ts` on Angular; `local.properties` + `BuildConfig` on Android; `Secrets.swift` / `.xcconfig` on iOS; Dart const file or `--dart-define` on Flutter) and records your choices in `.cometchat/config.json`
 
 No templates, no experiences to pick — the agent writes real code that fits your app.
 
@@ -33,13 +49,16 @@ No templates, no experiences to pick — the agent writes real code that fits yo
 
 | Framework | Status |
 |---|---|
-| React.js / Vite / CRA | ✅ |
-| Next.js (App Router + Pages Router) | ✅ |
-| React Router v6 / v7 | ✅ |
-| Astro (React islands) | ✅ |
-| React Native | 🔜 Coming soon |
-| Flutter | 🔜 Coming soon |
-| Android / iOS | 🔜 Coming soon |
+| React.js / Vite / CRA | ✅ (`@cometchat/skills`) |
+| Next.js (App Router + Pages Router) | ✅ (`@cometchat/skills`) |
+| React Router v6 / v7 | ✅ (`@cometchat/skills`) |
+| Astro (React islands) | ✅ (`@cometchat/skills`) |
+| Expo (managed + Expo Router) | ✅ (`@cometchat/skills`) |
+| Bare React Native (CLI) | ✅ (`@cometchat/skills`) |
+| Angular 12-15 | ✅ (`@cometchat/skills`) |
+| Android (V5 stable + V6 beta) | ✅ (`@cometchat/skills`) |
+| Flutter (V5 stable + V6 beta) | ✅ (`@cometchat/skills`) |
+| iOS (V5 stable) | ✅ (`@cometchat/skills`) |
 
 ## After the first integration
 
@@ -48,11 +67,13 @@ Re-run `/cometchat` anytime to pick from the iteration menu:
 - **Customize look & feel** — theme presets (slack / whatsapp / imessage / discord / notion) or your own brand color
 - **Add a feature** — 40+ features including calls, reactions, polls, AI smart replies, file sharing, presence
 - **Customize a component** — custom message bubbles, headers, composer actions, empty/loading states
-- **Add a floating widget** — overlay chat button + drawer on top of your existing app
+- **Add another placement** — floating widget (web), modal / bottom sheet / extra tab (RN)
 - **Set up production auth** — replace the dev Auth Key with a server-side token endpoint
 - **Set up user management** — server endpoints for creating/updating/deleting CometChat users
 - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup
 
+React Native projects also get **Set up push notifications** (APNs + FCM end-to-end), **Set up testing** (Jest + RNTL + Detox/Maestro), and **Troubleshoot an issue** (Metro cache, pod install, privacy manifest) in the menu.
+
 ## Recommended: CometChat Docs MCP
 
 For deeper component customization (custom views, SDK events, request builders), install the docs MCP:
@@ -84,11 +105,17 @@ npx @cometchat/skills-cli auth signup       # create account, all in terminal
 npx @cometchat/skills-cli auth login        # sign in (masked password)
 npx @cometchat/skills-cli auth status       # check current session
 
-# App provisioning
+# App provisioning — web example
 npx @cometchat/skills-cli provision list    # list apps on your account
 npx @cometchat/skills-cli provision setup \
   --name my-chat --region us --industry saas_businesses \
-  --framework reactjs                       # create app + write .env + save config
+  --framework reactjs                       # create app + write .env (VITE_ prefix) + save config
+
+# App provisioning — React Native example (Expo or bare RN)
+npx @cometchat/skills-cli provision setup \
+  --name my-rn-chat --region us --industry online_marketplaces \
+  --framework expo                          # writes EXPO_PUBLIC_* env vars
+# Use --framework react-native for bare RN (no env prefix; pair with react-native-dotenv)
 
 # Project introspection
 npx @cometchat/skills-cli detect            # framework, router, env prefix