🧠 Cortex: The Visual Data Commander

Powered by Tambo AI

Cortex is a production-grade, identity-aware generative database management platform. Built on the Tambo SDK, it transforms complex database interactions into intuitive natural language conversations with state-of-the-art Generative UI components.

🚀 Features

• Generative UI: Intelligent rendering of Graphs, Tables, and Interactive Schemas.
• Identity-Aware: Role-based access control (RBAC) integrated into the core conversation loop.
• Visual Schema: Interactive ReactFlow-based schema visualization and modification.
• Mission Control: Centralized dashboard for business intelligence and system monitoring.
• Production Ready: Built with Next.js 16, Prisma, Better-Auth, and Tailwind CSS.

🏗️ System Architecture

Cortex follows a sophisticated multi-phase system flow that bridges natural language intent with visual state management.

graph TD
    subgraph Onboarding ["Phase 1 & 2: Landing & Auth"]
        LP[Landing Page] --> OM[Onboarding Modal]
        OM --> BAUI[BetterAuth UI]
        BAUI --> BAB[BetterAuth Backend]
        BAB --> UT[(User Table)]
        BAB --> SM[Session Manager]
        SM --> RA[Role Assignment]
    end

    subgraph Genesis ["Phase 3: Genesis Flow"]
        RA --> DL[Dashboard Loader]
        DL --> DBE[DB Elicitation Form]
        DBE --> DBV[DB Validator]
        DBV --> DBCT[(DbConfig Table)]
        DBV --> SC[StatusCard]
    end

    subgraph CoreLoop ["Phase 4 & 5: Core Loop"]
        SC --> DSH[Dashboard]
        DSH --> |Left Panel| CC[CortexChat]
        DSH --> |Right Panel| CP[CanvasPanel]
        
        CC --> |Message| TK[Tambo Kernel]
        TK --> |Execute| TE[Tool Executor]
        TE --> |Server Action| SA[Server Actions]
        SA --> |Update| ZS[Zustand Store]
        ZS -.-> |Listen| CP
    end

    subgraph Security ["Phase 6 & 7: RBAC & Ghost Mode"]
        TK --> RD[Role Decision]
        RD --> TOS[Tool Output Switcher]
        
        TK --> RSK[Risk Detector]
        RSK --> |High Risk| AD[Access Denied UI]
        RSK --> |Confirmation| GM[Ghost Mode UI]
        AD --> |Lock| CP
    end

    subgraph Team ["Phase 8: Team Invitation"]
        CC --> EF[Elicitation Form]
        EF --> IT[Invite Tool]
        IT --> IC[Invite Card UI]
    end

    %% Styling
    style LP fill:#4f46e5,color:#fff
    style TK fill:#f59e0b,color:#fff
    style ZS fill:#ec4899,color:#fff
    style RSK fill:#ef4444,color:#fff

Loading

🛠️ Tech Stack

• Agent Framework: Tambo AI (Core Kernel & SDK)
• Framework: Next.js (App Router)
• Database: Prisma (PostgreSQL/SQLite)
• Authentication: Better-Auth
• UI Components: Radix UI, Lucide React
• Visualization: ReactFlow, Recharts

🏁 Getting Started

Prerequisites

• Node.js 20+
• PostgreSQL (or use the included SQLite for local dev)

Local Development

1. Clone the repository
2. Install dependencies:

   npm install

3. Configure environment: Copy .env-example to .env and fill in the required values.
4. Setup the database:

   npx prisma migrate dev
   npm run db:setup

5. Start the development server:

   npm run dev

📂 File Structure Overview

Component	Path	Description
App Shell	src/app/	Dashboard layout, landing page, and Auth API routes.
Generative UI	src/components/cortex/	SchemaCanvas, SmartTable, GhostModeModal, InviteForm.
Chat System	src/components/chat/	CortexChat and CanvasPanel split-screen implementation.
Logic Layer	src/server/actions/	cortex-tools, connection-tools, and invite server actions.
Agent Kernel	src/tambo/	Tambo SDK configuration and dynamic tool definitions.
Core State	src/lib/store.ts	Global Zustand store for Canvas/Chat synchronization.
Backing DB	prisma/	Schema definitions and seeds for the internal system DB.

🔒 Security & Ghost Mode

Cortex implements a "Ghost Mode" for high-risk data operations. When a destructive action (like DELETE or DROP) is requested:

1. The Risk Detector flags the intent.
2. The UI switches to Ghost Mode, rendering a confirmation modal.
3. Operation only proceeds after explicit administrative confirmation and permission check.

---

Built for the Generative UI Hackathon. Powered by TAMBO AI.