@relaya-chat/react 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JAB Ventures, Inc.
+
+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

@@ -0,0 +1,215 @@
+# @relaya/react
+
+**Community chat for creators and platforms. Embed a fully moderated, real-time chat box on any website or app — no backend required.**
+
+```tsx
+import { RelayaChat } from '@relaya/react';
+import '@relaya/react/styles';
+
+export default function CommunityPage() {
+  return (
+    <RelayaChat
+      spaceSlug="your-space-slug"
+      serverUrl="https://api.relaya.chat"
+    />
+  );
+}
+```
+
+That's it. Auth, real-time messaging, moderation, stickers, themes, and history — all handled inside the component. Ship in 2 hours, not 2 months.
+
+---
+
+## What is Relaya?
+
+Relaya started as a problem: when [Balearic FM](https://balearic-fm.com) tried to embed Cbox into its iOS app, Apple rejected it — Cbox couldn't meet Apple's UGC content moderation requirements. So the founder built Relaya: the community chat infrastructure that ticked every box, at a price indie developers can actually afford.
+
+Stop scattering your audience across Discord or WhatsApp groups you don't control. Relaya chat lives on your domain, with your branding, under your rules — keeping fans engaged where you want them.
+
+**Three integration paths — one backend:**
+
+| Path | Who it's for |
+|---|---|
+| **iframe embed** | Creators on Wix, Squarespace, WordPress — copy, paste, done |
+| **`@relaya/react`** | Web developers who want a React component, not an iframe |
+| **`@relaya/react-native`** | Mobile developers who need App Store-compliant UGC |
+
+One subscription covers all three. Pick your path, start in minutes.
+
+**Live demo:** [relaya.chat](https://relaya.chat) — try it in your browser right now.
+
+---
+
+## Features
+
+### 🔑 Known members, zero friction
+
+Real members, not anonymous guests — everyone has a verified email identity. Bans stick, regulars recognize each other, and your audience is yours to keep.
+
+Sign-in is effortless: a one-time code to their inbox, no password needed. Sessions last 33 days. No OAuth dance, no password resets, no account lockouts.
+
+### 🛡️ Moderation built in — not bolted on
+
+Report, ban, and delete tools on every plan, from day one. No upgrade required for moderation. Server-side enforcement only — no client-side trust shortcuts. Built to satisfy Apple's UGC guidelines from the start.
+
+### 🧩 From iframe to SDK. One product.
+
+Copy-paste an iframe onto your Wix site. Drop `@relaya/react` into your Next.js app. Ship a React Native mobile app with App Store–compliant chat. One subscription, every integration path.
+
+### 🎨 Custom branding
+
+Match your site's colors with the visual theme editor. Custom fonts, colors, and layout options. The "Powered by Relaya" badge is present on the Embed plan and removed on Community and Developer plans.
+
+### 🖼️ Custom sticker sets
+
+Upload your own sticker sets to give your community a unique, on-brand way to express themselves. Up to 20 on Embed, 100 on Community, unlimited on Developer.
+
+### ⚡ Real-time, always
+
+WebSocket-based. Messages appear instantly. Auto-reconnects on network drops. No polling, no delays.
+
+### 🌍 Country & IP controls
+
+Country allowlist/blocklist and IP ban tools for spaces with compliance needs or persistent bad actors.
+
+### 📊 Chat history & export
+
+Configurable message archive up to 180 days. Export your full chat history as CSV — your data stays yours, always. Searchable from the admin panel.
+
+### 🔒 No-cookie architecture
+
+Auth uses short-lived tokens in memory + rotating refresh tokens in `sessionStorage`. No third-party cookies. No cookie-consent banner required. Works in cross-origin iframes (Wix, Squarespace) without issue.
+
+---
+
+## Installation
+
+```bash
+npm install @relaya/react
+```
+
+**Peer dependencies:** React 18+
+
+```json
+{
+  "react": ">=18.0.0",
+  "react-dom": ">=18.0.0"
+}
+```
+
+---
+
+## Quick Start
+
+### 1. Get your space slug
+
+Create a free account at [relaya.chat](https://relaya.chat) and set up your first space. Your `spaceSlug` is the only required config. Relaya issues auth tokens directly to your users — your app never handles credentials.
+
+### 2. Drop in the component
+
+```tsx
+import { RelayaChat } from '@relaya/react';
+import '@relaya/react/styles';
+
+export default function CommunityPage() {
+  return (
+    <RelayaChat
+      spaceSlug="your-space-slug"
+      serverUrl="https://api.relaya.chat"
+    />
+  );
+}
+```
+
+`<RelayaChat />` renders the complete chat UI: sign-in flow, message list, input, sticker picker, and moderation controls — all wired to the Relaya backend.
+
+---
+
+## Custom Assembly
+
+If the default UI doesn't fit your design, import the pieces you need:
+
+```tsx
+import {
+  AuthModal,
+  MessageList,
+  MessageInput,
+  useRelayaAuth,
+  useRelayaChat
+} from '@relaya/react';
+```
+
+The hooks handle all state, connection management, and auth token refresh. The components accept `className` overrides for custom styling. See the [component reference](https://relaya.chat/docs/react) for the full API.
+
+---
+
+## Pricing
+
+All features above are available across three subscription tiers — from a simple embed for content creators to a full developer tier with React Native SDK and REST API access. Moderation tools (ban, delete, report) are included on **every tier**.
+
+15-day free trial, no credit card required.
+
+[See plans and pricing at relaya.chat →](https://relaya.chat)
+
+---
+
+## How Relaya Compares
+
+|  | Tawk.to | Stream | Cbox | Discord | **Relaya** |
+|---|---|---|---|---|---|
+| **Use case** | Customer support | Platform chat | Community widget | Community | **Community** |
+| **No-code embed** | ✓ | ✗ | ✓ | ✓ | **✓** |
+| **React SDK** | ✗ | ✓ | ✗ | ✗ | **✓** |
+| **React Native SDK** | ✗ | ✓ | ✗ | ✗ | **✓** |
+| **Moderation on every tier** | N/A | Medium | Partial (Pro+) | ✗ | **✓** |
+| **App Store compliance path** | N/A | ✓ | ✗ | ✗ | **✓** |
+| **Entry paid price** | Free | $99+/mo | $1.67/mo | Free | **$9/mo** |
+| **Data ownership** | ✓ | ✓ | ⚠️ | ✗ | **✓** |
+
+**Relaya's unique position:** The only product with community focus, no-code embed, React SDK, React Native SDK, moderation on every tier, and affordable pricing — all in one.
+
+- **vs. Stream:** Same infrastructure quality, a fraction of the price. Stream is enterprise pricing for enterprise teams. Relaya is priced for indie developers from day one.
+- **vs. Cbox:** Cbox is great for a simple chat box. Relaya is for when you need an API, a React component, a mobile app, or a path to the App Store. Like Stripe vs. a PayPal button.
+- **vs. Discord embed:** Keep your community on your platform, not Discord's. Your moderation, your data, your brand.
+- **vs. building from scratch:** 2 hours vs. 2-6 months. Moderation built in. App Store compliance included.
+
+---
+
+## Authentication Details
+
+Relaya uses a short-lived access token + rotating refresh token model with no third-party cookies:
+
+- Tokens live in memory and `sessionStorage` — no `localStorage`, no cookies
+- No cookie-consent banner required
+- Works in cross-origin iframes (Wix, Squarespace)
+- Sessions last 33 days with active refresh; expire when the user closes the tab on fresh sign-in
+
+See [README-AUTH.md](./README-AUTH.md) for the full token lifecycle, session behavior, and sign-out details.
+
+---
+
+## Getting Help
+
+- **Documentation:** [relaya.chat/docs](https://relaya.chat/docs)
+- **Dashboard + space setup:** [relaya.chat](https://relaya.chat)
+- **GitHub Issues:** [github.com/relaya-chat/sdk/issues](https://github.com/relaya-chat/sdk/issues)
+- **Discussions:** [github.com/relaya-chat/sdk/discussions](https://github.com/relaya-chat/sdk/discussions)
+- **Email:** [hello@relaya.chat](mailto:hello@relaya.chat)
+
+---
+
+## Who Builds This
+
+Relaya is built by [Jay Batson](https://github.com/batsonjay) — co-founder of [Acquia](https://acquia.com), operator of [Balearic FM](https://balearic-fm.com), and the developer who built Relaya when Apple rejected Cbox in the Balearic FM iOS app.
+
+**The origin story in one sentence:** Got kicked off a radio platform, built Balearic FM, tried to embed a community chat in the iOS app, Apple said no, built Relaya.
+
+Contributions are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the contributor license agreement and how to get started.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+> Commercial use is welcome and encouraged. A Contributor License Agreement (CLA) in `CONTRIBUTING.md` preserves the ability to maintain long-term project sustainability. By contributing, you agree to assign copyright to the project maintainer.