Deployment Guide

Prepare Source Code

• Clone or download the TrafficPOS repository
• Ensure all dependencies are installed
• Test the build process locally
• Configure environment variables

npm install
npm run build
npm run preview

Set Up Vercel Account

• Create account at vercel.com
• Connect your Git repository (GitHub/GitLab)
• Configure project settings
• Set build commands and output directory

Configure Environment Variables

Set up the following environment variables in Vercel:

VITE_API_BASE_URL=https://your-api-server.com
VITE_USE_MOCK_API=false
VITE_OPENAI_API_KEY=your-openai-key (optional)

Deploy and Test

• Trigger deployment from Git push
• Verify build completes successfully
• Test PWA installation
• Verify offline functionality
• Test on target devices

Configure Custom Domain

• Purchase domain (e.g., pos.yourdispensary.com)
• Add domain in Vercel dashboard
• Update DNS settings
• Verify SSL certificate

Prepare Server Environment

• Install Node.js 18+ on server
• Install web server (nginx or Apache)
• Configure firewall and security
• Set up SSL certificates

Build and Deploy Application

# Build the application
npm install
npm run build

# Copy build files to web server
sudo cp -r dist/* /var/www/html/
sudo chown -R www-data:www-data /var/www/html/

Configure Web Server

Example nginx configuration:

server {
    listen 80;
    listen 443 ssl;
    server_name pos.local;
    
    root /var/www/html;
    index index.html;
    
    # PWA support
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    # Cache static assets
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

Set Up SSL/HTTPS

• Generate SSL certificate (Let's Encrypt or self-signed)
• Configure HTTPS in web server
• Test HTTPS access
• Redirect HTTP to HTTPS

Install on Each Device

• Open the deployed URL in browser
• Look for "Install App" prompt
• Accept installation to add to home screen
• Verify offline functionality works

Configure App Settings

• Set app to Offline Mode (recommended)
• Import product catalog
• Create employee accounts
• Configure business information
• Enable automated backups