OceanOS v1.0.0 — Production Ready Monorepo

We are pleased to announce the production release of OceanOS, a unified maritime intelligence and simulation platform. The codebase has been fully polished, optimized, and is ready for local development and instant deployment to Vercel.

Key Improvements and Additions

1. Vercel and Production-Ready Build Configuration

• Automated Monorepo Compilation: Added a root-level build system (build.js, package.json, vercel.json) that automates dependency installation and compiles all Vite/TypeScript sub-projects (river simulator, ocean clean).
• Clean Routing: Configured base paths for all nested applications (/river-simulator/, /ocean-clean/, etc.) to run cleanly under a single hosting domain.

2. Client-Side Telemetry and Mock API (No-Backend Mode)

• API and WebSocket Interceptor: Implemented shared/mock-api.js to automatically intercept fetch requests and WebSocket feeds when running offline or on Vercel.
• Persistent Emulated Database: Operates using localStorage to save, update, and persist metric counters, alerts, and credit scores across page refreshes.
• Cross-Tab Synchronization: Uses a browser BroadcastChannel (oceanos_telemetry) to enable real-time coordination (e.g. spawns in the 3D Simulation feed directly into the Admin Dashboard in another tab).
• Demo Core Settings UI: Added a sleek widget in the bottom-right of the apps to toggle between Mock mode and custom live API server addresses.

3. Redesigned Minimal Landing Page

• Relocated the documentation template to serve as the root page (index.html) using premium design systems, monospace metadata lists, and custom wave-particle canvas backgrounds.
• Interactive cards let users instantly launch and view all 7 operational modules and review their respective technology stacks.

4. Emoji-Free Sleek UI Polishing

• Replaced all descriptive emoji characters with clean CSS badges, SVG icons, and typography metrics across:
  • Command Center Dashboard
  • FisherGuard Companion Mobile App
  • Unified 3D Simulation
  • Autonomous Drone Flight Simulator
  • Factory Plume Dispersion and Spill Simulator
  • River Net Filtration and Ocean Boom Simulators

5. Dynamic Port Allocation and Conflict Prevention

• Both start-all.ps1 (development launcher) and start-production.ps1 (production preview) have been upgraded to query active ports and dynamically bind services (Backend, Dashboard, Fisherman, Simulation) to the first available free ports to prevent local execution failures.

How to Run Locally

1. Run Production Preview Server

To verify compilation and run the monorepo locally under serve:

.\start-production.ps1