# Nexus — llms-full.txt

## Product description
Nexus is a multi-tenant operations operating system (Ops OS)
purpose-built for small-and-medium enterprises (SMEs) in the MENA region.
It consolidates omnichannel messaging, CRM, order management,
fulfillment (pick/pack/ship), inventory and warehouse management,
shipping with courier integrations, VoIP/PBX telephony,
AI-powered customer-service analytics, and workflow automation
into a single unified platform.

## Technology stack
- Frontend: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- Backend: Supabase (PostgreSQL + 117+ Edge Functions on Deno)
- Auth: Supabase Auth (JWT), multi-tenant RLS
- Integrations: WhatsApp Business API, Meta Graph API, Shopify, Bosta, Issabel PBX, n8n

## Docs root: https://nexus.aiforstartups.io/docs

## Capabilities by intent
- omnichannel-inbox: Receive and send messages via WhatsApp, Facebook Messenger, Instagram DMs, and email from a unified inbox.
- crm: Manage contacts, companies, labels, journey stages, customer-360 views, segments, and campaigns.
- order-management: Create, import, edit, and track orders through pending → confirmed → processing → shipped → delivered lifecycle.
- fulfillment: Generate pick lists, assign pickers, scan items, pack, and hand off to shipping.
- inventory: Track items across warehouses and bins, record stock movements, run cycle counts, manage purchase orders.
- shipping: Create AWBs via courier APIs, print labels, track shipments via webhooks.
- voip: Click-to-call, CDR sync, call analytics, and extension management via Issabel PBX.
- ai-analytics: Conversation annotation (sentiment, topics, risk flags), voice transcription, CRM embeddings, CS dashboards.
- automation: Event-driven workflows (abandoned cart recovery, notifications, scheduled tasks) via rules engine and n8n.
- e-commerce-sync: Bidirectional Shopify sync (orders, customers, fulfillment status).
- competition-intel: Automated competitor monitoring, analysis, and reporting.

## Page map with summaries

### Nexus Documentation
URL: https://nexus.aiforstartups.io/docs/
Summary: Landing page and navigation hub for all Nexus documentation.

### Product Overview
URL: https://nexus.aiforstartups.io/docs/overview
Summary: What Nexus is, who it's for, and the core modules.

### What is Nexus?
URL: https://nexus.aiforstartups.io/docs/overview/what-is-nexus
Summary: Product description, capabilities, architecture, and security posture.

### Who It's For
URL: https://nexus.aiforstartups.io/docs/overview/who-its-for
Summary: Target audience, verticals, and team personas.

### Core Modules & Workflows
URL: https://nexus.aiforstartups.io/docs/overview/core-modules
Summary: Module map and end-to-end workflow examples.

### Concepts
URL: https://nexus.aiforstartups.io/docs/concepts
Summary: Data model objects and their relationships.

### Contacts & Companies
URL: https://nexus.aiforstartups.io/docs/concepts/contacts-companies
Summary: Contact (customer) object, labels, journey stages.

### Conversations & Messages
URL: https://nexus.aiforstartups.io/docs/concepts/conversations-messages
Summary: Conversation and message objects, channel behavior.

### Orders & Fulfillment
URL: https://nexus.aiforstartups.io/docs/concepts/orders-fulfillment
Summary: Order lifecycle, pick lists, shipments, returns.

### Inventory & Warehousing
URL: https://nexus.aiforstartups.io/docs/concepts/inventory-warehousing
Summary: Inventory items, warehouses, bins, stock movements.

### Integrations (Concept)
URL: https://nexus.aiforstartups.io/docs/concepts/integrations
Summary: Integration model, supported services, credential security.

### Automation
URL: https://nexus.aiforstartups.io/docs/concepts/automation
Summary: Triggers, actions, rules, and built-in automations.

### AI & Analytics
URL: https://nexus.aiforstartups.io/docs/concepts/ai-analytics
Summary: AI annotation, transcription, embeddings, dashboards.

### Guides
URL: https://nexus.aiforstartups.io/docs/guides
Summary: Step-by-step how-to instructions for common tasks.

### Connect WhatsApp
URL: https://nexus.aiforstartups.io/docs/guides/how-to/connect-whatsapp
Summary: Link a WhatsApp Business number to Nexus.

### Connect Facebook & Instagram
URL: https://nexus.aiforstartups.io/docs/guides/how-to/connect-facebook-instagram
Summary: Link Facebook Pages and Instagram accounts.

### Connect Shopify
URL: https://nexus.aiforstartups.io/docs/guides/how-to/connect-shopify
Summary: Sync orders and customers from a Shopify store.

### Process an Order
URL: https://nexus.aiforstartups.io/docs/guides/how-to/process-order
Summary: Full order lifecycle: create, pick, pack, ship, track.

### Handle Returns
URL: https://nexus.aiforstartups.io/docs/guides/how-to/handle-returns
Summary: Process customer returns and restock inventory.

### Stock Adjustment
URL: https://nexus.aiforstartups.io/docs/guides/how-to/warehouse-stock-adjustment
Summary: Correct inventory quantities manually.

### CS Analytics & AI Insights
URL: https://nexus.aiforstartups.io/docs/guides/how-to/view-cs-analytics
Summary: Review AI annotations and CS dashboards.

### Integrations
URL: https://nexus.aiforstartups.io/docs/integrations
Summary: Per-integration setup, capabilities, and troubleshooting.

### WhatsApp Integration
URL: https://nexus.aiforstartups.io/docs/integrations/whatsapp
Summary: WhatsApp Business API capabilities and Edge Functions.

### Shopify Integration
URL: https://nexus.aiforstartups.io/docs/integrations/shopify
Summary: Order, customer, and fulfillment sync.

### API Reference
URL: https://nexus.aiforstartups.io/docs/api
Summary: Authentication, conventions, and the OpenAPI spec.

### Authentication
URL: https://nexus.aiforstartups.io/docs/api/auth
Summary: JWT tokens, Supabase Auth, and webhook auth.

### Rate Limiting & Pagination
URL: https://nexus.aiforstartups.io/docs/api/rate-limiting
Summary: Request limits, pagination, filtering, ordering.

### Database Reference
URL: https://nexus.aiforstartups.io/docs/reference/database
Summary: Auto-generated table dictionary (143 tables).

### Edge Functions Reference
URL: https://nexus.aiforstartups.io/docs/reference/functions
Summary: Inventory of 117+ Supabase Edge Functions.

### FAQ
URL: https://nexus.aiforstartups.io/docs/faq
Summary: Frequently asked questions on product, security, AI, and setup.

### Glossary
URL: https://nexus.aiforstartups.io/docs/glossary
Summary: Canonical term definitions and synonym mappings.

## Core objects
- Contact (Customer): A person your organization interacts with. Central CRM entity.
- Conversation (Chat): A threaded messaging exchange on a channel (whatsapp, facebook, instagram, email, internal).
- Message: A single unit within a conversation (text, media, template, reaction).
- Order: A sales transaction with line items and lifecycle status.
- AWB (Shipment): A courier shipment with tracking number, status, and label.
- Inventory Item: A product/SKU tracked in the warehouse system.
- Warehouse: A storage location containing bins.
- Bin (Location): A specific position within a warehouse.
- Stock Movement: A recorded change in inventory quantity.
- Annotation: An AI-generated analysis of a conversation.
- Automation Rule: A trigger-action pair for event-driven automation.

## Machine-readable resources
- OpenAPI 3.1 spec (YAML): https://nexus.aiforstartups.io/openapi.yaml
- This file: https://nexus.aiforstartups.io/llms-full.txt
- Short index: https://nexus.aiforstartups.io/llms.txt