Creators Agency Docs

Dashboard Pages ​

Mission Control consists of several specialized pages, each providing different views of the agency's operations.

Home Dashboard ​

The main landing page serves as Apple's morning command center with 5 key sections:

🚨 Needs Apple (Hero Section) ​

  • Purpose: Surface items requiring Apple's immediate attention
  • Data source: Agent handoffs tagged to: "apple" + blocked items from pending work
  • Update frequency: Every 2 hours (8am-10pm CT)
  • Features:
    • Resolve button to mark items complete
    • Empty state when no blockers exist
    • Automatic deduplication

💰 Revenue Tracker ​

  • Purpose: Progress toward $25M annual goal
  • Components:
    • Progress bar with percentage complete
    • YTD total, last 30 days, projected annual
    • Source breakdown pills (Close, Impact, RedVentures, AdsByMoney, MSN)
  • Update frequency: Daily at 6am CT

📋 Active Projects ​

  • Purpose: Kanban-style project overview
  • Columns: In Progress | Blocked | Done | On Hold
  • Data: 6 seeded projects with status badges
  • Features: Drag-and-drop (planned), status updates

💚 System Health Strip ​

  • Purpose: Quick health check of core systems
  • Indicators:
    • Agents: Ari, Arlo, Axel operational status (green/yellow/red)
    • Crons: Scheduled job success rates
    • Infrastructure: Server health and alerts
  • Links: Click to navigate to detailed pages

📈 Recent Activity ​

  • Purpose: Timeline of last 5 system events
  • Events: Cron runs, deployments, data syncs
  • Features: Color-coded status, timestamp, agent attribution

Projects Page ​

Route: /projects

Detailed view of all agency initiatives:

  • Layout: Grid of project cards (3 columns)
  • Content per card:
    • Project name and description
    • Status badge (In Progress/Blocked/Done/On Hold)
    • Progress bar (percentage complete)
    • Owner/team assignment
    • Key metrics or stats
  • Total: 15 projects tracked
  • Features: Status filtering, search (planned)

Pipeline Page ​

Route: /pipeline

Sponsor detection pipeline monitoring:

  • Purpose: 8-stage YouTube sponsor detection funnel

  • Stages:

    1. Channel Discovery
    2. Video Fetching
    3. Transcript Extraction
    4. Sponsor Detection
    5. Brand Normalization
    6. Database Enrichment
    7. Match Generation
    8. Agent Notification

  • Metrics per stage:

    • Volume processed
    • Success rate
    • Processing time
    • Error counts

  • Top stats: Overall pipeline health metrics

Agents Page ​

Route: /agents

Detailed agent monitoring:

  • Agents tracked: Ari (main), Arlo (sales)
  • Per agent card:
    • Operational status indicator
    • Assigned cron jobs
    • Recent activity
    • Success metrics
    • Standup/performance rates (planned)

Crons Page ​

Route: /crons

Comprehensive scheduled job monitoring:

  • Format: Sortable table
  • Columns:
    • Job name
    • Schedule (frequency)
    • Last run time
    • Status (success/failure/running)
    • Duration
    • Next run
  • Features:
    • Status filtering (all/success/failed)
    • Search by job name
    • Color-coded status indicators
  • Data source: Real cron logs and schedules

Infrastructure Page ​

Route: /infrastructure

System resource and process monitoring:

  • Top processes table:
    • Process name and PID
    • CPU usage
    • Memory usage
    • Runtime
  • System metrics:
    • Server uptime
    • Disk usage
    • Network status
  • Added: 2026-02-20

Calendar Page ​

Route: /calendar

Status: LIVE (shipped 2026-02-21)

Integrated scheduling view:

  • Data sources:
    • Google Calendar integration
    • Cron job schedules
  • Views: Week-view UI with toggle
  • Features:
    • Human/agent activity toggle
    • Meeting duration tracking
    • Conflict detection (planned)

Specialized Pages ​

Link Scan Page ​

Route: /link-scan
Status: LIVE (shipped 2026-02-25)

Link scanning pipeline statistics:

  • Domain counts
  • Brand domain matches
  • Pipeline progress

Route: /sponsor-pipeline

Live sponsor detection funnel from Convex database.

Reports Page ​

Route: /reports

Client-facing report tracking:

  • Bizee report cards with logos
  • Mine report cards with dates
  • Status and delivery tracking

Sponsors Page ​

Route: /sponsors

Brand database browser:

  • TopBrandsTable with live PostgreSQL data
  • Search, filter, and pagination
  • API endpoint: /api/sponsors

Blacklisted Domains Page ​

Route: /blacklisted-domains

Domain management for sponsor detection filtering.

Sidebar location: src/app/components/Sidebar.tsx

To add new pages, update the navigation array in the sidebar component.

All pages use consistent:

  • Dark theme (zinc-900/800 palette)
  • Tailwind CSS styling
  • TypeScript throughout
  • Responsive design principles