Skip to main content
KAIU Natural Living is a modern e-commerce platform powered by an AI Orchestrator for WhatsApp. This guide covers the deployment options and considerations for production environments.

Architecture

The system uses a robust and scalable stack:
  • Frontend: React + Vite + TailwindCSS (Dashboard & Store)
  • Backend: Node.js + Express
  • Database: PostgreSQL (Supabase) with pgvector extension for RAG
  • ORM: Prisma IO
  • Queues / Background: BullMQ + Redis
  • AI: Anthropic Claude 3 Haiku + LangChain
  • Messaging: WhatsApp Cloud API

Deployment Options

You can deploy KAIU Natural Living using several platforms: Ideal for deploying both frontend and backend with serverless functions.
  • Zero-config deployment
  • Automatic SSL certificates
  • Edge network for fast global access
  • Built-in environment variable management
Learn more about Vercel deployment →

2. Railway

Great for full-stack deployment with managed database and Redis.
  • Managed PostgreSQL and Redis instances
  • Easy environment configuration
  • Automatic deployments from Git
  • Built-in metrics and logging
Learn more about Railway deployment →

3. VPS (Virtual Private Server)

For maximum control and customization:
  • Full server access
  • Custom configurations
  • Self-managed infrastructure
  • Cost-effective for high traffic

Infrastructure Requirements

Database

PostgreSQL 12+ with the pgvector extension is required for the RAG (Retrieval-Augmented Generation) functionality.
Recommended provider: Supabase
  • Includes pgvector extension by default
  • Generous free tier
  • Automatic backups
  • Real-time capabilities

Redis

Recommended provider: Upstash or Railway
  • Required for BullMQ job queues
  • Background task processing
  • Session management

Alternative: Railway for Both

Railway can host both PostgreSQL and Redis in a single platform, simplifying infrastructure management.

Prerequisites

Before deploying, ensure you have:
  • Node.js v20+
  • PostgreSQL database with pgvector enabled
  • Redis instance (local or remote)
  • WhatsApp Cloud API credentials from Meta
  • Anthropic API key for Claude 3 Haiku

Next Steps

Environment Setup

Configure production environment variables

Vercel Deployment

Deploy to Vercel in minutes

Railway Deployment

Full-stack deployment on Railway
Production Considerations
  • Always use production-grade databases (never development/local instances)
  • Enable SSL/TLS for all connections
  • Set up proper monitoring and logging
  • Configure rate limiting for API endpoints
  • Implement proper backup strategies
  • Review and secure all environment variables

Build docs developers (and LLMs) love