Add Wave to local dev environment

[mhgbrown]

Summary

This PR introduces a fully containerized local development environment for the Wave service, integrated directly into the docker-compose setup. It automates the exposure of the local Wave instance via a Cloudflare Tunnel, allowing for seamless webhook handling and interaction with the Drips app during development.

Key Changes

• Docker Infrastructure:
  • Added wave and postgres-wave services to docker-compose.yml to run the Wave backend and its database locally.
  • Added cloudflared service with a custom Dockerfile and entrypoint to automatically create and manage a public tunnel for the local Wave service.
• Automation & Scripts:
  • Created docker/detect-wave.sh to automatically detect access to the Wave Docker image and configure environment profiles.
  • Added docker/wave-command.sh to handle the startup synchronization between Cloudflare (waiting for the public URL) and the Wave service.
  • Updated docker/start-dev.sh and docker/start-e2e.sh to include Wave detection logic.
• Configuration:
  • Refactored .env.template to include necessary configuration for Wave and Cloudflare (e.g., WAVE_PUBLIC_URL, POSTGRES_WAVE_URL).
  • Implemented logic to dynamically inject the Cloudflare-generated URL into the Wave service configuration, ensuring webhooks and callbacks work correctly without manual intervention.
• Documentation:
  • Added docs/WAVE_SERVICE_SETUP.md providing a comprehensive guide on setting up and troubleshooting the local Wave environment.

Technical Details

• Synchronization: Uses a shared volume and sentinel file mechanism to ensure the Wave service only starts after cloudflared has successfully established a tunnel and generated a public URL.
• Environment Handling: Improved handling of multiline environment variables (like SSH keys) in start scripts.
• Networking: Configured internal Docker networking to allow the App to communicate with the Wave API directly or via the public tunnel as needed.

[railway-app]

🚅 Deployed to the app-pr-1774 environment in Drips App

Service	Status	Web	Updated (UTC)
App	✅ Success (View Logs)	Web	Dec 31, 2025 at 11:17 am