Enhanced app.py with port management:
- Added check_port_available() to detect if ports are in use
- Added kill_process_on_port() to automatically free ports
- Checks ports 3001 (backend) and 5173 (frontend) before starting
- Automatically kills existing processes on those ports
- Cross-platform support (Windows netstat/taskkill, Linux lsof/kill)
This fixes the 'EADDRINUSE' error when ports are already occupied.
Benefits:
✅ No manual port cleanup needed
✅ Graceful handling of port conflicts
✅ User-friendly warning messages
✅ Automatic retry after port cleanup
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed npm detection on Windows by using npm.cmd instead of npm.
This resolves the 'npm is not installed or not in PATH' error on Windows systems.
Changes:
- Updated check_npm_installed() to use npm.cmd on Windows
- Uses self.is_windows flag to determine correct command
- Maintains cross-platform compatibility
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive application launcher:
- app.py - Python script to start both backend and frontend
- start.bat - Windows batch file wrapper
- START_HERE.md - Quick start guide with troubleshooting
- Updated package.json with 'npm start' command
Features:
✅ Pre-flight checks (Node.js, npm, dependencies, .env)
✅ Starts both backend (port 3001) and frontend (port 5173)
✅ Colored terminal output with status messages
✅ Process monitoring and health checks
✅ Graceful shutdown with Ctrl+C
✅ Cross-platform support (Windows/Linux/Mac)
✅ Automatic cleanup of child processes
Usage:
python app.py
OR
npm start
OR (Windows only)
start.bat
Benefits:
- Single command to start entire application
- No need for multiple terminal windows
- Automatic error detection and reporting
- User-friendly colored output
- Test account information displayed on startup
- Easy for non-technical users
Documentation:
- START_HERE.md provides complete quick start guide
- Includes troubleshooting section
- Lists all access points and test accounts
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
