@gv-sh/specgen-app 0.5.1 → 0.6.2

package/README.md

@@ -1,263 +1,320 @@
 # SpecGen App - Complete Platform
 
-[![Version](https://img.shields.io/badge/version-0.5.1-blue.svg)](https://github.com/gv-sh/specgen-app)
+[![Version](https://img.shields.io/badge/version-0.6.2-blue.svg)](https://github.com/gv-sh/specgen-app)
 
-A unified deployment package for the SpecGen speculative fiction generator platform. **Now optimized for low-memory servers and unified on port 8080!**
+A unified deployment package for the SpecGen speculative fiction generator platform. **Optimized for port 8080 deployment with low memory usage.**
 
-## 🚀 What's New
+## 🚀 Quick Start
 
-- **Single Port Deployment**: Everything runs on port 8080 with clean URL paths
-- **Low Memory Default**: Optimized for small servers and EC2 instances
-- **Automatic Cleanup**: Smart setup that cleans existing installations
-- **Unified Interface**: All services accessible through one port
+### One-Command Deployment (Recommended)
 
-## Components
+```bash
+# Create project directory
+mkdir specgen && cd specgen
 
-- **Server**: Node.js API with OpenAI integration (Port 8080)
-- **Admin**: React admin interface at `/admin`
-- **User**: React user interface at `/app` (also default at `/`)
+# Deploy everything in one command
+npx @gv-sh/specgen-app deploy
+```
 
-## Quick Start
+**What this does:**
+- Downloads and sets up server, admin, and user components
+- Builds React frontends optimized for production
+- Configures everything for port 8080
+- Starts with PM2 for process management
+- Prompts for OpenAI API key
 
-### Using NPX (Recommended)
+## 🌐 Access URLs
 
-```bash
-# Create and enter your project directory
-mkdir specgen-project
-cd specgen-project
+Once deployed, access your application at:
 
-# Run setup (automatically includes low-memory optimizations and cleanup)
-npx @gv-sh/specgen-app setup
+- **Main Application**: http://your-server:8080/
+- **User Interface**: http://your-server:8080/app  
+- **Admin Panel**: http://your-server:8080/admin
+- **API Documentation**: http://your-server:8080/api-docs
+- **Health Check**: http://your-server:8080/api/health
+- **API Endpoints**: http://your-server:8080/api/*
 
-# Start in development mode (traditional separate ports)
-npx @gv-sh/specgen-app dev
+## 🖥️ Server Requirements
 
-# Or start in production mode (unified port 8080)
-npx @gv-sh/specgen-app production
+### Minimum Requirements
+- **Node.js**: 20.0.0 or higher
+- **RAM**: 1GB minimum (2GB recommended)
+- **Storage**: 2GB free space
+- **OS**: Ubuntu 20.04+ (or similar Linux distribution)
 
-# Or deploy with PM2 (recommended for servers)
-npx @gv-sh/specgen-app deploy
-```
+### Quick Server Setup (Ubuntu)
 
-## 🌐 Access URLs
+```bash
+# Install Node.js 20+
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
 
-### Production Mode (Port 8080 - Unified)
-- **Main Application**: http://localhost:8080/
-- **User Interface**: http://localhost:8080/app
-- **Admin Panel**: http://localhost:8080/admin
-- **API Documentation**: http://localhost:8080/api-docs
-- **Health Check**: http://localhost:8080/api/health
-- **API Endpoints**: http://localhost:8080/api/*
+# Verify installation
+node --version  # Should show v20.x.x or higher
+npm --version
+```
 
-### Development Mode (Separate Ports)
-- **User Interface**: http://localhost:3002
-- **Admin Interface**: http://localhost:3001
-- **API Server**: http://localhost:8080
+## 📋 Deployment Methods
 
-## 🖥️ Server Deployment
+### Method 1: Direct NPX Deployment (Easiest)
 
-### Option 1: Quick AWS/VPS Deployment
+```bash
+# SSH into your server
+ssh -i "your-key.pem" ubuntu@your-server-ip
+
+# Create project and deploy
+mkdir specgen && cd specgen
+npx @gv-sh/specgen-app deploy
+```
 
-Perfect for EC2, DigitalOcean, or any Ubuntu server:
+### Method 2: Development Mode
 
-1. **SSH into your server**:
-   ```bash
-   ssh -i "key.pem" ubuntu@your-server-ip
-   ```
+For local development with separate ports:
 
-2. **Install Node.js 20+** (required):
-   ```bash
-   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
-   sudo apt-get install -y nodejs
-   ```
+```bash
+mkdir specgen-dev && cd specgen-dev
+npx @gv-sh/specgen-app setup
+npx @gv-sh/specgen-app dev
+```
 
-3. **Deploy SpecGen** (one command setup with cleanup):
-   ```bash
-   mkdir specgen && cd specgen
-   npx @gv-sh/specgen-app setup
-   npx @gv-sh/specgen-app deploy
-   ```
+**Development URLs:**
+- User Interface: http://localhost:3002
+- Admin Interface: http://localhost:3001  
+- API Server: http://localhost:8080
 
-4. **Access your application**:
-   - **Main**: http://your-server-ip:8080/
-   - **User App**: http://your-server-ip:8080/app
-   - **Admin Panel**: http://your-server-ip:8080/admin
+### Method 3: Manual Deployment
 
-### Option 2: Manual Setup
+If you prefer more control:
 
 ```bash
-# Clone and setup manually
+# Clone repository
 git clone https://github.com/gv-sh/specgen-app.git
 cd specgen-app
+
+# Setup and deploy
 npm run setup
 npm run deploy
 ```
 
-## 🛠️ Setup Features
-
-The setup script now includes **comprehensive cleanup**:
+## 🔧 Configuration
 
-- ✅ **PM2 Process Cleanup**: Stops and removes existing PM2 processes
-- ✅ **Port Liberation**: Frees up ports 8080, 3000, 3001, 3002
-- ✅ **Nginx Cleanup**: Removes conflicting nginx configurations
-- ✅ **Docker Cleanup**: Removes any existing SpecGen containers
-- ✅ **Service Cleanup**: Removes systemd services
-- ✅ **File Cleanup**: Removes old installations and log files
-- ✅ **Low Memory Optimization**: Optimized for servers with limited RAM
+### OpenAI API Key Setup
 
-## 📋 Available Commands
+During deployment, you'll be prompted for your OpenAI API key. You can also set it manually:
 
-### Core Commands
 ```bash
-# Setup with cleanup (one-time)
-npx @gv-sh/specgen-app setup
+# Create/edit the environment file
+echo "OPENAI_API_KEY=your_openai_api_key_here" > server/.env
+echo "NODE_ENV=production" >> server/.env
+echo "PORT=8080" >> server/.env
 
-# Development mode (separate ports)
-npx @gv-sh/specgen-app dev
+# Restart the service
+npx pm2 restart specgen --update-env
+```
 
-# Production mode (direct run on port 8080)
-npx @gv-sh/specgen-app production
+### Environment Variables
 
-# Production deployment with PM2 (recommended)
-npx @gv-sh/specgen-app deploy
-```
+The deployment creates these configuration files:
+- `server/.env` - Server configuration (port 8080, API key)
+- `admin/.env.development` - Admin development settings  
+- `user/.env.development` - User development settings
+
+## 📊 Process Management
+
+The deployment uses PM2 for process management:
 
-### Management Commands
 ```bash
-# Check deployment status
-npx @gv-sh/specgen-app deploy:status
+# Check status
+npx pm2 status
 
-# Stop all services
-npx @gv-sh/specgen-app deploy:stop
+# View logs  
+npx pm2 logs specgen
+
+# Restart application
+npx pm2 restart specgen
 
-# Restart services
-npx @gv-sh/specgen-app deploy:restart
+# Stop application
+npx pm2 stop specgen
+
+# Monitor resources
+npx pm2 monit
 ```
 
-### Using NPM Scripts (if you cloned the repo)
+## 🔍 Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. Port 8080 Already in Use
 ```bash
-npm run setup      # Setup with cleanup
-npm run dev        # Development mode
-npm run production # Production mode
-npm run deploy     # Deploy with PM2
+# Check what's using the port
+sudo lsof -i :8080
+
+# Kill the process
+sudo lsof -ti:8080 | xargs kill -9
+
+# Redeploy
+npx @gv-sh/specgen-app deploy
 ```
 
-## 🔧 Configuration
+#### 2. Frontend Not Loading (404 Errors)
+```bash
+# Check if builds exist
+ls -la admin/build/
+ls -la user/build/
 
-### OpenAI API Key
-You'll be prompted for your OpenAI API key during setup. If you skip it, add it later to `server/.env`:
+# If missing, manually rebuild
+cd admin && npm install && GENERATE_SOURCEMAP=false PUBLIC_URL=/admin npm run build
+cd ../user && npm install && GENERATE_SOURCEMAP=false REACT_APP_API_URL=/api PUBLIC_URL=/app npm run build
 
-```env
-OPENAI_API_KEY=your_openai_api_key_here
-NODE_ENV=production
-PORT=8080
+# Restart server
+npx pm2 restart specgen
 ```
 
-### Environment Files
-The setup automatically creates optimized environment files:
-- `server/.env` - Server configuration (port 8080)
-- `admin/.env.development` - Admin dev settings
-- `user/.env.development` - User dev settings
+#### 3. OpenAI API Key Issues
+```bash
+# Check current environment
+npx pm2 env 0
 
-## 🐳 Docker Alternative
+# Update API key
+echo "OPENAI_API_KEY=your_new_key_here" > server/.env
+echo "NODE_ENV=production" >> server/.env
+echo "PORT=8080" >> server/.env
 
-If you prefer Docker:
+# Restart with new environment
+npx pm2 restart specgen --update-env
+```
 
+#### 4. Out of Memory Errors
 ```bash
-# Quick Docker setup
-docker run -d \
-  --name specgen \
-  -p 8080:8080 \
-  -e OPENAI_API_KEY=your_key_here \
-  gvsh/specgen-app:latest
+# Add swap space (2GB recommended)
+sudo fallocate -l 2G /swapfile
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
+
+# Verify swap is active
+free -h
 ```
 
-## 📊 Management with PM2
+#### 5. Node.js Version Issues
+```bash
+# Check current version
+node --version
+
+# If less than v20, update:
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
 
-When deployed with `npm run deploy`, you get PM2 process management:
+### Debugging Commands
 
 ```bash
-# Check status
-npx pm2 status
+# Test API health
+curl http://localhost:8080/api/health
 
-# View logs
-npx pm2 logs specgen
+# Test main page response
+curl -I http://localhost:8080/
 
-# Restart
-npx pm2 restart specgen
+# Check server logs
+npx pm2 logs specgen --lines 50
 
-# Stop
-npx pm2 stop specgen
+# Check build status
+ls -la */build/ 2>/dev/null || echo "No builds found"
 
-# Monitor
-npx pm2 monit
+# Check processes listening on port 8080
+sudo netstat -tlnp | grep :8080
 ```
 
-## 🔍 Troubleshooting
+### Manual Build Process
+
+If automatic builds fail, try manual building:
 
-### Common Issues
-
-1. **Port 8080 Already in Use**:
-   ```bash
-   # The setup script handles this automatically, but if needed:
-   sudo lsof -ti:8080 | xargs kill -9
-   ```
-
-2. **Out of Memory on Small Servers**:
-   ```bash
-   # Add swap space (setup script suggests this)
-   sudo fallocate -l 2G /swapfile
-   sudo chmod 600 /swapfile
-   sudo mkswap /swapfile
-   sudo swapon /swapfile
-   ```
-
-3. **Node.js Version Issues**:
-   ```bash
-   # Ensure Node.js 20+ is installed
-   node --version  # Should be v20+
-   ```
-
-4. **SQLite3 Binding Errors**:
-   ```bash
-   # The setup script includes engine-strict=false
-   # If issues persist, run setup again - it includes full cleanup
-   npx @gv-sh/specgen-app setup
-   ```
-
-### Health Check
-Test if your deployment is working:
 ```bash
-curl http://localhost:8080/api/health
-# Should return: {"status":"ok","port":8080}
+# Stop current deployment
+npx pm2 stop specgen
+
+# Manual server setup
+npm pack @gv-sh/specgen-server
+tar -xzf gv-sh-specgen-server-*.tgz
+mv package server
+cd server && npm install && cd ..
+
+# Manual admin build
+npm pack @gv-sh/specgen-admin  
+tar -xzf gv-sh-specgen-admin-*.tgz
+mv package admin
+cd admin && npm install && GENERATE_SOURCEMAP=false PUBLIC_URL=/admin npm run build && cd ..
+
+# Manual user build
+npm pack @gv-sh/specgen-user
+tar -xzf gv-sh-specgen-user-*.tgz  
+mv package user
+cd user && npm install && GENERATE_SOURCEMAP=false REACT_APP_API_URL=/api PUBLIC_URL=/app npm run build && cd ..
+
+# Restart deployment
+npx pm2 start server/index.js --name specgen
 ```
 
-## 🚨 Breaking Changes from Previous Versions
+## 🚨 Known Issues
 
-- **Port Change**: Default port changed from 3000 → 8080
-- **URL Structure**: Admin at `/admin`, User at `/app`
-- **Simplified Scripts**: Single `setup` and `production` commands
-- **Automatic Cleanup**: Setup now cleans existing installations
+### Current Limitations
+- **Memory Usage**: Requires at least 1GB RAM for builds
+- **Build Time**: Initial deployment can take 5-10 minutes
+- **SQLite Dependencies**: May require build tools on some systems
+- **Static File Serving**: Builds must complete successfully for frontend access
+
+### AWS EC2 Specific
+- **Security Groups**: Ensure port 8080 is open in your security group
+- **Instance Type**: t2.micro may struggle with builds (t2.small recommended)
+- **Storage**: Ensure at least 2GB free space for node_modules and builds
 
 ## 📚 API Documentation
 
-Once deployed, access the interactive API documentation at:
+Once deployed, access interactive API documentation at:
 - **Swagger UI**: http://your-server:8080/api-docs
 
-## 🤝 Contributing
+### Key API Endpoints
+- `GET /api/health` - Health check and system status
+- `POST /api/generate` - Generate speculative fiction content
+- `GET /api/categories` - List available story categories
+- `GET /api/parameters` - Get generation parameters
 
-1. Fork the repository
-2. Create your feature branch
-3. Commit your changes
-4. Push to the branch
-5. Create a Pull Request
+## 🔄 Updates and Maintenance
 
-## 📄 License
+### Updating SpecGen
+```bash
+# Stop current deployment
+npx pm2 stop specgen
 
-This project is licensed under the ISC License.
+# Clean up old installation
+rm -rf admin user server node_modules
 
-## 🆘 Support
+# Deploy latest version
+npx @gv-sh/specgen-app deploy
+```
+
+### Backup Important Data
+```bash
+# Backup database and configurations
+tar -czf specgen-backup-$(date +%Y%m%d).tar.gz server/data server/.env logs/
+```
+
+## 🤝 Support
 
+### Getting Help
+- **Health Check**: Visit http://your-server:8080/api/health
+- **Logs**: Run `npx pm2 logs specgen`
 - **Issues**: [GitHub Issues](https://github.com/gv-sh/specgen-app/issues)
-- **Documentation**: Check `/api-docs` when running
-- **Health Check**: Visit `/api/health` to verify installation
+- **Status**: Run `npx pm2 status` to check process status
+
+### Reporting Bugs
+When reporting issues, please include:
+- Output of `npx pm2 logs specgen`
+- Output of `curl http://localhost:8080/api/health`
+- Your server specifications (RAM, OS version, Node.js version)
+- Any error messages from the deployment process
+
+## 📄 License
+
+This project is licensed under the ISC License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gv-sh/specgen-app",
-  "version": "0.5.1",
+  "version": "0.6.2",
   "description": "Complete SpecGen application with server, admin, and user interfaces",
   "main": "index.js",
   "bin": {
@@ -12,8 +12,8 @@
     "build": "cd admin && npm run build && cd ../user && npm run build",
     "start": "cd server && npm start",
     "production": "chmod +x scripts/production.sh && ./scripts/production.sh",
-    "make-executable": "chmod +x scripts/make-executable.sh && ./scripts/make-executable.sh",
     "deploy": "chmod +x scripts/deploy.sh && ./scripts/deploy.sh",
+    "make-executable": "chmod +x scripts/make-executable.sh && ./scripts/make-executable.sh",
     "deploy:stop": "chmod +x scripts/stop.sh && ./scripts/stop.sh",
     "deploy:restart": "chmod +x scripts/restart.sh && ./scripts/restart.sh",
     "deploy:status": "chmod +x scripts/status.sh && ./scripts/status.sh",

package/scripts/deploy.sh

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-# SpecGen Deploy Script - Simple PM2 Deployment on Port 8080 with Full Cleanup
+# SpecGen Deploy Script - Self-Contained Deployment on Port 8080
 set -e
 
 echo "🚀 Deploying SpecGen to production on port 8080..."
-echo "🧹 Performing full cleanup before deployment..."
+echo "📦 This is a complete deployment - no separate setup needed!"
 
 # Function to check if port is available
 check_port() {
@@ -20,18 +20,17 @@ check_port() {
 # FULL CLEANUP
 # ========================================
 
+echo "🧹 Cleaning up existing installations..."
+
 # Stop and remove all PM2 processes
-echo "Stopping all PM2 processes..."
 npx pm2 stop all 2>/dev/null || true
 npx pm2 delete all 2>/dev/null || true
 npx pm2 kill 2>/dev/null || true
 
 # Remove old PM2 config files
 rm -f ecosystem.config.js 2>/dev/null || true
-rm -f pm2.config.js 2>/dev/null || true
 
 # Kill processes on all relevant ports
-echo "Freeing all ports..."
 for port in 8080 3000 3001 3002; do
     if ! check_port $port; then
         echo "Killing processes on port $port..."
@@ -40,62 +39,158 @@ for port in 8080 3000 3001 3002; do
     fi
 done
 
-# Clean up logs
+# Clean up old files
 rm -rf logs/* 2>/dev/null || true
 
-# Check for nginx conflicts
-if command -v nginx &> /dev/null && systemctl is-active --quiet nginx 2>/dev/null; then
-    if nginx -T 2>/dev/null | grep -q ":8080"; then
-        echo "⚠️ WARNING: Nginx is configured to use port 8080"
-        echo "   You may need to stop nginx or reconfigure it"
-        echo "   Run: sudo systemctl stop nginx"
+# ========================================
+# VERIFY PREREQUISITES
+# ========================================
+
+echo "🔍 Checking prerequisites..."
+
+# Check Node.js version
+NODE_VERSION=$(node --version | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 20 ]; then
+    echo "❌ Node.js 20+ required. Current version: $(node --version)"
+    echo "Install with: curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs"
+    exit 1
+fi
+
+# Check if we have the required directories and files
+echo "📂 Checking project structure..."
+if [ ! -f "package.json" ]; then
+    echo "❌ package.json not found. This script must be run from the SpecGen project directory."
+    echo "💡 Create a directory and run this script from there:"
+    echo "   mkdir specgen && cd specgen"
+    echo "   npx @gv-sh/specgen-app deploy"
+    exit 1
+fi
+
+# ========================================
+# SETUP OPENAI API KEY
+# ========================================
+
+echo "🔑 Setting up OpenAI API key..."
+
+# Check if .env exists and has API key
+if [ ! -f "server/.env" ] || grep -q "your_openai_api_key_here" server/.env 2>/dev/null; then
+    if [ "$CI" = "true" ]; then
+        echo "CI mode - using test API key"
+        mkdir -p server
+        echo "OPENAI_API_KEY=sk-test1234" > server/.env
+        echo "NODE_ENV=production" >> server/.env
+        echo "PORT=8080" >> server/.env
+    else
+        echo "⚠️ OpenAI API key required for SpecGen to work."
+        echo "Enter your OpenAI API key: "
+        read -r OPENAI_KEY
+        
+        if [ -z "$OPENAI_KEY" ]; then
+            echo "❌ No API key provided. SpecGen needs an OpenAI API key to function."
+            exit 1
+        fi
+        
+        mkdir -p server
+        echo "OPENAI_API_KEY=$OPENAI_KEY" > server/.env
+        echo "NODE_ENV=production" >> server/.env
+        echo "PORT=8080" >> server/.env
+        echo "✅ API key saved"
     fi
 fi
 
 # ========================================
-# RUN PRODUCTION SETUP
+# BUILD APPLICATION
 # ========================================
 
-echo "Running production setup..."
-npm run production &
-SETUP_PID=$!
-
-# Wait for setup to complete or timeout
-TIMEOUT=90
-COUNT=0
-while [ $COUNT -lt $TIMEOUT ]; do
-    if ! kill -0 $SETUP_PID 2>/dev/null; then
-        echo "Production setup completed"
-        break
+echo "🏗️ Building application components..."
+
+# Install and build server
+if [ ! -d "server" ] || [ ! -d "server/node_modules" ]; then
+    echo "📦 Setting up server..."
+    npm pack @gv-sh/specgen-server
+    tar -xzf gv-sh-specgen-server-*.tgz
+    mv package server
+    rm gv-sh-specgen-server-*.tgz
+    
+    cd server
+    echo "engine-strict=false" > .npmrc
+    npm install --no-fund --no-audit --production --maxsockets=2 --loglevel=warn
+    cd ..
+fi
+
+# Install and build admin
+if [ ! -d "admin/build" ]; then
+    echo "📱 Building admin interface..."
+    if [ ! -d "admin" ]; then
+        npm pack @gv-sh/specgen-admin
+        tar -xzf gv-sh-specgen-admin-*.tgz
+        mv package admin
+        rm gv-sh-specgen-admin-*.tgz
     fi
-    sleep 1
-    COUNT=$((COUNT + 1))
     
-    # Show progress every 15 seconds
-    if [ $((COUNT % 15)) -eq 0 ]; then
-        echo "Setup still running... ($COUNT/$TIMEOUT seconds)"
+    cd admin
+    echo "engine-strict=false" > .npmrc
+    # Install ALL dependencies for build process
+    npm install --no-fund --no-audit --maxsockets=2 --loglevel=warn
+    # Build with proper environment variables (no cross-env needed on Linux)
+    GENERATE_SOURCEMAP=false SKIP_PREFLIGHT_CHECK=true PUBLIC_URL=/admin npm run build
+    cd ..
+fi
+
+# Install and build user
+if [ ! -d "user/build" ]; then
+    echo "👤 Building user interface..."
+    if [ ! -d "user" ]; then
+        npm pack @gv-sh/specgen-user
+        tar -xzf gv-sh-specgen-user-*.tgz
+        mv package user
+        rm gv-sh-specgen-user-*.tgz
     fi
-done
+    
+    cd user
+    echo "engine-strict=false" > .npmrc
+    # Install ALL dependencies for build process
+    npm install --no-fund --no-audit --maxsockets=2 --loglevel=warn
+    # Build with proper environment variables (no cross-env needed on Linux)
+    GENERATE_SOURCEMAP=false SKIP_PREFLIGHT_CHECK=true REACT_APP_API_URL=/api PUBLIC_URL=/app npm run build
+    cd ..
+fi
 
-# Kill setup process if it's still running
-if kill -0 $SETUP_PID 2>/dev/null; then
-    echo "Setup taking too long, terminating and continuing with PM2 deployment..."
-    kill $SETUP_PID 2>/dev/null || true
-    # Force kill any remaining processes
-    for port in 8080 3000; do
-        lsof -ti:$port | xargs kill -9 2>/dev/null || true
-    done
+# ========================================
+# VERIFY BUILDS
+# ========================================
+
+echo "✅ Verifying builds..."
+if [ ! -d "admin/build" ]; then
+    echo "❌ Admin build failed"
+    ls -la admin/ || echo "Admin directory not found"
+    exit 1
 fi
 
-# Wait a moment for cleanup
-sleep 3
+if [ ! -d "user/build" ]; then
+    echo "❌ User build failed"
+    ls -la user/ || echo "User directory not found"
+    exit 1
+fi
+
+echo "📁 Build verification:"
+echo "   Admin build: $(ls -la admin/build/ | wc -l) files"
+echo "   User build: $(ls -la user/build/ | wc -l) files"
+echo "   Server: $(ls -la server/ | wc -l) files"
+
+# Show some sample files to verify builds
+echo "📄 Admin build files:"
+ls admin/build/ | head -5
+echo "📄 User build files:"
+ls user/build/ | head -5
 
 # ========================================
 # PM2 DEPLOYMENT
 # ========================================
 
+echo "🚀 Starting PM2 deployment..."
+
 # Create PM2 ecosystem configuration
-echo "Creating PM2 ecosystem configuration..."
 cat > ecosystem.config.js << 'EOF'
 module.exports = {
   apps: [{
@@ -116,7 +211,7 @@ module.exports = {
     watch: false,
     ignore_watch: ['node_modules', 'logs', '*.log'],
     restart_delay: 1000,
-    max_restarts: 3,
+    max_restarts: 10,
     min_uptime: '10s'
   }]
 }
@@ -125,29 +220,68 @@ EOF
 # Create logs directory
 mkdir -p logs
 
+# Copy .env to ensure PM2 picks it up
+cp server/.env .env 2>/dev/null || true
+
 # Final port check
-echo "Final port check..."
 if ! check_port 8080; then
-    echo "Port 8080 still occupied, force cleaning..."
+    echo "Port 8080 occupied, force cleaning..."
     lsof -ti:8080 | xargs kill -9 2>/dev/null || true
     sleep 2
 fi
 
 # Start with PM2
-echo "Starting SpecGen with PM2 on port 8080..."
+echo "▶️ Starting SpecGen with PM2..."
 NODE_ENV=production PORT=8080 npx pm2 start ecosystem.config.js
 
 # Wait for startup and verify
 sleep 5
 
-# Check if the process is actually running
+# ========================================
+# DEPLOYMENT VERIFICATION
+# ========================================
+
+echo "🔍 Verifying deployment..."
+
 if npx pm2 list | grep -q "online"; then
-    echo ""
-    echo "✅ SpecGen deployment completed successfully!"
+    # Test endpoints
+    echo "Testing endpoints:"
+    
+    # Test health endpoint
+    if curl -s http://localhost:8080/api/health >/dev/null 2>&1; then
+        echo "✅ Health endpoint: OK"
+    else
+        echo "❌ Health endpoint: FAILED"
+    fi
+    
+    # Test main page
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/ 2>/dev/null)
+    if [ "$HTTP_CODE" = "200" ]; then
+        echo "✅ Main page: OK (HTTP $HTTP_CODE)"
+    else
+        echo "⚠️ Main page: HTTP $HTTP_CODE (check if builds are served correctly)"
+    fi
+    
+    # Test admin
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/admin 2>/dev/null)
+    if [ "$HTTP_CODE" = "200" ]; then
+        echo "✅ Admin page: OK (HTTP $HTTP_CODE)"
+    else
+        echo "⚠️ Admin page: HTTP $HTTP_CODE"
+    fi
+    
+    # Test user app
+    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/app 2>/dev/null)
+    if [ "$HTTP_CODE" = "200" ]; then
+        echo "✅ User app: OK (HTTP $HTTP_CODE)"
+    else
+        echo "⚠️ User app: HTTP $HTTP_CODE"
+    fi
     
-    # Get public IP
     PUBLIC_IP=$(curl -s ifconfig.me 2>/dev/null || curl -s ipecho.net/plain 2>/dev/null || echo 'your-server')
     
+    echo ""
+    echo "🎉 SpecGen deployment completed!"
     echo ""
     echo "🌐 Access your application at:"
     echo "   - Main page: http://$PUBLIC_IP:8080/"
@@ -156,25 +290,24 @@ if npx pm2 list | grep -q "online"; then
     echo "   - API docs: http://$PUBLIC_IP:8080/api-docs"
     echo "   - Health check: http://$PUBLIC_IP:8080/api/health"
     echo ""
-    echo "📊 Management commands:"
-    echo "   - Check status: npx pm2 status"
-    echo "   - View logs: npx pm2 logs specgen"
-    echo "   - Restart: npx pm2 restart specgen"
-    echo "   - Stop: npx pm2 stop specgen"
+    echo "📊 Management:"
+    echo "   npx pm2 status           # Check status"
+    echo "   npx pm2 logs specgen     # View logs"
+    echo "   npx pm2 restart specgen  # Restart"
+    echo ""
+    echo "🔧 Troubleshooting:"
+    echo "   curl http://localhost:8080/api/health     # Test API"
+    echo "   curl -I http://localhost:8080/            # Test main page"
+    echo "   ls -la */build/                           # Check builds"
     echo ""
-    
-    # Test the health endpoint
-    echo "🔍 Testing health endpoint..."
-    if curl -s http://localhost:8080/api/health >/dev/null 2>&1; then
-        echo "✅ Health check passed!"
-    else
-        echo "⚠️ Health check failed - check logs with: npx pm2 logs specgen"
-    fi
     
 else
     echo ""
     echo "❌ Deployment failed!"
-    echo "📝 Check logs with: npx pm2 logs specgen"
-    echo "📊 Check status with: npx pm2 status"
+    echo "📝 Check logs: npx pm2 logs specgen"
+    echo "📊 Check status: npx pm2 status"
+    echo ""
+    echo "Recent logs:"
+    npx pm2 logs specgen --lines 10
     exit 1
 fi