chore(deploy): add Hugging Face Docker configuration and CI/CD pipeline

.github/workflows/deploy.yml

@@ -0,0 +1,20 @@
+name: Deploy to Hugging Face Spaces
+
+on:
+  push:
+    branches: [ main ]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Build and Push to HF
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          HF_SPACE: ${{ secrets.HF_SPACE }}
+        run: |
+          git remote add hf https://root:$HF_TOKEN@huggingface.co/spaces/$HF_SPACE
+          git push --force hf main

Dockerfile

@@ -0,0 +1,51 @@
+# --- 1. ROS 2 HUMBLE BASE ---
+FROM ros:humble-ros-base
+
+# Change to root to install dependencies
+USER root
+
+# --- 2. INSTALL SYSTEM DEPENDENCIES ---
+# Install Node.js, Bun, and other necessary tools
+RUN apt-get update && apt-get install -y \
+    curl \
+    gnupg \
+    python3-pip \
+    unzip \
+    && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y nodejs \
+    && curl -fsSL https://bun.sh/install | bash \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Add Bun to PATH
+ENV PATH="/root/.bun/bin:${PATH}"
+
+# --- 3. WORKSPACE SETUP ---
+WORKDIR /app
+
+# Copy the entire monorepo
+COPY . .
+
+# --- 4. BUILD SHARED PACKAGES ---
+WORKDIR /app/packages/shared-types
+RUN npm install && npm run build
+
+# --- 5. BUILD BACKEND ---
+WORKDIR /app/apps/backend
+RUN npm install
+# Fastify needs to listen on port 7860 for Hugging Face Spaces
+RUN sed -i 's/port: 4000/port: 7860/g' src/index.ts
+
+# --- 6. BUILD ROS 2 WORKSPACE ---
+WORKDIR /app/robotics/ros2_ws
+RUN /bin/bash -c "source /opt/ros/humble/setup.bash && colcon build --packages-select simulation_manager amr_navigation"
+
+# --- 7. FINAL ENTRYPOINT SCRIPT ---
+WORKDIR /app
+COPY hf_entrypoint.sh .
+RUN chmod +x hf_entrypoint.sh
+
+# Hugging Face Spaces Port
+EXPOSE 7860
+
+# Run the entrypoint
+CMD ["./hf_entrypoint.sh"]

apps/frontend/utils/socket.ts

@@ -4,7 +4,7 @@ import { io, Socket } from "socket.io-client";
 
 // Singleton Socket Instance
 // Prevent multiple connections in React Strict Mode or Fast Refresh
-const SOCKET_URL = "http://localhost:4000";
+const SOCKET_URL = process.env.NEXT_PUBLIC_SOCKET_URL || "http://localhost:4000";
 
 export const socket: Socket = io(SOCKET_URL, {
   transports: ["websocket"],

hf_entrypoint.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e
+
+# 1. Source ROS 2 environments
+source /opt/ros/humble/setup.bash
+source /app/robotics/ros2_ws/install/setup.bash
+
+# 2. Start the Mock Robot Simulation in the background
+echo "--- [DEPLOY] Starting Mock Robot Simulation ---"
+ros2 run simulation_manager mock_robot --ros-args -p robot_id:=robot_1 &
+
+# 3. Start the Nav2 Stack (Minimal) in the background
+# We run Nav2 in a lighter mode for the free tier
+echo "--- [DEPLOY] Starting Nav2 Stack ---"
+ros2 launch amr_navigation amr_nav.launch.py use_sim_time:=False &
+
+# 4. Start the Fastify Gateway (Main Process)
+# This process stays in the foreground to keep the container alive
+echo "--- [DEPLOY] Starting Telemetry Gateway on Port 7860 ---"
+cd /app/apps/backend
+npm run dev