feat: Add Netlify deployment guide and environment variables, update build scripts

Author: techagbadev-create

NETLIFY_DEPLOY_GUIDE.md

@@ -0,0 +1,105 @@
+# Netlify Deployment Guide for AegisExpress Logistics
+
+## Quick Deploy Options
+
+### Option 1: Deploy from GitHub (Recommended)
+
+1. **Connect Repository to Netlify:**
+   - Go to [Netlify](https://app.netlify.com/)
+   - Click "New site from Git"
+   - Choose GitHub and authorize Netlify
+   - Select your repository: `RabbitDaCoder/ExpressLogistics`
+
+2. **Build Settings:**
+   ```
+   Base directory: client
+   Build command: npm run build
+   Publish directory: client/dist
+   ```
+
+3. **Environment Variables:**
+   Copy from `NETLIFY_ENV_VARS.txt` and add in Netlify dashboard:
+   - Site settings → Environment variables
+   - Add each variable from the file
+
+### Option 2: Deploy via Netlify CLI
+
+1. **Install Netlify CLI:**
+   ```bash
+   npm install -g netlify-cli
+   ```
+
+2. **Login to Netlify:**
+   ```bash
+   netlify login
+   ```
+
+3. **Deploy from client directory:**
+   ```bash
+   cd client
+   netlify deploy --prod --dir=dist
+   ```
+
+### Option 3: Drag & Drop Deploy
+
+1. **Build locally:**
+   ```bash
+   cd client
+   npm install --legacy-peer-deps
+   npm run build
+   ```
+
+2. **Drag the `dist` folder to Netlify dashboard**
+
+## Configuration Files Created
+
+- `client/netlify.toml` - Netlify build configuration
+- `NETLIFY_ENV_VARS.txt` - Environment variables list
+
+## Key Features Configured
+
+✅ **SPA Routing** - All routes redirect to index.html  
+✅ **Build Optimization** - CSS/JS minification and bundling  
+✅ **Security Headers** - XSS protection, frame options, etc.  
+✅ **Cache Control** - Optimized caching for static assets  
+✅ **Node.js 18** - Stable Node version for builds  
+✅ **Legacy Peer Deps** - Handles npm dependency conflicts  
+
+## Post-Deployment Steps
+
+1. **Update API URL:**
+   - Set `VITE_API_URL` to your Render API URL
+   - Example: `https://your-api-name.onrender.com/api`
+
+2. **Configure Custom Domain (Optional):**
+   - Site settings → Domain management
+   - Add your custom domain
+
+3. **Set up Branch Deploys:**
+   - Deploys → Deploy contexts
+   - Configure preview deployments
+
+## Build Troubleshooting
+
+If build fails:
+
+1. **Check build logs** in Netlify dashboard
+2. **Clear cache** in Site settings → Build & deploy
+3. **Try manual deploy** with Netlify CLI
+4. **Verify environment variables** are set correctly
+
+## Performance Optimization
+
+- Static assets cached for 1 year
+- HTML/CSS/JS minified automatically
+- Pretty URLs enabled
+- Gzip compression enabled by default
+
+## Security Features
+
+- XSS protection headers
+- Content type sniffing prevention
+- Frame clickjacking protection
+- Strict referrer policy
+
+Your site will be available at: `https://your-site-name.netlify.app`

NETLIFY_ENV_VARS.txt

@@ -0,0 +1,34 @@
+# Netlify Environment Variables for AegisExpress Logistics
+
+# API Configuration
+VITE_API_URL=https://your-api-domain.onrender.com/api
+
+# Map Services
+VITE_MAPBOX_ACCESS_TOKEN=your_mapbox_token
+VITE_GOOGLE_MAPS_API_KEY=your_google_maps_key
+
+# Cloudinary (for image uploads)
+VITE_CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
+VITE_CLOUDINARY_API_KEY=your_cloudinary_api_key
+
+# Application Settings
+VITE_APP_NAME=AegisExpress Logistics
+VITE_APP_VERSION=1.0.0
+VITE_ENVIRONMENT=production
+
+# Feature Flags
+VITE_ENABLE_TRACKING=true
+VITE_ENABLE_NOTIFICATIONS=true
+VITE_ENABLE_ANALYTICS=false
+
+# Security
+VITE_ENABLE_HTTPS=true
+
+# External Services (if needed)
+VITE_TELEGRAM_BOT_TOKEN=your_telegram_bot_token
+VITE_SUPPORT_EMAIL=support@aegisexpress.com
+
+# Build Configuration
+NODE_VERSION=18
+NPM_FLAGS=--legacy-peer-deps
+CI=false

client/netlify.toml

@@ -0,0 +1,57 @@
+[build]
+  # Directory to change to before starting a build
+  base = "client/"
+  
+  # Directory that contains the deploy-ready HTML files and assets
+  publish = "dist/"
+  
+  # Default build command
+  command = "npm run build"
+
+[build.environment]
+  # Node.js version
+  NODE_VERSION = "18"
+  
+  # npm settings
+  NPM_FLAGS = "--legacy-peer-deps"
+
+# Redirect rules for SPA routing
+[[redirects]]
+  from = "/*"
+  to = "/index.html"
+  status = 200
+
+# Custom headers for security and performance
+[[headers]]
+  for = "/*"
+  [headers.values]
+    X-Frame-Options = "DENY"
+    X-XSS-Protection = "1; mode=block"
+    X-Content-Type-Options = "nosniff"
+    Referrer-Policy = "strict-origin-when-cross-origin"
+
+[[headers]]
+  for = "/static/*"
+  [headers.values]
+    Cache-Control = "public, max-age=31536000, immutable"
+
+# Error pages
+[[redirects]]
+  from = "/404"
+  to = "/index.html"
+  status = 200
+
+# Build optimization
+[build.processing]
+  skip_processing = false
+
+[build.processing.css]
+  bundle = true
+  minify = true
+
+[build.processing.js]
+  bundle = true
+  minify = true
+
+[build.processing.html]
+  pretty_urls = true

client/package.json

@@ -8,6 +8,7 @@
     "build": "vite build",
     "build:tsc": "tsc -b && vite build",
     "build:vercel": "vite build --mode production",
+    "build:netlify": "npm ci --legacy-peer-deps && vite build --mode production",
     "lint": "eslint .",
     "preview": "vite preview"
   },