Development Environment (jazclaude)
MaxTracks Web runs on the jazclaude LXC container for development and testing, connecting to the live Firebase backend.
Prerequisites
| Tool | Version | Location |
|---|---|---|
| Node.js | 22+ | Pre-installed |
| Flutter SDK | 3.41+ (stable) | /home/dev/flutter/bin |
| Firebase CLI | 15+ | Global npm package |
Flutter and FIREBASE_TOKEN are both set in ~/.bashrc.
Running Locally
cd /home/dev/code/maxshipping-web-and-cloudfunctions/maxshipping-main-sub/maxshipping-pages
flutter run -d web-server --web-port=8080 --web-hostname=0.0.0.0
Access via SSH tunnel from laptop:
ssh jazclaude -N -L 8081:localhost:8080
Then open http://localhost:8081
Build & Deploy
flutter build web
cd /home/dev/code/maxshipping-web-and-cloudfunctions
firebase deploy --only hosting
Production: https://max-inventory-scanner-b0b53.web.app