Laravel Tunnelhunt Laravel Package

Product Decisions This Supports

• Developer Experience (DX) Enhancement: Accelerates local-to-public testing workflows for webhooks/API integrations, reducing friction in debugging and stakeholder demos.
• Cost-Effective Prototyping: Enables teams to bypass paid tunneling services (e.g., ngrok) for ad-hoc use cases, aligning with lean development budgets.
• Security/Compliance Workarounds: Facilitates testing of external integrations (e.g., payment gateways, Telegram bots) without exposing internal networks or requiring production deployments.
• Roadmap for "Test Locally, Share Globally": Supports a broader initiative to standardize local development environments with public-facing endpoints for QA and client reviews.
• Build vs. Buy: Avoids reinventing tunneling infrastructure; leverages existing open-source tooling with minimal maintenance overhead.

When to Consider This Package

• Adopt When:

  • Your team frequently tests webhooks/APIs locally but lacks a reliable tunneling solution.
  • You need a free, no-signup-required alternative to ngrok/localtunnel for sporadic use.
  • Laravel 10+ projects require SSH access (common in dev environments).
  • Stakeholders demand live demos without deploying to staging/production.

• Look Elsewhere If:

  • You need persistent tunnels (this is ephemeral; tunnels die when the SSH session ends).
  • Your team requires authentication/rate limits (free nokey plan has restrictions).
  • You’re on PHP < 8.1 or Laravel < 10 (compatibility blocker).
  • Security policies prohibit SSH-based tunneling (e.g., corporate environments).
  • You need advanced features (e.g., custom domains, HTTPS, or long-lived tunnels).

How to Pitch It (Stakeholders)

For Executives: "This package lets our devs instantly expose local Laravel apps to the internet—like a ‘shareable’ version of php artisan serve—using a free, no-setup tunnel service. It’s perfect for testing payments, webhooks, or client demos without deploying to staging. Think of it as ‘ngrok-lite’ built into our workflow, saving time and reducing reliance on third-party tools."

For Engineering: *"A lightweight Artisan command that:

1. Spins up php artisan serve in the background.
2. Creates a public URL via tunnelhunt.ru (free tier available).
3. Handles cleanup on Ctrl+C. Use case: Test Stripe webhooks or show a client a WIP feature—no Docker, no cloud costs. Downside: tunnels are temporary and SSH-dependent. Ideal for dev/QA, not production."*

For Developers: "Run php artisan serve:tunnel to get a public URL for your local app in seconds. Supports custom ports/plans (--port 3000 --plan pro). Outputs the live URL directly to your terminal. No config needed—just SSH and Laravel 10+."