⚡ Thunder-TUI

Blazing Fast HTTP Client | Terminal Based | Keyboard Driven

---

⚡ Quick Insights

---

🛠️ The Arsenal Core Format Platform

🚀 Quick Start go install github.com/meklasdev/thunder-tui@latest thunder-tui run collection.yaml

---

🎯 The Problem

Postman is slow (10+ second startup), bloated (Electron), and cloud-dependent.

When you're SSH'd into a server or working in a minimal environment, you need something fast, lightweight, and terminal-native.

---

✨ The Solution

Thunder-TUI is a blazing-fast HTTP client that runs entirely in your terminal. Built with Go and Bubbletea, it provides:

✅ Instant Startup - No Electron bloat
✅ SSH-Friendly - Works over remote connections
✅ YAML Collections - Version-controlled API tests
✅ Keyboard Driven - Vim-style navigation
✅ Beautiful TUI - Cyberpunk aesthetic with Lipgloss
✅ Zero Dependencies - Single binary, no runtime required

---

🚀 Installation

Via Go Install (Recommended)

go install github.com/meklasdev/thunder-tui/cmd/thunder-tui@latest

From Source

git clone https://github.com/meklasdev/thunder-tui.git
cd thunder-tui
go build -o thunder-tui ./cmd/thunder-tui

Binary Releases

Download pre-built binaries from the Releases page.

---

📖 Usage

1️⃣ Create a Collection

Create a collection.yaml file:

requests:
  - name: "Get GitHub User"
    method: GET
    url: "https://api.github.com/users/meklasdev"
    headers:
      Accept: "application/vnd.github.v3+json"

  - name: "Create Post"
    method: POST
    url: "https://jsonplaceholder.typicode.com/posts"
    headers:
      Content-Type: "application/json"
    body: |
      {
        "title": "Hello World",
        "body": "This is a test",
        "userId": 1
      }

2️⃣ Run Thunder-TUI

thunder-tui run collection.yaml

3️⃣ Navigate & Test

• ↑/↓ or j/k - Navigate requests
• Enter - Send request
• Tab - Switch between panels
• q - Quit

---

🎨 Features

🎯 Split-Panel Interface

┌─────────────────────┬──────────────────────────┐
│ 📋 Requests         │ 📡 Response              │
│                     │                          │
│ ▶ GET    Get Users  │ Status: 200 OK           │
│   POST   Create     │ Duration: 234ms          │
│   DELETE Remove     │                          │
│                     │ Headers:                 │
│                     │   Content-Type: json     │
│                     │                          │
│                     │ Body:                    │
│                     │ { "users": [...] }       │
└─────────────────────┴──────────────────────────┘

🌈 Method Color Coding

• 🔵 GET - Blue
• 🟢 POST - Green
• 🟡 PUT - Yellow
• 🔴 DELETE - Red
• 🟣 PATCH - Purple

⚡ Real-time Response

• Status codes
• Response headers
• JSON body (syntax highlighted)
• Request duration

---

🎮 Keyboard Shortcuts

Key	Action
↑ / k	Navigate up
↓ / j	Navigate down
Enter	Send request
Tab	Switch panels
q / Ctrl+C	Quit

---

📦 Collection Format

Thunder-TUI uses YAML for collections:

requests:
  - name: "Request Name"
    method: GET|POST|PUT|DELETE|PATCH
    url: "https://api.example.com/endpoint"
    headers:
      Header-Name: "Header Value"
    body: |
      Request body (for POST/PUT/PATCH)

Example Collection

See example-collection.yaml for a complete example.

---

🛡️ Why Thunder-TUI?

Feature	Thunder-TUI	Postman	Insomnia	curl
Startup Time	⚡ Instant	🐌 10s+	🐌 5s+	⚡ Instant
Memory Usage	🟢 ~10MB	🔴 ~500MB	🟡 ~200MB	🟢 ~5MB
SSH-Friendly	✅ Yes	❌ No	❌ No	✅ Yes
Collections	✅ YAML	✅ Cloud	✅ JSON	❌ No
TUI	✅ Beautiful	❌ GUI	❌ GUI	❌ CLI
Version Control	✅ Git-friendly	⚠️ Export	⚠️ Export	❌ Scripts

---

🧪 Testing

# Run tests
go test ./...

# Run with coverage
go test -cover ./...

# Build
go build -o thunder-tui ./cmd/thunder-tui

---

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push and open a PR

---

📜 License

MIT © meklasdev

---

🔗 Connect With Me

⭐ Star this repo if you find it useful!

Made with ⚡ Go by meklasdev