How devaraj-07/nexus-ai works
Nexus AI is a beta developer-pipeline command center. Users enter through the Next.js workspace to inspect pipeline intelligence, repository status, analytics, content, automation, and integrations; the Express API exposes corresponding services and persists workspace data. The graph separates the UI, API/domain routes, AI and automation services, and persistence. Several frontend-to-feature API calls and unsampled modules are not shown, so those links are limited to documented architecture rather than inferred route-by-route wiring.
Main entry points: app.js Express API · db.js Application database · ai.routes.js AI workflows · worker.service.js Queue worker
Components 25
Web workspace
- Command center
frontend/src/app/components/ClientAppShell.js - Pipeline intelligence
frontend/src/app/intelligence/page.js - Content studio
frontend/src/app/content/page.js - Pipeline board
frontend/src/app/crm/page.js - Pipeline analytics
frontend/src/app/analytics/page.js - Automation UI
frontend/src/app/automation/page.js - Integrations UI
frontend/src/app/integrations/page.js
API and domain routes
- Express API
backend/src/app.js - Authentication routes
backend/src/routes/auth.routes.js - AI workflows
backend/src/routes/ai.routes.js - Documents routes
backend/src/routes/documents.routes.js - Content routes
backend/src/routes/content.routes.js - Repository pipelines
backend/src/routes/crm.routes.js - Analytics routes
backend/src/routes/analytics.routes.js - Automation routes
backend/src/routes/automation.routes.js - Integration routes
backend/src/routes/integrations.routes.js - Settings routes
backend/src/routes/settings.routes.js
AI and automation
- AI providers
backend/src/services/gemini.service.js - Job queue
backend/src/services/queue.service.js - Queue worker
backend/src/services/worker.service.js - Integration service
backend/src/services/integration.service.js
Persistence
- Application database
backend/src/config/db.js - Document storage
backend/src/config/documentsStore.js
Other components
- Team member
- AI services
Connections 29
- Team member → Command center: uses
README.md - Command center → Express API: REST / SSE
README.md - Express API → Authentication routes: routes to
backend/src/app.js - Express API → AI workflows: routes to
backend/src/app.js - Express API → Documents routes: routes to
backend/src/app.js - Express API → Content routes: routes to
backend/src/app.js - Express API → Repository pipelines: routes to
backend/src/app.js - Express API → Analytics routes: routes to
backend/src/app.js - Express API → Automation routes: routes to
backend/src/app.js - Express API → Integration routes: routes to
backend/src/app.js - Express API → Settings routes: routes to
backend/src/app.js - AI workflows → AI providers: dispatches to
backend/src/routes/ai.routes.js - AI workflows → Application database: reads / writes
backend/src/routes/ai.routes.js - AI workflows → Document storage: reads
backend/src/routes/ai.routes.js - Automation routes → Job queue: enqueues jobs
backend/src/routes/automation.routes.js - Job queue → Queue worker: starts worker
backend/src/services/queue.service.js - Queue worker → Application database: uses
backend/src/services/worker.service.js - Queue worker → Integration service: uses
backend/src/services/worker.service.js - Repository pipelines → Application database: reads / writes
backend/src/routes/crm.routes.js - Content routes → Application database: reads / writes
backend/src/routes/content.routes.js - Integration routes → Application database: reads / writes
backend/src/routes/integrations.routes.js - Analytics routes → Application database: reads
backend/src/routes/analytics.routes.js - AI providers → AI services: calls models
- Pipeline intelligence → AI workflows: uses AI workflows
- Content studio → Content routes: uses content API
- Pipeline board → Repository pipelines: uses pipeline API
- Pipeline analytics → Analytics routes: uses analytics API
- Automation UI → Automation routes: uses automation API
- Integrations UI → Integration routes: uses integrations API