COMPLETE GUIDE

Build Your Own
Vertical Application

Step-by-step guide to building healthcare, legal, property, or any vertical AI application using the 18 Core Stack services. From zero to production.

18
Core Services
7
Phases
2-4wks
Timeline
1

Setup & Architecture

2-3 days ยท Foundation setup and vertical planning

๐Ÿ“š New to Nexus CLI?

This guide uses the Nexus CLI extensively. If you haven't installed it yet or want to learn more about all 60+ available commands, templates, and advanced features, check out the full CLI documentation.

View CLI Documentation

1.1. Install Nexus-Forge

Install the Nexus-Forge CLI which provides all development tools, Docker Compose setup, and Claude Desktop integration.

npm install -g @adverant/nexus-forge
forge --version  # Verify installation
Prerequisites: Node.js 18+, Docker Desktop running, 8GB+ RAM available

1.2. Create Your Vertical Project

Choose a vertical template or start blank. Templates include data models, API routes, and example queries for specific industries.

# Interactive setup
forge create my-vertical

# Or specify a template
forge create healthcare-crm --template healthcare
forge create legal-research --template legal
forge create property-mgmt --template property

# Or start completely blank
forge create custom-vertical --template blank
๐Ÿฅ
Healthcare Template
Patients, appointments, EHR, HIPAA compliance
โš–๏ธ
Legal Template
Cases, documents, clients, matter management
๐Ÿ 
Property Template
Listings, tenants, leases, maintenance
โšก
Blank Template
Start from scratch with Core Stack only

1.3. Understand Core Services Available

All 18 core services are automatically available. Here's what each one provides for your vertical:

brain ai
GraphRAG Memory
Store patient records, case files, property data
target
MageAgent LLM Gateway
Chat interfaces, document analysis, summaries
robot arm
Multi-Agent Orchestration
Complex workflows, multi-step research
video camera
Video Intelligence
Medical imaging, property tours, depositions
document file
Document Processing
PDFs, scans, contracts, forms
map fold
Geospatial Service
Property locations, service areas, routing
shield lock
Auth & RBAC
Multi-tenant workspaces, user permissions
lightning bolt
API Gateway
Rate limiting, load balancing, routing
2

Data Model & Authentication

3-4 days ยท Define your data structures and access control

2.1. Design Your GraphRAG Schema

Define entity types, relationships, and vector embeddings for your vertical. GraphRAG provides both PostgreSQL (structured) and Neo4j (graph) storage.

// src/schema/entities.ts
export const HealthcareSchema = {
  entities: {
    Patient: {
      properties: ['name', 'dateOfBirth', 'medicalHistory'],
      embeddings: ['medicalHistory', 'symptoms'],
      relationships: ['HAS_APPOINTMENT', 'HAS_DIAGNOSIS']
    },
    Appointment: {
      properties: ['datetime', 'status', 'notes'],
      embeddings: ['notes', 'diagnosis'],
      relationships: ['WITH_PATIENT', 'WITH_DOCTOR']
    }
  }
}

// Forge automatically creates:
// - PostgreSQL tables
// - Neo4j nodes/relationships
// - Qdrant vector collections
// - VoyageAI embedding pipelines

2.2. Configure Multi-Tenant Auth

Set up workspaces, roles, and permissions. Auth service handles JWT tokens, SSO integration, and workspace isolation automatically.

// src/config/auth.ts
export const authConfig = {
  workspaces: {
    enabled: true,
    isolation: 'strict'  // Each workspace = separate data
  },
  roles: {
    admin: ['read', 'write', 'delete', 'manage_users'],
    doctor: ['read', 'write', 'view_patients'],
    nurse: ['read', 'write_limited'],
    patient: ['read_own']
  },
  sso: {
    providers: ['google', 'okta', 'auth0']
  }
}

// Forge generates:
// - Login/signup API routes
// - JWT middleware
// - RBAC enforcement
// - Workspace switching UI
3

AI Integration

4-5 days ยท Connect LLMs and build intelligent features

3.1. Configure AI Models

Choose which AI models to use for different tasks. MageAgent provides access to 320+ models from OpenRouter, Anthropic, and OpenAI with intelligent routing to save costs.

// src/config/ai.ts
export const aiConfig = {
  chat: {
    model: 'anthropic/claude-sonnet-4',
    fallback: 'openai/gpt-4o'
  },
  analysis: {
    model: 'anthropic/claude-opus-4',
    temperature: 0.1
  },
  summarization: {
    model: 'anthropic/claude-haiku-4', // Faster, cheaper
    maxTokens: 1000
  },
  routing: {
    enabled: true,  // Intelligent cost optimization
    costSavings: '45-60%'
  }
}

3.2. Build Multi-Agent Workflows

Create workflows where multiple AI agents collaborate. Example: medical diagnosis workflow with symptom analysis, research, and recommendation agents.

// src/workflows/diagnosis.ts
export const diagnosisWorkflow = {
  name: 'Medical Diagnosis Assistant',
  agents: [
    {
      id: 'symptom-analyzer',
      model: 'claude-opus-4',
      task: 'Analyze patient symptoms and medical history',
      tools: ['graphrag_query', 'vector_search']
    },
    {
      id: 'research-agent',
      model: 'gpt-4o',
      task: 'Research similar cases in medical literature',
      tools: ['web_search', 'document_fetch']
    },
    {
      id: 'recommendation-agent',
      model: 'claude-sonnet-4',
      task: 'Generate treatment recommendations',
      tools: ['graphrag_query', 'guideline_lookup']
    }
  ],
  orchestration: 'parallel',  // Run simultaneously
  synthesis: true  // Combine results into final output
}

// Frontend shows real-time progress per agent
4

Frontend Build

4-5 days ยท Create the user interface

Build your React/Next.js frontend with pre-built components for chat interfaces, data tables, forms, and dashboards. TypeScript SDK provides full type safety.

  • Use Forge UI component library (50+ pre-built components)
  • Implement real-time chat with WebSocket streaming
  • Create data tables with infinite scroll and filters
  • Add file upload with VideoAgent/FileProcessAgent integration
  • Build dashboards with charts and metrics
5

Advanced Features

3-4 days ยท Add specialized capabilities

Video Processing

Medical imaging, property tours, depositions

Geospatial Features

Maps, routing, location-based search

Document Intelligence

OCR, form extraction, contract analysis

Notifications

Email, SMS, push notifications, webhooks

6

Testing & QA

2-3 days ยท Ensure quality and performance

Unit Tests
80%+
Vitest
Integration Tests
Critical paths
Playwright
Load Tests
1000+ users
k6
7

Deployment

1-2 days ยท Ship to production

$ forge deploy --environment production

โœ“ Running pre-deployment checks...
โœ“ Building Docker images...
โœ“ Pushing to registry...
โœ“ Updating Kubernetes...
โœ“ Running smoke tests...
โœ“ Health checks passing...

๐ŸŽ‰ Deployed to: https://my-vertical.adverant.cloud
๐Ÿ“Š Dashboard: https://my-vertical.adverant.cloud/admin
๐Ÿ“ˆ Metrics: https://metrics.adverant.cloud/my-vertical
โœ“
Zero-downtime
1-1000+ users
Auto-scaling
Built-in
Monitoring

Ready to Build?

Install Nexus-Forge and start building your vertical today. All 18 core services included.

2-4wks
Build Time
18
Core Services
550+
API Endpoints
1M+
Users Per App