🚀 TunnelPilot

A lightweight desktop app to create, manage, and stop Cloudflare tunnels visually — no terminal required.

Built with Wails (Go + Web UI), this tool makes it easy to expose your local apps to the internet using Cloudflare Tunnel.

---

✨ Features

• 🔐 Login to Cloudflare with one click
• 🌐 Create tunnels for any local port
• 🧭 View active public URLs
• 🛑 Stop tunnels instantly
• ⚡ Fast and minimal desktop experience
• 🪟 Native Windows build

---

🖥️ Tech Stack

• Backend: Go
• Framework: Wails
• Frontend: HTML, CSS, JavaScript
• Tunnel Engine: Cloudflared

---

📦 Installation

1️⃣ Prerequisites

Make sure you have installed:

• Go (>= 1.20)
• Wails CLI
• Cloudflared

go install github.com/wailsapp/wails/v2/cmd/wails@latest

---

2️⃣ Clone the repo

git clone https://github.com/hxrshdeepsingh/TunnelPilot
cd TunnelPilot

---

3️⃣ Run in development

wails dev

---

4️⃣ Build production app

wails build

The executable will be inside:

/build/bin

---

🚀 Usage

1. Open the app
2. Click Login (first time only)
3. Enter the port you want to expose
4. Click Create Tunnel
5. Copy the public URL 🎉

---

📁 Project Structure

.
├─ frontend/        # UI code
├─ app.go           # Wails backend logic
├─ wails.json       # Build config
├─ build/           # Platform build files

---

🛠️ Roadmap

• Auto reconnect tunnels
• Custom subdomain support
• Tunnel history
• macOS & Linux builds
• System tray mode

---

🤝 Contributing

Contributions are welcome!

1. Fork the repo
2. Create a feature branch
3. Submit a PR

---

📜 License

MIT License — feel free to use and modify.

---

💡 Motivation

Managing Cloudflare tunnels from the terminal can be repetitive. This app simplifies the workflow into a clean GUI so developers can focus on building, not commands.

---

⭐ Support

If you like this project, consider giving it a star on GitHub — it helps a lot!

---