NexisChat Documentation

NexisChat Documentation

Version: 1.0 Generated: 2026-01-04 Project Type: Brownfield Monorepo

Welcome

NexisChat is a multi-tenant WhatsApp management platform that enables users to manage multiple WhatsApp accounts, organize conversations, and automate workflows.

Quick Links

Document	Description
Development Guide	Setup, scripts, and development workflow
Architecture	System design and data flow
Technology Stack	Complete tech inventory
API Contracts - Server	tRPC API reference
API Contracts - WhatsApp	REST API reference
Database Schema	PostgreSQL tables and relationships
UI Component Library	Shared component catalog
Authentication	Auth flows and security
CI/CD Pipeline	GitHub Actions workflows

Project Structure

NexisChat/
├── apps/
│   ├── client/              # Main chat client (TanStack Start)
│   ├── server/              # API server (Hono + tRPC)
│   ├── whatsapp-web-server/ # WhatsApp integration (Elysia)
│   ├── subscription/        # Subscription portal (Next.js)
│   ├── landing/             # Marketing site (Astro)
│   └── docs/                # Documentation (Fumadocs)
│
├── packages/
│   ├── ui/                  # Shared component library
│   ├── i18n/                # Internationalization
│   ├── eslint-config/       # Shared ESLint configs
│   └── typescript-config/   # Shared TypeScript configs
│
└── docs/                    # This documentation

Getting Started

Prerequisites

• Node.js ≥18
• pnpm 10.16.1+
• Bun 1.2+ (for whatsapp-web-server)
• Docker (for local PostgreSQL)

Quick Start

# Clone and install
git clone https://github.com/your-org/NexisChat.git
cd NexisChat
pnpm install

# Setup environment
cp apps/server/.env.example apps/server/.env
# Edit .env with your credentials

# Start database
cd apps/server && docker compose -f development.docker-compose.yml up -d
pnpm db:push

# Start all services
pnpm dev

Development URLs

Service	URL	Port
Client	http://localhost:3000	3000
Server	http://localhost:8787	8787
WhatsApp Server	http://localhost:8788	8788
Subscription	http://localhost:3001	3001
Landing	http://localhost:4321	4321
Docs	http://localhost:3002	3002
Storybook	http://localhost:6006	6006
Drizzle Studio	http://localhost:4983	4983

Key Technologies

Category	Technology
Monorepo	pnpm workspaces + Turborepo
Frontend	TanStack Start, Next.js, Astro
Backend	Hono, Elysia, tRPC 11
Database	PostgreSQL + Drizzle ORM
Auth	WorkOS AuthKit + Better Auth
UI	Radix UI + TailwindCSS 4
Testing	Vitest + Storybook + Chromatic

Documentation Map

For New Developers

1. Start with Development Guide
2. Review Architecture
3. Explore Technology Stack

For API Consumers

1. API Contracts - Server for tRPC endpoints
2. API Contracts - WhatsApp for REST endpoints
3. Authentication for auth flows

For UI Development

1. UI Component Library for component catalog
2. Run pnpm --filter ui storybook for interactive docs

For DevOps

1. CI/CD Pipeline for workflow details
2. Development Guide for environment setup

Contributing

See Development Guide for:

• Branch naming conventions
• Commit message format
• PR process
• Code review guidelines

Support

• Issues: GitHub Issues
• Docs Site: /docs route or apps/docs
• Storybook: pnpm --filter ui storybook

---

This documentation was generated using the BMAD document-project workflow.