Add debugging and improve Codespaces environment detection

Co-authored-by: rrrutledge <9609562+rrrutledge@users.noreply.github.com>

Author: Copilot

.devcontainer/debug-codespaces.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+
+# Debug script to check Codespaces environment
+echo "=== Codespaces Environment Debug ==="
+echo "CODESPACE_NAME: ${CODESPACE_NAME:-NOT SET}"
+echo "GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN: ${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN:-NOT SET}"
+echo ""
+
+if [ -n "$CODESPACE_NAME" ]; then
+    if [ -n "$GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN" ]; then
+        CONSTRUCTED_URL="https://${CODESPACE_NAME}-1313.${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}"
+    else
+        CONSTRUCTED_URL="https://${CODESPACE_NAME}-1313.app.github.dev"
+    fi
+    echo "Constructed Codespaces URL: $CONSTRUCTED_URL"
+else
+    echo "Not running in Codespaces (CODESPACE_NAME not set)"
+fi
+
+echo ""
+echo "=== Hugo Binary Location ==="
+which hugo
+ls -la $(which hugo) 2>/dev/null || echo "Hugo not found"
+
+echo ""
+echo "=== Hugo Version ==="
+hugo version 2>/dev/null || echo "Hugo command failed"
+
+if [ -f "/usr/local/bin/hugo-real" ]; then
+    echo ""
+    echo "=== Hugo-real found ==="
+    ls -la /usr/local/bin/hugo-real
+    /usr/local/bin/hugo-real version
+fi

.devcontainer/devcontainer.json

@@ -32,5 +32,5 @@
     }
   },
   "remoteUser": "vscode",
-  "postCreateCommand": "npm install; cd /tmp && wget -O hugo.deb https://github.com/gohugoio/hugo/releases/download/v0.133.1/hugo_extended_0.133.1_linux-amd64.deb && sudo dpkg -i hugo.deb && rm hugo.deb && npm init -y && npm install hugo-bin@latest && sudo mv /usr/local/bin/hugo /usr/local/bin/hugo-real && sudo cp ${containerWorkspaceFolder}/.devcontainer/hugo-wrapper.sh /usr/local/bin/hugo && sudo chmod +x /usr/local/bin/hugo && hugo version && echo 'Hugo server ready! You can now run: hugo server'"
+  "postCreateCommand": "npm install && cd /tmp && wget -O hugo.deb https://github.com/gohugoio/hugo/releases/download/v0.133.1/hugo_extended_0.133.1_linux-amd64.deb && sudo dpkg -i hugo.deb && rm hugo.deb && npm init -y && npm install hugo-bin@latest && sudo mv /usr/local/bin/hugo /usr/local/bin/hugo-real && sudo cp /workspaces/innersourcecommons.org/.devcontainer/hugo-wrapper.sh /usr/local/bin/hugo && sudo chmod +x /usr/local/bin/hugo && hugo version && echo 'Hugo server ready! You can now run: hugo server'"
 }

.vscode/start-hugo.sh

@@ -5,9 +5,17 @@
 
 if [ -n "$CODESPACE_NAME" ]; then
     # Running in GitHub Codespaces
-    BASE_URL="https://${CODESPACE_NAME}-1313.${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}"
+    # Construct the Codespaces URL using the CODESPACE_NAME and port forwarding domain
+    if [ -n "$GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN" ]; then
+        BASE_URL="https://${CODESPACE_NAME}-1313.${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}"
+    else
+        # Fallback: construct using the standard pattern
+        BASE_URL="https://${CODESPACE_NAME}-1313.app.github.dev"
+    fi
     echo "🚀 Starting Hugo in Codespaces mode"
     echo "📍 Base URL: $BASE_URL"
+    echo "📍 CODESPACE_NAME: $CODESPACE_NAME"
+    echo "📍 GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN: ${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN:-not set, using default}"
 else
     # Running locally
     BASE_URL="http://localhost:1313"
@@ -16,7 +24,19 @@ else
 fi
 
 # Start Hugo server with the appropriate configuration
-exec hugo server \
+# Use the actual hugo binary path to ensure we're not calling a wrapper
+HUGO_CMD="hugo"
+
+# Check if hugo-real exists (wrapper might be installed)
+if [ -x "/usr/local/bin/hugo-real" ]; then
+    HUGO_CMD="/usr/local/bin/hugo-real"
+    echo "📍 Using hugo-real binary"
+elif command -v hugo &> /dev/null; then
+    HUGO_CMD="hugo"
+    echo "📍 Using standard hugo binary"
+fi
+
+exec $HUGO_CMD server \
     --bind=0.0.0.0 \
     --baseURL="$BASE_URL" \
     --appendPort=false \

CODESPACES.md

@@ -88,6 +88,11 @@ When the Hugo server starts:
 
 If you encounter any issues:
 
+- **CSS not loading (assets loading from localhost:1313)**: This means the Codespace environment wasn't detected properly. Try these steps:
+  1. Stop the Hugo server (Ctrl+C in the terminal or stop debugging)
+  2. Run `.devcontainer/debug-codespaces.sh` in the terminal to check your environment
+  3. Make sure you see the "Running in Codespaces mode" message when starting Hugo
+  4. If the environment variables are not set, try rebuilding the container (see below)
 - **Hugo server not starting**: Try restarting the Codespace by clicking on the menu in the bottom left corner and selecting "Codespaces: Stop Current Codespace" and then restarting it.
 - **Changes not showing**: Make sure you've saved your files and that the Hugo server is running.
 - **Port not forwarding**: Click the "Ports" tab at the bottom of the Codespace and make sure port 1313 is forwarded.