docker-compose.dev.yml

# Dev override that swaps the baked-in web.war for a live bind mount of
# transitclockWebapp/src/main/webapp. JSP / CSS / JS / image edits in the
# source tree appear in the running container with a browser refresh —
# no docker rebuild, no compose restart.
#
# Usage:
#   # one-time: populate target/web/WEB-INF/{lib,classes} for the JSPs and
#   # target/frontend-dist/ for the Vite-built Tailwind bundle.
#   mvn -pl transitclockWebapp -am package -DskipTests
#
#   # for fast Tailwind / frontend iteration, run Vite in watch mode in a
#   # second terminal — output goes to target/frontend-dist/, which the
#   # bind mount below picks up:
#   cd transitclockWebapp && npm run dev
#
#   # bring up tomcat with the override
#   docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d tomcat
#
#   # edit transitclockWebapp/src/main/webapp/welcome/index.jsp, refresh page.
#
# Java class changes (anything under transitclockWebapp/src/main/java,
# transitclockApi, or core) still require a rebuild + restart:
#   mvn -pl transitclockWebapp -am package -DskipTests \
#     && docker compose -f docker-compose.yml -f docker-compose.dev.yml \
#         restart tomcat
#
# To return to the production-style baked-WAR flow, drop the
# `-f docker-compose.dev.yml` flag.

services:
  tomcat:
    volumes:
      - ./transitclockWebapp/src/main/webapp:/usr/local/tomcat/webapps/web
      - ./transitclockWebapp/target/web/WEB-INF/lib:/usr/local/tomcat/webapps/web/WEB-INF/lib:ro
      - ./transitclockWebapp/target/web/WEB-INF/classes:/usr/local/tomcat/webapps/web/WEB-INF/classes:ro
      - ./transitclockWebapp/target/frontend-dist:/usr/local/tomcat/webapps/web/dist:ro
    command:
      - |
        if [ -z "${TRANSITCLOCK_APIKEY:-}" ]; then
          echo "ERROR: TRANSITCLOCK_APIKEY is unset. Mint a key with"  >&2
          echo "  docker compose run --rm tools java -jar /workspace/transitclock/target/CreateAPIKey.jar ..." >&2
          echo "(see docs/setup.md §0 step 7), then add"               >&2
          echo "  TRANSITCLOCK_APIKEY=<the key>"                       >&2
          echo "to .env and re-run 'docker compose up -d tomcat'."     >&2
          exit 64
        fi
        # Keep Tomcat from redeploying the baked WAR on top of our bind
        # mount. The bind-mounted directory is the only source of truth
        # while this override is active.
        rm -f /usr/local/tomcat/webapps/web.war
        exec catalina.sh run