Scenarios
Sharing Work in Progress
Section titled “Sharing Work in Progress”Show a live preview to a colleague, designer, or stakeholder without deploying to a staging environment. They get a real URL they can open in any browser — no VPN, no access to your machine.
broch share demo --target http://localhost:5173Getting Sign-Off
Section titled “Getting Sign-Off”Share the tunnel URL in a meeting or over Slack. The tunnel reflects your current local state in real time — changes you make are immediately visible at the tunnel URL. No deploy cycle, no staging lag.
QA Testing a Local Build
Section titled “QA Testing a Local Build”Let a QA engineer test a feature branch on their own device before it is merged or deployed. No staging environment needed — they access your machine directly through the tunnel.
broch share feature-branch --target http://localhost:3000Mobile and Cross-Device Testing
Section titled “Mobile and Cross-Device Testing”Test your web app on a real phone or tablet without deploying. Point the device’s browser at the tunnel URL — it connects to your local dev server over HTTPS, which satisfies browser security requirements that http://localhost does not.
broch share mobile-test --target http://localhost:3000Webhook Development
Section titled “Webhook Development”Receive webhooks from third-party services (Stripe, GitHub, Twilio, etc.) directly on your local machine. Use the tunnel URL as the webhook endpoint in the service’s dashboard.
broch share webhooks --target http://localhost:3000Multi-Service Development
Section titled “Multi-Service Development”Expose a frontend and backend simultaneously, each on its own tunnel URL. Useful when the frontend makes API calls that must go over HTTPS.
broch share frontend --target http://localhost:5173broch share api --target http://localhost:8080