CADENCES NEXUS

The Universal Business Operating System

NEXUS is a private admin panel for managing AI-powered business operations across multiple organizations. It provides a unified command center for monitoring voice calls, workflows, leads, and analytics.

🚀 Features

Command Center Dashboard - Real-time overview of all business operations
God Mode - Monitor and control live AI voice calls with whisper/takeover capabilities
Workflow Studio - Create, manage, and broadcast automated workflows
Lead DNA - Advanced lead management with AI scoring and enrichment
Analytics Engine - Cross-organization conversion funnels and channel attribution
Multi-Organization Hub - Manage multiple businesses from one interface

🛠️ Tech Stack

React 18 - UI framework
TypeScript - Type safety
Vite - Build tool and dev server
TailwindCSS - Styling
Zustand - State management
React Router v7 - Routing
Lucide React - Icons

📦 Installation

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env

# Start development server
npm run dev

The app runs on http://localhost:5174

🔧 Configuration

Create a .env file with:

VITE_GOOGLE_CLIENT_ID=your-google-oauth-client-id

📁 Project Structure

src/
├── components/
│   ├── layouts/        # Page layouts (DashboardLayout)
│   └── ui/             # Reusable UI components
├── lib/
│   ├── api.ts          # API client
│   ├── websocket.ts    # WebSocket manager
│   └── utils.ts        # Utility functions
├── pages/              # Route pages
├── stores/             # Zustand stores
├── types/              # TypeScript types
├── App.tsx             # Main app with routes
├── main.tsx            # Entry point
└── index.css           # Global styles

🎨 Design System

NEXUS uses the "Aerospace Dark" theme:

Background: #0a0a0f
Card: #12121a
Surface: #1a1a25
Accent: #6366f1 (Indigo)
Text: #f8fafc
Muted: #94a3b8

📜 Scripts

Command	Description
`npm run dev`	Start dev server
`npm run build`	Production build
`npm run preview`	Preview production build
`npm run lint`	Run ESLint
`npm run type-check`	TypeScript type checking

🔐 Authentication

NEXUS uses Google OAuth for authentication. Configure your Google OAuth credentials in the .env file.

🌐 API Proxy

In development, API requests to /api/* are proxied to https://cadences.app. Configure this in vite.config.ts.

📄 License

Private - CADENCES Internal Use Only

Nexus Template — README