> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chromaflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Connect ChromaFlow to your enterprise stack—real-time guides for Auth0, GitHub, Supabase, Stripe, Intercom, and Perplexity with streaming sync and security.

# Real-Time Enterprise Integrations

ChromaFlow's connector ecosystem enables instantaneous, secure data flows for enterprise operations. Each integration supports real-time synchronization via webhooks, streaming APIs, and edge execution—designed for compliance, velocity, and global scale.

<div class="doc-cards">
  <div class="doc-card">
    <span class="doc-badge">Live Sync</span>
    <h3>GitHub Real-Time</h3>
    <p>Streaming repo imports, commit webhooks, and Pages deploys with Durable Object coordination.</p>
  </div>

  <div class="doc-card">
    <span class="doc-badge">Edge DB</span>
    <h3>Supabase Streaming</h3>
    <p>Real-time project provisioning, RLS queries, and edge function triggers.</p>
  </div>

  <div class="doc-card">
    <span class="doc-badge">Secure Billing</span>
    <h3>Stripe Real-Time</h3>
    <p>Instant session creation, webhook events, and usage metering at scale.</p>
  </div>
</div>

## Auth0 Real-Time Authentication

Enterprise identity layer with live session management:

<Accordion title="Streaming Client Experience">
  `app/components/auth/*` handles modals and token streams; real-time status updates via WebSockets.
</Accordion>

<Accordion title="Hook Layer for Live Auth">
  `app/hooks/useAuth.ts` manages refreshes and RBAC checks in real-time; integrates with SSE for session events.
</Accordion>

<Accordion title="Server-Side Enforcement">
  `app/services/auth.server.ts` validates tokens per stream; middleware gates real-time endpoints.
</Accordion>

<Accordion title="Configuration & Secrets">
  Validate in `app/lib/env.server.ts`; automate with `scripts/setup-auth0.js` for multi-tenant streams.
</Accordion>

<Accordion title="Real-Time Routes">`app/routes/auth.*` handle callbacks and status with SSE progress.</Accordion>

<Note>**Scalability**: Supports 1M+ active sessions; anomaly detection streams alerts instantly.</Note>

## GitHub Real-Time Sync

Live code collaboration and deployment:

<Accordion title="API Streaming Orbit">
  `app/routes/api.github.*` imports repos in real-time streams; webhooks trigger instant syncs and rebuilds.
</Accordion>

<Accordion title="UI Real-Time Modules">
  `app/components/integrations/GitHubIntegration.tsx` surfaces live status, commit streams, and collab invites.
</Accordion>

<Accordion title="Launch Automation Streams">
  `app/routes/api.publish-github-pages.ts` deploys with progress SSE; Durable Objects track build state.
</Accordion>

**Enterprise Features**:

| Capability   | Real-Time Mechanism | Scale       | Security          |
| ------------ | ------------------- | ----------- | ----------------- |
| Repo Import  | Streaming Clone     | 10k/min     | OAuth Scopes      |
| Commit Sync  | Webhook Streams     | Unlimited   | Branch Protection |
| Pages Deploy | SSE Progress        | Global Edge | Access Tokens     |

## Supabase Real-Time Projects

Edge database integration for live data:

<Accordion title="SDK Streaming Harness">
  `app/lib/supabase/*` wraps clients for real-time provisioning and queries via edge functions.
</Accordion>

<Accordion title="API Real-Time Routes">
  `app/routes/api.supabase.*` creates/deletes projects with live status; streams schema migrations.
</Accordion>

<Accordion title="UX Live Touchpoints">
  `app/components/header/SupabaseTools.tsx` monitors connections and data flows in real-time.
</Accordion>

<Accordion title="Token Real-Time Governance">
  `app/routes/admin.tokens.tsx` adjusts balances via streaming UI; Supabase realtime for updates.
</Accordion>

<Note>**Scalability**: Petabyte-scale with edge caching; RLS for multi-tenant isolation.</Note>

## Stripe Real-Time Billing

Secure, event-driven monetization:

<Accordion title="Server Streaming Endpoints">
  `app/routes/api.stripe.*` creates sessions and portals with real-time confirmations.
</Accordion>

<Accordion title="Frontend Live Surfaces">
  `app/components/payments` streams pricing updates and receipt events.
</Accordion>

<Accordion title="Secrets & Compliance">
  Configure keys; webhooks (`app/routes/api.stripe.webhook.ts`) verify signatures in \<50ms.
</Accordion>

**Real-Time Events**:

* Subscription Created: Instant quota updates via Supabase streams.
* Payment Failed: WebSocket alerts to users/admins.
* Usage Metered: Edge calculations for token economies.

## Intercom Real-Time Support

Live customer engagement:

<Accordion title="Secure Streaming Boot">
  `app/root.tsx` initializes with signed hashes from `app/routes/api.intercom.verify.ts`; streams messages.
</Accordion>

<Accordion title="Configuration">`INTERCOM_APP_ID` enables real-time Messenger with user context.</Accordion>

<Note>**Enterprise Use**: Route support tickets to real-time agent sessions for instant resolution.</Note>

## Perplexity Real-Time Search

Intelligent augmentation for grounded responses:

<Accordion title="Service Real-Time Wrapper">
  `app/lib/.server/search/perplexity-service.ts` caches and retries at edge; streams results into chat.
</Accordion>

<Accordion title="Chat Augmentation Streams">
  `app/routes/api.chat.ts` interleaves search snippets in SSE deltas.
</Accordion>

<Note>**Scalability**: 100k queries/min; TTL caching reduces costs by 70%.</Note>

## Launching Real-Time Integrations

1. **Design Live UI** – Build under `app/components/connectors` with WebSocket hooks for status.
2. **Implement Streaming APIs** – Add `app/routes/api.integrations.$provider.*` with SSE/WebSocket support.
3. **Secure Secrets** – Register in `app/lib/env.server.ts`; use Wrangler for edge binding.
4. **Real-Time Triggers** – Expose in chat/workbench; stream progress and errors.
5. **Document & Scale** – Update here; test at 10x load with Cloudflare simulations.

Leverage `scripts/` for automated real-time setup and reconciliation. ChromaFlow integrations: Real-time, resilient, enterprise-ready.