demo secrets and new build scripts

include/secrets.h

@@ -0,0 +1,11 @@
+#pragma once
+
+// Copy this file to secrets.h and fill in your real values.
+// secrets.h is git-ignored and must never be committed.
+
+#define WIFI_SSID "YOUR_WIFI_SSID"
+#define WIFI_PASSWORD "YOUR_WIFI_PASSWORD"
+
+#define WEATHER_API_URL "http://<host>:<port>/api/weather"
+#define CALENDAR_API_URL "http://<host>:<port>/api/events"
+#define DEPARTURES_API_URL "http://<host>:<port>/api/departures"

scripts/build.cmd

@@ -0,0 +1,27 @@
+@echo off
+REM Local build-only test script for Windows.
+REM Compiles the project WITHOUT uploading to any device.
+REM Usage: scripts\build.cmd
+
+setlocal
+cd /d "%~dp0\.."
+
+set VENV_DIR=.venv-platformio
+
+if not exist "%VENV_DIR%" (
+    echo Creating local virtualenv in %VENV_DIR% ...
+    python -m venv "%VENV_DIR%"
+    "%VENV_DIR%\Scripts\pip.exe" install --upgrade pip
+    "%VENV_DIR%\Scripts\pip.exe" install platformio
+)
+
+echo Running build (no upload) ...
+"%VENV_DIR%\Scripts\pio.exe" run
+
+if errorlevel 1 (
+    echo Build FAILED.
+    exit /b 1
+)
+
+echo Build finished successfully.
+endlocal

scripts/build.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Local build-only test script for Linux/macOS.
+# Compiles the project WITHOUT uploading to any device.
+# Useful to quickly check "does it even compile" without touching the M5Stack.
+#
+# Usage:
+#   ./scripts/build.sh
+
+cd "$(dirname "$0")/.."
+
+VENV_DIR=".venv-platformio"
+
+if [ ! -d "$VENV_DIR" ]; then
+    echo "Creating local virtualenv in $VENV_DIR ..."
+    python3 -m venv "$VENV_DIR"
+    "$VENV_DIR/bin/pip" install --upgrade pip
+    "$VENV_DIR/bin/pip" install platformio
+fi
+
+echo "Running build (no upload) ..."
+"$VENV_DIR/bin/pio" run
+
+echo "Build finished successfully."

scripts/deploy.cmd

@@ -0,0 +1,38 @@
+@echo off
+REM Build + flash the M5Stack Dashboard project via PlatformIO on Windows.
+REM
+REM Usage:
+REM   scripts\deploy.cmd            (auto-detect USB port)
+REM   scripts\deploy.cmd COM5       (force a specific port)
+REM
+REM Does NOT open the serial monitor afterwards.
+
+setlocal
+cd /d "%~dp0\.."
+
+set VENV_DIR=.venv-platformio
+
+if not exist "%VENV_DIR%" (
+    echo Creating local virtualenv in %VENV_DIR% ...
+    python -m venv "%VENV_DIR%"
+    "%VENV_DIR%\Scripts\pip.exe" install --upgrade pip
+    "%VENV_DIR%\Scripts\pip.exe" install platformio
+)
+
+set PIO=%VENV_DIR%\Scripts\pio.exe
+
+if "%~1"=="" (
+    echo Auto-detecting upload port...
+    "%PIO%" run --target upload
+) else (
+    echo Using forced upload port: %~1
+    "%PIO%" run --target upload --upload-port %~1
+)
+
+if errorlevel 1 (
+    echo Deploy FAILED.
+    exit /b 1
+)
+
+echo Build + flash complete.
+endlocal

scripts/deploy.sh

@@ -1,29 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Build + flash the M5Stack Dashboard project via PlatformIO.
-#
-# Usage:
-#   ./scripts/deploy.sh                # auto-detect USB port
-#   ./scripts/deploy.sh /dev/ttyUSB0   # force a specific port
-#
-# This script intentionally does NOT open the serial monitor afterwards.
-
-cd "$(dirname "$0")/.."
-
-if ! command -v pio &> /dev/null; then
-    echo "Error: PlatformIO CLI ('pio') not found in PATH."
-    echo "Install it via: pip install -U platformio"
-    exit 1
-fi
-
-if [ "$#" -ge 1 ]; then
-    PORT="$1"
-    echo "Using forced upload port: $PORT"
-    pio run --target upload --upload-port "$PORT"
-else
-    echo "Auto-detecting upload port..."
-    pio run --target upload
-fi
-
-echo "Build + flash complete."